switch | Description | |
-port | Specifies the port on which the server listens for HTTP requests. If you add a wrapper.app.parameter property to custom_wrapper.conf for the -port switch, you must also add a wrapper.app.parameter property in which you specify the TCP/IP port number to use. The first wrapper.app.parameter property specifies that you want to override the port by using the -port switch, and the next wrapper.app.parameter property specifies the port number to use. For example: wrapper.app.parameter.7=-port wrapper.app.parameter.8=8080 Note: Keep the following points in mind when overriding the port number: This switch overrides the value assigned to watt.server.port. The -port switch permanently adds a new HTTP port to the WmRoot package. This new port is added as the primary port and contains default values. If a port with the same TCP/IP number already exists in the WmRoot package, the -port switch overrides its settings with the new default values. In effect, deleting the existing port and then adding a new port with default settings. To use port 80 (the standard for HTTP) or port 443 (the standard for HTTPS), UNIX users must be running as "root." For security reasons, a better method is to use a higher number port (5555 for HTTP and 8080 for HTTPS), and if necessary have the firewall remap port 80 to the desired port. See
Architecture for a discussion of remapping ports. | |
-debug | Specifies the level of detail you want the server to maintain in its server log for this session. The -debug switch overrides the value specified for the Default facility on the Settings > Logging page and assigned to watt.debug.level. If you add a wrapper.app.parameter property to custom_wrapper.conf for the -debug switch, you must also add a wrapper.app.parameter property in which you specify the level of detail you want to record in the log. You can specify the following levels: | |
Specify | To record | |
Fatal | Fatal messages only. | |
Error | Error and fatal messages. | |
Warn | Warning, error, and fatal messages. | |
Info | Informational, warning, error, and fatal messages. | |
Debug | Debug, informational, warning, error, and fatal messages. | |
Trace | Trace, debug, informational, warning, error, and fatal messages. | |
The first wrapper.app.parameter property specifies that you want to override the debug level by specifying the -debug switch, and the next wrapper.app.parameter property specifies the level of detail you want to record in the log. For example: wrapper.app.parameter.11=-debug wrapper.app.parameter.12=fatal Note: Prior to Integration Server 7.1, Integration Server used a number-based system to set the level of debug information written to the server log. Integration Server maintains backward compatibility with this system. For more information about the number-based logging levels, see the description of the watt.debug.level property in Server Configuration Parameters. | ||
-log | Specifies where you want the server to write its server log information for this session. If you add a wrapper.app.parameter property to custom_wrapper.conf for the -log switch, you must also add a wrapper.app.parameter property in which you specify the destination of the log information. You can specify the following destinations: | |
Option | Description | |
filename | Specify the fully qualified path or relative path to the file in which you want the server to write server log information for this session. Relative path is relative to the Integration Server home directory: Integration Server_directory \instances\instance_name The filename must specify a directory and filename. The default destination is controlled by the watt.debug.logfile server configuration parameter. | |
none | Write server log information to the computer screen (STDOUT). | |
both | Write server log information to the computer screen (STDOUT) and to the destination specified by the watt.debug.logfile parameter. | |
The first wrapper.app.parameter property specifies that you want to override the destination of the log information by specifying the -log switch, and the next wrapper.app.parameter property specifies either the complete path for the home directory or none. For example: wrapper.app.parameter.13=-log wrapper.app.parameter.14=none Note: A swtich value of filename or none overrides the value assigned to watt.debug.logfile for this session. | ||
Note: A -log switch value of none or both also determines where Microservices Runtime or an Integration Server equipped with an Microservices Runtime license writes the configuration variables log. However, Microservices Runtime ignores a filename value. If you specify a filename,Microservices Runtime writes the configuration variables log file to this location only: Integration Server_directory /instances/instanceName/logs/configurationvariables.log. | ||
-quiesce | Specifies that Integration Server starts the server in quiesce mode. When you add a wrapper.app.parameter property to custom_wrapper.conf for the -quiesce switch, Integration Server starts in quiesce mode. The -quiesce switch does not require an additional wrapper.app.parameter property. For example: wrapper.app.parameter.15=-quiesce For more information about quiesce mode, see
Quiescing the Server for Maintenance. |