Labels:
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:
- Verify that the selected target matches the selected installer / platform.
- Generates and installs the 'AES' key used by the automatic authentication ('Remember Me')
- Installs default gateway configuration
- 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:
- Verifies that the target platform matches the selected installer / platform.
- Installs 3rd party JARs needed by JOSSO Agent
- Installs Agent components
- Installs Agent configuration resources
- 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