Installing Storage Resource agents by using a command

You typically install Storage Resource agents by using the IBM Spectrum® Control GUI. However, if you must install Storage Resource agents locally, you can do so with limited support.

During this installation method, a return code of zero means that a successful installation occurred and a nonzero return code means that an unsuccessful installation occurred. If you have an unsuccessful installation, you must review the log files to determine the problem.

The-force option can be used when you have a Storage Resource agent point to multiple servers. If an agent is installed on one server, and another server wants to install an agent in the same location, the second server can use the -force option to install the agent.

If you use this installation method, when you enter a directory to install the Storage Resource agent, do not add an ending slash mark (\). For example, do not specify C:\agent1\. This action causes the installation to fail.

If you run the agent as a non-daemon service (on-demand service), you must make sure that at least one protocol is valid for a successful connection from the server to the agent. See Table 1 for the required parameters for each protocol.

Table 1. Parameters required for each protocol
Protocol	Description
SSH	Requires the user ID and password or user ID, certificate, and passphrase.
Windows™ (SMB)	Requires the user ID and password.
REXEC	Requires user ID and password.
RSH	Requires the user ID.

The Storage Resource Agent image contains the installation images for the Storage Resource agents in the following directory:

DVD_installation_image_location/data/sra/operating_system

See Table 2 for the Storage Resource agent installation images.

Table 2. Storage Resource agent installation images
Operating system	Operating system name
AIX®	aix_power
Linux® x86	linux_ix86
Linux for Power Systems™ Servers	linux_power
Linux s390	linux_s390
Windows	windows

To install the Storage Resource agents locally, complete the following steps:

Go to the installation image location:
```
cd DVD_installation_image_location
```
Run the following command:
Notes:
¹ Parameters when the agent is run as a daemon service.
² Parameters when the agent is run as a non-daemon service. See Table 1 to determine which parameter is required for each protocol.
³ Parameters when the agent is run as a non-daemon service. See Table 1 to determine which parameter is required for each protocol.
The parameters are as follows.
-install

Installs the Storage Resource agent.

-force
Forces the agent to be installed. The two different situations in which this parameter must be specified are as follows.

If an earlier installation failed and there is residue on the system that causes further installations to fail. You must verify that all the parameters that are provided are valid, such as the installation location, port .

If the agent is already installed from one server and you now must install the agent pointing to another server.
-serverPort server_secure_port

The default port for the Data server is 9549.

-serverIP server_IP_address

The IP address of the server. If the server can be reached through multiple IP addresses, then multiple IP addresses can be specified with IP addresses separated with a comma.

-installLoc "Agent_install_location"

Location where the agent is installed. Enclose the directory name in quotation marks, for example, "C:\Program Files\IBM\TPC_SRA".

-debug MAX

Optional parameter for debugging purposes.

-agentPort agent_port

If the agent is run as a daemon service, the agent port must be specified. The default agent port is 9510.

-commtype daemon

If the agent is run as a daemon service, then this parameter must be specified.

-userID user_ID

For non-daemon service. The user ID defined on the agent system. This user ID is used by the server to connect to the agent system.

-password password

For non-daemon service. Password for the user ID.

-certFile "certificate_file"

For non-daemon service. The certificate that is used for SSH communication between the server and agent. This certificate must be stored on the server system. Enclose the directory name in quotation marks, for example, "c:\keys\id_sra".
For information about SSH protocol and SSL protocol certificates, see Creating a certificate for SSH protocol and Replacing default SSL certificates for the Data server and Storage Resource agents with custom SSL certificates.

-passphrase passphrase

For non-daemon service. The passphrase that is defined for the certificate that is used in SSH communication.

After you install a Storage Resource agent by using a command, you must schedule a probe to collect data about the associated resource. For information about how to schedule a probe, see Creating probes.