To enter the karaf shell, press Enter after you start up the Geronimo server using geronimo run command.

Note that if the <name> portion of the command is unique, then you only need to type it. If not, then you must either type the full <scope>:<name> or arrange the scope search path accordingly. For example, you can use list-modules instead of deploy:list-modules to list all modules in the server repository.

Following options are common to those commands:

-s or --server, --hostname

Hostname, default localhost

-p or --port

Port, default 1099

-u or --username

Specify an Username to start the server

-w or --password

Specify the password to start the server

--help

Display this help message

geronimo:start-server

Anchor
gogocommandstartserver gogocommandstartserver

The server can be started through Felix Shell using the geronimo:start-server command. It uses the following syntax:

-A or --javaagent

Use a specific Java Agent, set to _none_ to disable

-b or --background

Run the server process in the background

-D or --property

Define system properties

-G or --gproperty

Define server system properties

-H or --home

Use a specific server home directory

-j or --jvm

Use a specific Java Virtual Machine for server process

-J or --javaopt

Set a Java Virtual Machine flag

-l or --logfile

Capture console output to a specified log file

-m or --modules

Start up a specific module by name

-P or --profile

Specify a configuration profile

-q or --quite

Suppress informative and warning messages

-t or --timeout

Specify the timeout for the server process in seconds

-v or --verbose

Enable verbose output; specify multiple times to increase verbosity

--secure

Use secure channel

Back to Top

geronimo:stop-server

Anchor
gogocommandstopserver gogocommandstopserver

The server can be stopped using the geronimo/stop-server command. It uses the following syntax:

--secure

Use secure channel

stop-server command examples

Use this syntax to stop the server.

Back to Top

geronimo:wait-for-server

Anchor
gogocommandwaitforserver gogocommandwaitforserver

The command is used to verify if the server has started in the given time (in seconds). It uses the following syntax:

-t or --timeout

Specify the time (in seconds) to wait while verifying the that the server has started. 60 seconds by default

Back to Top

deploy:login

Anchor
gogocommandlogin gogocommandlogin

The command is used to save the username and password for the current connection to a file to avoid future prompting. This command is used for remote connections only. It has the following syntax:

--secure

Use secure channel

login command examples

Use this syntax to save the username and password of the current connection so that you will not be prompted for credentials again when you issue other commands via the connection. Make sure you use deploy:connect firstly to connect to a remote instance, then use deploy:login to record the credential.

Back to Top

deploy:encrypt

Anchor
gogocommandencrypt gogocommandencrypt

The command is used to generates an encrypted string using org.apache.geronimo.util.EncryptionManager. It has the following syntax:

--secure

Use secure channel

encrypt command examples

Use this syntax to encrypt string passw0rd on an active server so that the encryption settings of that server will be used.

Back to Top

deploy:assemble-server

Anchor
gogocommandassembleserver gogocommandassembleserver

The command is used to extract a customized server assembly from the current one. It has the following syntax:

-a, or --artifact

Specify the artifact name of target server

-f, or --format

Specify if the assembly is in .zip or tar.gz format

-g, or --groupId

Specify the group ID of the library

-t, or --path

Specify the assembly location, where your specific plug-ins are stored. The default location is {{<ce_home>/var/temp/}} 

-l, or --list

Refresh the plug-in list

assemble-server command examples

Use this syntax to create a custom server assembly, which is placed at <ce_home>/var/temp/.

Back to Top

geronimo:start-client

Anchor
gogocommandstartclient gogocommandstartclient

The command is used to start a Java EE application client. Note that before starting a client, you have to deploy the application to the server. It has the following syntax:

-A or --javaagent

Use a specific Java Agent, set to _none_ to disable

-b or --background

Run the server process in the background

-D or --property

Define system properties

-G or --gproperty

Define server system properties

-H or --home

Use a specific server home directory

-j or --jvm

Use a specific Java Virtual Machine for server process

-J or --javaopt

Set a Java Virtual Machine flag

-l or --logfile

Capture console output to a specified log file

-P or --profile

Specify a configuration profile

-t or --timeout

Specify the timeout for the server process in seconds

