Use the information to understand the contents of the Sun Cluster HA for N1 Service Provisioning System Master Server parameter file. This section describes the structure and the content of the Sun Cluster HA for N1 Service Provisioning System Master Server parameter file, as well as the strategy to chose some of its variables.
Sun Cluster HA for N1 Service Provisioning Systemfor the master server uses a parameter file to pass parameters to the start, stop and probe command. This parameter file needs to be a valid Korn shell script which sets several variables. The structure of this file appears in Table 4. For examples of the parameter file refer to Registering and Configuring Sun Cluster HA for N1 Service Provisioning System.
Table 4 Structure of the Sun Cluster HA for N1 Service Provisioning System Master Servers parameter file
Variable |
Explanation |
---|---|
User |
The owner of the N1 Grid Service Provisioning System Master Server instance. |
Basepath |
Basepath is the absolute pathname to the directory where the N1 Grid Service Provisioning System/server/bin directory resides. It is the directory you specified at installation time. |
Host |
The Host variable is the Host to test the functionality of the Apache Tomcat component of the N1 Grid Service Provisioning System Master Server. The test is done via a connection to Host:Tport. |
Tport |
A Port where the N1 Grid Service Provisioning Systems Apache Tomcat component is serving. This Port is used together with the Host to test the functionality of the Apache Tomcat server process of the N1 Grid Service Provisioning System Master Server. |
TestCmd |
This variable represents the command which is passed to the N1 Grid Service Provisioning Systems Apache Tomcat server process to do a sanity check. If your N1 Grid Service Provisioning System Master Server is configured to use https, provide a webpage that can be connected by wget. |
ReturnString |
The variable ReturnString represents the string which must be present in the answer to the TestCmd. It can not be “Connection refused” because this string is in the answer when the N1 Grid Service Provisioning Systems Apache Tomcat server process is not running. |
Startwait |
This variable stands for the number of seconds to wait after the N1 Grid Service Provisioning System Master Server start command is completed. It lasts until the Apache Tomcat server process of the N1 Grid Service Provisioning System Master Server is fully operational. The absolute number of seconds depends on the speed and the load of the Hardware. A good strategy is to start with 60 seconds. |
WgetPath |
Provide the absolute path to a https capable wget command. The variable is needed when you configured your N1 Grid Service Provisioning System Master Server for https. |
The parameters in Table 4 can be changed at any time. The only difference is when changes take effect.
The following parameters of the Sun Cluster HA for N1 Service Provisioning System parameter file are used for starting and stopping the Master Server. Changes to these parameters take effect at every restart or disabling and enabling of a N1 Grid Service Provisioning System Master Server resource.
User
Basepath
Startwait
The following parameters of the Sun Cluster HA for N1 Service Provisioning System Master Server parameter file are used within the fault monitor. Changes to these parameters take effect at every Thorough_probe_interval.
Host
Tport
TestCmd
ReturnString
WgetPath
The ReturnString has to be present on the page you query with the test command TestCmd.
Take the start page of your application and set the TestCmd to get /index.jspor https://start_pageif you use wget to monitor the master server. Set the ReturnString to a string contained in the startpage. With this strategy, you are monitoring that the Apache Tomcat process of the N1 Grid Service Provisioning System Master Server is operational.
If the N1 Grid Service Provisioning System Master Server is configured for SSL on the administrative port. The only request on the http port is a page containing the string SSL. In this case configure the ReturnString to SSL and the TestCmd to get /index.jsp.
If you expect changes in the configurations, configure the test command to get /index.jsp and the RetunString to SSL|Service. This expression is true if the startpage contains SSL or Service.
If none of the above is appropriate, set the TestCmd to get /a-page-which-does-not-exists. In this case, set the ReturnString to a string contained in the Error Page. With this strategy, you are monitoring that the Apache Tomcat process of the N1 Grid Service Provisioning System Master Server is operational, because it registers that it must deliver a page that does not exist.
You can evaluate the different pages by connecting using a browser with hostname:port and specifying the different pages.