Added by Sebastian Gonzalez Oyuela, last edited by Sebastian Gonzalez Oyuela on Jan 12, 2009  (view change)

Labels:

Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.

Introduction

The JOSSO Deployment Console is a new application provided since JOSSO 1.8 that will help you install JOSSO Components (Gateway and Agents). The console has been implemented using Apache Geronimo GShell. GShell is an extensible, command-line processing environment for creating platform independent command-line applications. To start the console, simply unpack JOSSO distribution and run the josso-gsh launcher script located in the bin folder.

Commands


help


Show command help

Options:

  -h (--help)    Display this help message

examples:

josso> help

For information about JOSSO, visit:
    http://www.josso.org 

Available commands:
  cat                   Concatenate and print files and/or URLs
  clear                 Clear the terminal screen
  echo                  Echo or print arguments to STDOUT
  exec                  Execute system processes
  exit                  Exit the (sub)shell
  grep                  Print lines matching a pattern
  help                  Show command help
  history               Displays the history of commands
  info                  Show system informations
  java                  Execute a Java standard application
  set                   Set a variable
  sleep                 Sleep for a bit then wake up
  source                Load a file/url into the current shell
  unset                 Unset a variable

Available shells:
  agent
  gateway
  install
  samples

josso> 

info


Show system informations

Options:

-h (--help)    Display this help message

Examples

josso> info
JOSSO
  JOSSO version               1.8.0

JVM
  Java Virtual Machine        Java HotSpot(TM) 64-Bit Server VM version 1.5.0_12-b04
  Vendor                      Sun Microsystems Inc.
  Uptime                      23 minutes
  Total compile time          3.481 seconds
Threads
  Live threads                7
  Daemon threads              3
  Peak                        7
  Total started               33
Memory
  Current heap size           5,219 kbytes
  Maximum heap size           904,768 kbytes
  Committed heap size         60,928 kbytes
  Pending objects             0
  Garbage collector           Name = 'PS Scavenge', Collections = 3, Time = 0.041 seconds
  Garbage collector           Name = 'PS MarkSweep', Collections = 0, Time = 0.000 seconds
Classes
  Current classes loaded      1,615
  Total classes loaded        1,615
  Total classes unloaded      0
Operating system
  Name                        Linux version 2.6.26.6-49.fc8
  Architecture                amd64
  Processors                  2
josso>

gateway install


Install JOSSO Gateway. The install process performs the following tasks:

  1. Verify that the selected target matches the selected installer / platform.
  2. Generates and installs the 'AES' key used by the automatic authentication ('Remember Me')
  3. Installs default gateway configuration
  4. Deploys the JOSSO gateway war (josso.war)

A log file with install details is created in the josso-1.8.0/log folder.

Options:

  --copy-configuration          Copy configuration files. Should be false for cu
                                stom gateway.
  --persistence VAL             Install default configuration for the specified 
                                persistence mechanism (db, ldap, memory)
  -d (--weblogic-domain) VAL    Weblogic domain path
  -f (--force-install)          Force installation if some target validations fa
                                il
  -h (--help)                   Display this help message
  -i (--jboss-instance) VAL     JBoss instance
  -p (--platform) VAL           see list-platforms for a complete list
  -r (--replace)                Replace installed files, includes configuration!
  -s (--source) VAL             Custom gateway's artifact source location, speci
                                fied as mvn:groupId/artifactId/version/type (e.g
                                . mvn:org.josso/josso-web-gateway/1.8.0/war)
  -t (--target) VAL             Target Install directory

Examples:

josso> gateway install -t /opt/apache-tomcat-6.0.18 -t tc60

josso> gateway install --target /opt/apache-tomcat-6.0.18 --platform tc60 --replace

josso> gateway install --target /opt/bea/weblogic92 --platform wl92 --weblogic-domain samples/domains/wl_server/ --persistence ldap

josso> gateway install --target /opt/jboss-4.2.3.GA --platform jb42 --jboss-instance all --persistence db

josso> gateway install --target /opt/jboss-4.2.3.GA --platform jb42 --jboss-instance all --persistence db --source mvn:org.josso/josso-web-gateway/1.8.0/war

agent install


Install JOSSO Agent. The agent install process performs the following tasks:

  1. Verifies that the target platform matches the selected installer / platform.
  2. Installs 3rd party JARs needed by JOSSO Agent
  3. Installs Agent components
  4. Installs Agent configuration resources
  5. Configures the Container (when posible)

A log file with install details is created in the josso-1.8.0/log folder.

Options:

  -d (--weblogic-domain) VAL    Weblogic domain path
  -f (--force-install)          Force installation if some target validations fa
                                il
  -h (--help)                   Display this help message
  -i (--jboss-instance) VAL     JBoss instance
  -p (--platform) VAL           see list-platforms for a complete list
  -r (--replace)                Replace installed files, includes configuration!
  -t (--target) VAL             Target Install directory

Examples:

josso> agent install --target /opt/apache-tomcat-6.0.18 --platform tc60 --replace

josso> agent install --target /opt/bea/weblogic92 --platform wl92 --weblogic-domain samples/domains/wl_server/

josso> agent install --target /opt/jboss-4.2.3.GA --platform jb42 --jboss-instance all

samples install


Install JOSSO Samples

Options:

  -d (--weblogic-domain) VAL    Weblogic domain path
  -f (--force-install)          Force installation if some target validations fa
                                il
  -h (--help)                   Display this help message
  -i (--jboss-instance) VAL     JBoss instance
  -p (--platform) VAL           see list-platforms for a complete list
  -r (--replace)                Replace installed files, includes configuration!
  -t (--target) VAL             Target Install directory

Examples:

josso>  samples install --target /opt/jboss-4.2.3.GA --platform jb42 --jboss-instance all

install list-installers


List avaiable JOSSO Installers

Options:

  -h (--help)    Display this help message

Examples:

josso> install list-installers     
Available Installers with Platform ID
  Apache Tomcat 6.0.x                                      tc60
  Apache Tomcat 5.5.x                                      tc55
  Apache Tomcat 5.0.x                                      tc50
  JBoss AS 4.2.x                                           jb42
  JBoss AS 4.0.2+                                          jb40
  JBoss AS 3.2.6+                                          jb32
  Weblogic 9.2+                                            wl92
  Weblogic 10.0+                                           wl10
  JEE Generic Application Server any                       jee

install list-platforms

....
List supported platforms

Options:

  -h (--help)    Display this help message

Examples:

josso> install list-platforms
  Apache Tomcat                                            6.0.x
  Apache Tomcat                                            5.5.x
  Apache Tomcat                                            5.0.x
  JBoss AS                                                 4.2.x
  JBoss AS                                                 4.0.2+
  JBoss AS                                                 3.2.6+
  Weblogic                                                 9.2+
  Weblogic                                                 10.0+
  JEE Generic Application Server                           any
  Apache HTTP Server (perl, python, php, etc.)             2.2
  PHP                                                      4.x
  PHP                                                      5.x
  MS .Net                                                  2.x
  MS Asp                                                   x.x