-v or --verbose

Enable verbose output; specify multiple times to increase verbosity

Back to Top

deploy:connect

Anchor
gogocommandconnect gogocommandconnect

The command is used to connect to an instance of server that is already running. After connected successfully, you can run a series of commands on the remote server. It has the following syntax:

--secure

Use secure channel

Note that you can also use ssh:ssh command provided by Karaf shell to connect to a remote instance.

connect command examples

Use this syntax to connect to a remote server instance:

Back to Top

deploy:disconnect

Anchor
gogocommanddisconnect gogocommanddisconnect

The command is used to close the connection to a remote server. Only one instance of the server can be connected at a time, no additional options are needed to specify which server to disconnect from. If you are trying to connect to a second server instance, use this command to disconnect first. It has the following syntax:

disconnect command examples

Use this syntax to disconnect a current connection.

Back to Top

deploy:deploy-module

Anchor
gogocommanddeploymodule gogocommanddeploymodule

The command is used to deploy a module to the server. Once deployed, a module is identified by its module ID within the server. It has the following syntax:

* Java EE Enterprise Application Archive (EAR) file

* Java EE Web Application Archive (WAR) file

* Java EE Enterprise JavaBean Archive (JAR) file

* Java EE Java Resource Archive (RAR) file

* Web Archive Bundle(WAB) file

* Enterprise Bundle Archive(EBA) file

--secure

Use secure channel

-i or --inPlace

Add and start an archive or directory to an active server, without the archive or directory being copied into the server directory tree

-t or --targets

