Changing an instance configuration
You might need to change some of the configuration parameters from the values you specified when you ran the CRTINSTOND command. These parameters exist in either the ARS.INI file or the ARS.CFG file.
Each instance definition starts with the line [@SRV@_[instance]] where instance is the name of the instance. For example, the instance ONDTEST would start with the line [@SRV@_ONDTEST].
Review the following lines:
- PORT=0
- The port to which the server listens to receive requests from a Content Manager OnDemand client. The value of 0 means to use the default port of 1445. Only one server can be listening to a particular port at any given time. To run multiple instances concurrently, you must specify an unused port on your system. You can run the Work with TCP/IP Network Status (WRKTCPSTS) OPTION(*CNN) command to see what ports are currently in use on your system.
- SRVR_FLAGS_SECURITY_EXIT=1
- Specifies that you want to use IBM i user IDs and passwords as the Content Manager OnDemand user IDs and passwords. This is the default value and makes it simpler for your end users because they do not have to maintain multiple passwords. If your Content Manager OnDemand users do not need to have IBM i user IDs then you should specify a value of 0 for this parameter. When you do this, your Content Manager OnDemand passwords have no relationship to IBM i passwords. However, if a Content Manager OnDemand user ID and an IBM i user profile match, some Content Manager OnDemand commands and APIs use the IBM i user profile as the Content Manager OnDemand user ID, even if you have chosen not to relate the two. This situation could permit IBM i users to perform Content Manager OnDemand functions that you did not intend for them to perform. A Content Manager OnDemand user ID should not match an IBM i user profile name unless the two ids are used by the same individual. If you make a change to the SRVR_FLAGS_SECURITY_EXIT value, you should review the Content Manager OnDemand System Parameters values (defined using the Content Manager OnDemand administrative client) for the instance that you have changed.
- HOST=LOCALHOST
- If you are enabling IPv6 on your IBM i system and need some of your Content Manager OnDemand instances to use IPv4 addressing and others to use IPv6 addressing, you might need to change HOST=LOCALHOST to HOST=IPV6-LOCALHOST within the ARS.INI stanza for each instance that you want to use IPv6 addresses. You might want some instances to run with IPv6 and others with IPv4. This mixed environment is fully supported. Also, during the transition from IPv4 to IPv6, Content Manager OnDemand clients that use IPv4 addresses can connect to the server simultaneously with clients that use IPv6 addresses.
You can change
these values:
- ARS_DISABLE_ARSLOG=1
- Specifies that the ARSLOG user exit is to be disabled. Set this value to 1 to disable the exit; set this value to 0 to enable the exit.
- ARS_LANGUAGE=ENU
- Specifies the language in which this instance runs. The example shows the use of the English language.
- ARS_MSGS_LANGUAGE=ENU
- Specifies the language that is used for server messages. The example shows the use of the English language.
- ARS_AUTOSTART_INSTANCE=1
- Specifies whether or not to automatically start the server for this instance when using the Start TCP/IP Server (STRTCPSVR) command. Set this value to 1 to automatically start this instance's server; set this value to 0 if you do not want to automatically start this instance's server.
Do not modify any of the other values in these instance definition files without first consulting with Content Manager OnDemand Support. You must end and restart the instance server after you make any changes.