Downloading instance configurations from the command line

Edit online

Instead of exporting an instance configuration from Configuration Feature, you can download instance configurations from a command line on the system where Collector Server is installed.

Notes:

¹ On Linux® and UNIX systems
² On Windows

Parameters

com.ibm.esd.configplugin.util.DownloadService

Starts the Java™ utility that is used for downloading an instance configuration.

-url url

Specifies the URL of IBM® Content Navigator in the following format:

protocol://hostname:portnumber/context_root/

-desktop id

Specifies the IBM Content Navigator desktop for the Collector Server administrator.

-id instance_id

Specifies the ID of the instance configuration that is to be downloaded.

The ID of the instance configuration is part of the command that is displayed to you when you export an instance configuration from Configuration Feature. For more information, see Exporting the instance configuration from Configuration Feature. Starting with Fix Pack 1, the ID is also shown in the upper right corner of an instance configuration that you opened in Configuration Feature for editing.

-user userid

Specifies the user ID that the Collector Server administrator uses to log on to IBM Content Navigator.

-password password

Specifies the password. If you do not specify the password as part of the command, you are prompted for it.

Important: If you include the password in the command, this password is visible in the task manager.

-filename filename

Specifies the file name or the fully qualified file name of the server configuration profile.

-overwrite yes

Specifies that a server configuration profile with the same fully qualified file name is overwritten.

Instead of typing the command on a command line or in a shell script, you can copy the command from Configuration Feature of IBM Content Navigator. For more information, see Exporting the instance configuration from Configuration Feature.

Example

archcmd.sh com.ibm.esd.configplugin.util.DownloadService
-url https://myserver.com:9443/navigator/ -desktop iccsap -id 1 -user iccsapadmin
-filename C:\Users\iccsapadmin\AppData\Roaming\IBM\iccsap\inst2\archint2.ini

The instance configuration with ID 1 is downloaded from the IBM Content Navigator desktop iccsap by user ID iccsapadmin. It is saved as archint2.ini in the path C:\Users\iccsapadmin\AppData\Roaming\IBM\iccsap\inst2.