Specify the target repository to be deployed into. See [list-targets|#gogocommandlisttargets] for the names of repositories available on the server.

deploy-module command examples

Use this syntax to deploy a WAR file.

Use this syntax to deploy a WAR file whose deployment plan is located outside of the WEB-INF directory.

Back to Top

deploy:distribute-module

Anchor
gogocommanddistribute gogocommanddistribute

The command works exactly like deploy-modules except the module is not started once it has been deployed into the server and is not marked to be started each time the server starts. It has the same syntax and options as deploy-modules:

distribute command examples

Use this syntax to distribute a module whose deployment plan is located outside of the WEB-INF directory.

Back to Top

deploy:list-targets

Anchor
gogocommandlisttargets gogocommandlisttargets

The command is used to list all available target repositories on the server. It has the following syntax:

--secure

Use secure channel

list-targets command examples

Use this syntax to list all available target repository where you can deploy applications to on the localhost.

Back to Top

deploy:list-plugins

Anchor
gogocommandlistplugins gogocommandlistplugins

The command is used to list all of plug-ins in a Geronimortain maven repository. It has the following syntax:

--secure

Use secure channel

-rr or --refresh-repository

refresh repository

-r or --repository

repository URL

-rl or --refresh-list

referensh plug-in list

list-plugins command examples

Use this syntax to first access the list of repositories. Select a repository from the list, plug-ins in this repository is displayed.

Use this syntax to display the list of plug-ins in the given repository using secure channel.

Back to Top

deploy:new-server-instance

Anchor
gogocommandnewserverinstance gogocommandnewserverinstance

The command is used to create a new server instance. It has the following syntax:

--secure

Use secure channel

new-server-instance command examples

Use this syntax to create a new server instance instance2.

Back to Top

deploy:redeploy-module

Anchor
gogocommandredeploymodule gogocommandredeploymodule

The command is used to deploy a newer version of a module onto a server where the older module is already deployed. It has the following syntax:

* Java EE Enterprise Application Archive (EAR) file

* Java EE Web Application Archive (WAR) file

* Java EE Enterprise JavaBean Archive (JAR) file

* Java EE Java Resource Archive (RAR) file

* Web Archive Bundle(WAB) file

--secure

Use secure channel

redeploy-module command examples

Use this syntax to deploy a newer version of an existing module .

Back to Top

deploy:undeploy-module

Anchor
gogocommandundeploymodule gogocommandundeploymodule

The command is used to properly remove a module from a server. It has the following syntax:

--secure

Use secure channel

undeploy-module command examples

Use this syntax to remove an existing module.

Back to Top

deploy:start-module

Anchor
gogocommandstartmodule gogocommandstartmodule

The command is used to start an existing module on the server which is not running. It use the following syntax:

--secure

Use secure channel

start-module command examples

Use this syntax to start an existing module.

Back to Top

deploy:stop-module

Anchor
gogocommandstopmodule gogocommandstopmodule

The command is used to stop a running module on the server. It use the following syntax:

--secure

Use secure channel

stop-module command examples

Use this syntax to stop a running module.

Back to Top

deploy:restart-module

Anchor
gogocommandrestartmodule gogocommandrestartmodule

The command is used to restart a module on the server. It has the following syntax:

--secure

Use secure channel

restart-module command examples

Use this syntax to restart a module.

Back to Top

deploy:list-modules

Anchor
gogocommandlistmodules gogocommandlistmodules

The command is used to list modules in the target repository. It has the following syntax:

--secure

Use secure channel

-t or --stopped

Show stopped modules only

-r or --started

Show started modules only

-a or --all

Show both started and stopped modules, this one is default if you did not specify any parameters

list-modules command examples

Use this syntax to list the started modules in the target repository.

Back to Top

deploy:install-plugin

Anchor
gogocommandinstallplugin gogocommandinstallplugin

The command is used to install a geronimo plug-in into the server. It has the following syntax:

--secure

Use secure channel

install-plugin command examples

Use this syntax to deploy a CAR file.

Back to Top

deploy:install-library

Anchor
gogocommandinstalllibrary gogocommandinstalllibrary

The command is used to install a Java library file into the server. Meanwhile, the library file will be converted into an OSGi by the server. It has the following syntax:

--secure

Use secure channel

-g or --groupId 

Specify the group ID of the library

If installed successfully, the library will be found in <geronimo_home>/repository. Meanwhile, the library file will be converted into an OSGi by the server.

install-library command examples

Use this syntax to install a java library file.

Back to Top

deploy:install-bundle

Anchor
gogocommandinstallbundle gogocommandinstallbundle

The command is used to install an OSGi bundle or a common jar library file into the server(the jar file will be converted into an OSGi bundle), and the bundle information will be recorded in etc/startup.properties file. It has the following syntax:

--groupId

Defines a group Id for the bundle.

--startLevel

Specifies start level of the bundle.

--start

Specifies whether to start the bundle after installation. By default, the bundle is not started.

install-bundle command examples

Use this syntax to install an OSGi bundle. If the file is a jar library file, the library file will be converted into an OSGi bundle by the server.

Back to Top

deploy:uninstall-bundle

Anchor
gogocommanduninstallbundle gogocommanduninstallbundle

The command is used to uninstall a bundle in server. It has the following syntax:

--secure

Use secure channel

uninstall-bundle command examples

Use this syntax to uninstall an OSGi bundle with id 361 in the server.

Back to Top

deploy:unlock-keystore

Anchor
gogocommandunlockkeystore gogocommandunlockkeystore

The command is used to unlock a keystore and private key in server. It has the following syntax:

--secure

Use secure channel

Back to Top

equinox:diagnose

Anchor
gogocommanddiagnose gogocommanddiagnose

The command is used to diagnose constraints of an installed OSGi bundle and verify if the bundle can be resolved successfully. The command is only available in Equinox OSGi runtime.

-s or --simple

Do not perform deeper analysis of resolver problems

diagnose command examples

Use this syntax to diagnose the resolver problem of a bundle with Id 85.

Back to Top

eba:resolve

Anchor
gogocommandresolve gogocommandresolve

The command is used to resolve constraints of an Aries applications and create the deployment manifest application.MF for the application.

-o or --out

Specify the name of a file to write the application in.

resolve command examples

Use this syntax to resolve an Aries application.

Back to Top

obr:geronimo-refresh

Anchor
gogocommandgeronimorefresh gogocommandgeronimorefresh

The command is used to refresh bundle status in the repository of Geronimo server. This command is useful when you installed a new bundle in to Geronimo server and want the bundle information to be added in to the bundle repository of the server.

Back to Top