3.3 Managing the Fan-Out Agent

You can manage the Fan-Out agent by using the scripts from the Fan-Out agent installation directory. Table 3-1 lists the commands to manage the Fan-Out agent. To view the help, invoke the command with -–help option.

Table 3-1 Commands to Manage the Fan-Out Agent

Command

Description

Usage

startAgent

Starts the Fan-Out agent instance

startAgent –config

startAgent –config <fanoutagent-config.properties in the FanoutAgent Installation Location>

stopAgent

Stops the Fan-Out Agent instance

stopAgent -config

stopAgent –config <fanoutagent-config.properties in the FanoutAgent Installation Location> netiq

getservices

Fetches the status of the JDBC driver instances loaded by the Fan-Out agent and writes the status to a file.

getServices –config <fanoutagent-config.properties in the FanoutAgent Installation Location> 0 ./services.txt netiq

startService

Starts the specified JDBC driver instance. You can get the JDBC driver instance name from the output file generated by the getServices command.

startService –config <fanoutagent-config.properties in the FanoutAgent Installation Location> serviceName netiq

stopService

Stops the specified JDBC driver instance. You can get the JDBC driver instance name from the output file generated by the getServices command.

stopService –config <fanoutagent-config.properties in the FanoutAgent Installation Location> serviceName netiq

setPassword

Sets the agent and shim passwords for the Fan-Out agent instance.

setPassword -config <fanoutagent-config.properties in the FanoutAgent Installation Location> netiq microfocus netiq microfocus

setAMQKSPassword

Sets the Keystore password used for mutual authentication with ActiveMQ when SSL is enabled

setAMQKSPassword -config <fanoutagent-config.properties in the FanoutAgent Installation Location> netiq microfocus

setAMQTSPassword

Sets the Truststore password used for mutual authentication with ActiveMQ when SSL is enabled.

setAMQTSPassword -config <fanoutagent-config.properties in the FanoutAgent Installation Location> netiq microfocus

setKSPassword

Sets the keystore password for the Fan-Out command server.

setKSPassword -config <fanoutagent-config.properties in the FanoutAgent Installation Location> <type 1 or type 2> <keystore or key in the keystore password> <agent password>

where type 1 specifies the keystore password and type 2 specifies the key password in the keystore.

Examples:

  • setKSPassword -config /opt/novell/dirxml/config/fanoutagent-config.properties 1 netiq123 novell

  • setKSPassword -config C:\JDBCFanoutdriver\Agent\config\fanoutagent-config\properties 1 netiq123 novell

  • setKSPassword -config /opt/novell/dirxml/config/fanoutagent-config.properties 2 netiq123 novell

  • setKSPassword -config C:\JDBCFanoutdriver\Agent\config\fanoutagent-config\properties 2 netiq123 novell

setConfig

Changes the configuration options as specified in the input file.

NOTE:Stop the agent before changing the configuration parameters such as netiq.fanoutagent.trace.level, netiq.fanoutagent.cmd.srv.ip, netiq.fanoutagent.cmd.srv.port, and netiq.fanoutagent.cmd.allow.http. Start the agent for the changes to take effect.

setConfig -config <fanoutagent-config.properties in the FanoutAgent Installation Location> ./sample_cfg.json netiq

setEncryptionKey

Sets the encryption key. You can use this key to encrypt or decrypt ActiveMQ messages.

setEncryptionKey -config <fanoutagent-config.properties in the FanoutAgent Installation Location> netiq netiq