Change Application wizard - assure_mimix - 6.0

Use the Change Application wizard to change the existing clustered application settings of a replication group.

1. From the Replication Group or Cluster portlets click Configuration.

2. From the Configuration window, select Change Application from the Actions dropdown for a replication group.

   The Change Application - Select Cluster panel displays. This panel shows the selected replication group that is participating in the specified cluster. Cluster services will be stopped while configuration changes are deployed. Replication groups participating in the cluster will not be managed until cluster services are started again

   

    

   The Change Application - Select Cluster panel contains the following fields:

   Field	Description
   Replication group	Specifies the name of the replication group.
   Cluster	Specifies the name of the cluster that this replication group is assigned to.

3. Click Next. The Change Application - Application panel displays. Specify the application name, description, and an optional highly available host name that follows the application when a failover occurs to the recovery server. 

   

    

   The Change Application - Application panel contains the following fields:

   Field	Description
   Application name	Specifies the name of the application. Application names can be 256 characters long and can contain any alphanumeric character. Application names must start with an alphanumeric character. Hyphens ( - ) and underscores ( _ ) are allowed. Spaces or other special characters are not allowed.
   Description	Specifies an optional description for the application. Application descriptions can be 256 characters long and can contain any alphanumeric character. Whitespace is allowed,
   Highly available host name	Specifies an optional highly available host name for the application. When a planned or unplanned failover procedure is run, the highly available host name will take effect on the recovery server. Highly available host names must start with an alphanumeric character. Hyphens ( - ) and underscores ( _ ) are allowed. Spaces or other special characters are not allowed.

4. Click Next. The Change Application - Application Processes and Monitoring panel displays. Enabling the cluster to manage the availability of the application is recommended. Specify scripts to start and stop the application processes and which processes to monitor for availability. 

   

    

   The Change Application - Application Processes and Monitoring panel contains the following fields:

   Field	Description
   Enable the cluster to manage application availability	Indicates if this replication group has start and stop scripts and application monitoring defined.
   Start script	Specifies the command that starts the application process. The start script is also responsible for ensuring that the correct number of instances of a process is running, and for starting instances as needed. The Start script can be a script or a binary file. The field includes the absolute path to the command. Possible values: valid path blank
   Stop script	Specifies the command that stops the application's process or processes anytime the application is stopped. The Stop command can be a script or a binary file. The field includes the absolute path to the command. Possible values: valid path blank
   Processes to monitor	Specifies the name of the process started by the Start script and monitored by the clustering component. For possible values see the description for match criteria.
   match criteria	Specifies the criteria to use to find the process to monitor. Possible values: Simple match—The specified string is matched against the output of ps -eo args. If the supplied string appears as a part of any output lines, then the process is assumed to be started. If you are monitoring more than one process, enter each additional process name separated by a semi-colon. In that case, the application is reported to be started only if all specified processes are found. Regex match—The specified string is a regular expression matched against the output of ps -eo args. If the specified string appears as a part of any output lines, then the process is assumed to be started. If you are monitoring more than one process, enter each additional process string separated by a semi-colon. In that case, the application is reported to be started only if all specified processes are found. The regular expression match uses POSIX Regular Expression matching. Precisely recommends that you use the Simple Match option and match the string exactly as it appears in the ps -eo args output. PID file— The specified string is taken as the path of the processes PID (process identification number) file. The process is reported to be started only if the PID file exists, and the PID contained in it matches a running process. Script—The specified string is taken as a shell command, whose exit code indicates the status of the process. Exit code value           Status the process  Less than zero                         Agent Error     0                                              Running     1                                              Stopped     Greater than 1                         Failed
   Polling interval:	Specifies how often, in seconds, the clustering component checks for this process. Possible values are 0-999 or dash.
   Delay before starting	Specifies the time in seconds that the clustering component will wait after the application starts before it begins monitoring the process. Possible values are 0-999 or dash.

5. Click Next. The Change Application - Custom Monitors panel displays. Custom monitors are optional and are used to monitor any resource. 

   

    

   The Change Application - Custom Monitors panel contains the following fields:

   Field	Description
   Add	Displays the Add Custom Monitor dialog you can use to add a custom monitor.
   Remove	Displays the Add Custom Monitor dialog you can use to remove a custom monitor. This action will remove a row from the table.
   Select all checkbox	Used to select all items in the list.
   Monitor	Specifies the name of the custom monitor. The name can be up to 32 characters in length and can contain any characters except space.
   Command	Specifies the script or command to run to monitor the application. Possible values are: A valid path. The script is abbreviated to 40 characters with an ellipsis in the middle of the path. A dash
   Delay	Specifies the amount of time to wait in seconds of when to begin running the monitor. Possible values are 0-999 or dash.
   Interval	Specifies the time interval in seconds of how often to run the monitor. Possible values are 0-999 or dash.
   Retries	Specifies the maximum number of times to retry the monitor before a failure is flagged. possible values are 0-999 or dash.
   Actions	Select Details to display the Custom Monitor Details dialog box. Select Remove to display the Remove Custom Monitor dialog box.

6. Click Next. The Change Application - Service IP Addresses panel displays. Service IP addresses are optional and follow the application when a failover occurs to the recovery server. 

   

    

   The Change Application - Service IP Addresses panel contains the following fields:

   Field	Description
   Service IP Address	Specifies the service IP address.
   Network Name	Specifies the name of the network.
   Network ID	Specifies the network ID of the network.
   Subnet Mask	Specifies the subnet mask of the network selected
   Actions	Select Details to display the Service IP Address Details dialog box. Select Remove to display the Remove Service IP Address dialog box.

7. Click Next. The Change Application Summary panel displays. The following is a summary of the application configuration for the replication group being added to the cluster. To save this configuration, click Finish. To cancel, click Cancel.