HA Monitor Kit provides a sample file of the server start command. Copy the sample file and set it up as explained in this chapter, and customize it as needed. For the storage location and copying destination of the sample file, see 3.2.7(1) Setting up the server start, termination, and monitoring commands.
The server start command sample file executes the act_proc() shell function that describes the startup process to start Oracle listeners and Oracle instances.
The following figure shows the content of the server start command sample file.
Figure 4-1 Content of the server start command sample file
![[Figure]](figure/zu040100.gif)
Numbers 1 through 5 in the figure are explained below.
- This is the environment variable for setting up the operating environment necessary for starting programs.
For details about the content to be set up here, see (1) Environment variables.
- This is the Oracle listener startup process.
The process for executing the haoralsnrbgn command to start the Oracle listener specified by the listener name is described here. For details about the content to be set up here, see (2) Setup method.
For details about the haoralsnrbgn command, see haoralsnrbgn (Starts an Oracle listener) in 4.5 Commands used for setting up the server start, termination, and monitoring commands.
- This is the Oracle instance startup process.
The process for executing the haorainsbgn command to start the Oracle instance specified by the instance identifier is described here. For details about the content to be set up here, see (2) Setup method.
For details about the haorainsbgn command, see haorainsbgn (Starts an Oracle instance) in 4.5 Commands used for setting up the server start, termination, and monitoring commands.
- This is the return value of the server start command.
For details about the content to be set up here, see (2) Setup method.
- This is the process executed by the act_proc() shell function.
To add a user's own process, add it inside this act_proc() shell function. For details about the content to be set up here, see (3) Server start command customization.
- Organization of this section
- (1) Environment variables
- (2) Setup method
- (3) Server start command customization
You can add non-Oracle application processes necessary for a job, and user-specific processes, to the server start command. When customizing the command, note the following:
- Before adding a process, see the description under Creating a server start command in the manual HA Monitor (for Linux(R)).
- Add the process in the act_proc() shell function inside the server start command. Do not edit any items other than the act_proc() shell function and the shell variables.
The process described here must be executed with superuser permissions. If you have changed your permissions, change them back to superuser permissions.
- Do not use the exit command inside the act_proc() shell function. To terminate the process, use the return command.
- The return code of the act_proc() shell function becomes the return value of the server start command. To suspend the server startup, make the act_proc() shell function return a value other than 0.
- Do not add a process that does not return control to the server start command, for example, making the executed command resident.
- For the output destination for the messages issued by the act_proc() shell function, see 5.4 Checking the server logs.
- Specify absolute paths for the commands and files to be input/output inside the act_proc() shell function. (That is, commands other than the ones provided by HA Monitor Kit.)
- Do not modify the names of the following shell variables:
- Before adding a shell variable, search through the command to make sure it is not already being used.