HTTP Listener options

Options control automatic restarts when the Launcher fails, and whether clients connect to the Launcher service through a firewall. You also add and remove HTTP Listeners by using Options. These options correspond to the options that you configure on the Options page of the graphical Launcher Administration interface.

{launcheradmin.bat | launcheradmin.sh}
  [-firewall {enable | disable}]
  [-fsport server_port ]
  [-fcport client_port]
  [-restart {enable | disable}]
  [-rretry retry_attempts]
  [-rrtimeout minutes]
  [-addlsnr name:listener_name[;mode:{enabled | disabled}][;httpport:port][;lnchport:port]
    [;httpcert:certificate][;lnchcert:certificate][;loglevel:{none | standard | verbose}]
    [;audit:{enabled | disabled}]
  [-remlsnr name:listener_name]

-firewall {enable | disable}: Specifies whether to enable a firewall configuration. In a firewall environment, clients like the Management Console use a designated server port to connect to the Launcher service. The Launcher service opens up a listening port to establish the initial connection. All the client requests for service are exported to the server port and all services are provided through this port. By default, the firewall is disabled.
-fsport server_port: Specifies the server-port value of the firewall-specific server port that is to be used by the Launcher service.
-fcport client_port: Specifies the client-port value of the firewall-specific client port that is to be used by the Launcher service.
-restart {enable | disable}: Enables or disables automatic restart when the Launcher fails. Restart is enabled by default.
This option is valid only on distributed platforms. It is not supported on USS.
-rretry retry_attempts: Specifies how many times the Launcher is to attempt to restart after a failure. The default value is two restart attempts. If the specified number of restart attempts has not occurred when the time specified by -rrtimeout elapses, the Launcher continues to retry until it reaches the specified number of attempts.
-rrtimeout minutes: Specifies how long, in minutes, the Launcher is to attempt to restart after a failure. The default value is 10 minutes. There are five minutes between each restart attempt.

-addlsnr name:listener_name

Specifies the name of the HTTP Listener to add or edit. If the specified listener does not exist, -addlsnr creates it and sets the specified properties. If the listener exists, -addlsnr edits the specified properties:

mode:{enabled | disabled}: Specifies whether the HTTP Listener starts when the Launcher starts. By default, the listener is disabled and does not start with the Launcher.
httpport:port: Specifies the port where the client posts an HTTP request. The default port number is 5017.
lnchport:port: Specifies the HTTP Listener port that connects to the Launcher to trigger a map. The default port number is 5018.
httpcert:certificate: Specifies the name in the key store of the certificate from the Certificate Signing Authority, used to for secure communication with clients.
lnchcert:certificate: Specifies the name in the key store of the certificate that enables secure communication with maps. The key store is set in the config.yaml file in the installation directory.
loglevel:{none | standard | verbose}: Specifies the trace setting for the HTTP Listener. By default, the listener is not traced (none).
audit:{enabled | disabled}: Enables or disables auditing of HTTP Listener client requests and connections. Auditing is disabled by default.

-remlsnr name:listener_name

Deletes the specified HTTP Listener.