Starting the Server in Quiesce Mode from the Command Prompt
You can start the server in quiesce mode by setting the
-quiesce switch in custom_wrapper.conf. For information about other startup command switches, see
Starting and Stopping the Server.
Note: | If Integration Server is installed as a Windows service, you cannot start the server in quiesce mode. This is because the command-line parameters were set when the server was registered as a Windows service. In this case, you must first start the server in active mode, and then restart the server in quiesce mode, from Integration Server Administrator. |
To start the server in quiesce mode from the command prompt
1. In a text editor, open the custom_wrapper.conf file from the following directory:
Software AG_directory \profiles\IS_instance_name\configuration
where instance_name is the name of the Integration Server instance.
2. Add the following property to custom_wrapper.conf:
wrapper.app.parameter.n=-quiesce
where n is the next unused sequential number for wrapper.app.parameter.n properties in the file.
3. In the custom_wrapper.conf, update the wrapper.app.parameter.2 property to reflect the total number of wrapper.app.parameter properties that you added in the previous steps.
For example, if wrapper.app.parameter.2 is set to 4 (the default) and you add one wrapper.app.parameter property, you would increase the value of wrapper.app.parameter.2 by one. After making your edits, the wrapper.app.parameter.2 would appear as follows:
wrapper.app.parameter.2=5
For more information about the wrapper.app.parameter property, see Software AG Infrastructure Administrator's Guide.
4. At a command prompt, type the following command to switch to the server’s home directory:
cd Software AG_directory \profiles\IS_ instance_name\bin
Note: | The startup.bat/sh and shutdown.bat/sh scripts contained in the Integration Server_directory \instances\instance_name\bin directory are deprecated. Software AG recommends the use of the scripts contained in the Software AG_directory \profiles\IS_instance_name\bin directory. If you will manage Integration Server through Command Central, you must use the scripts located in the Software AG_directory \profiles\IS_instance_name\bin directory. |
5. Type the following command to start the server:
For Windows: | startup.bat |
For UNIX: | startup.sh |
When you open the Integration Server Administrator, a message displays to indicate that the server is running in quiesce mode.
Note: | If the server cannot disable or suspend an asset or activity as it enters quiesce mode, the server displays a warning message and continues the quiesce process. If the condition stated in the warning interferes with a maintenance task you intend to perform, resolve the issue stated in the warning and then restart the server in quiesce mode. |