Manually configuring a remote object agent for AIX

If IBM Storage Protect is not installed on an IBM® AIX® 7.2 TL 1 and SP 4 or later operating system, running on an IBM POWER8 or later server, manual configuration steps are required before you copy data from IBM Storage Protect Plus to IBM Storage Protect.

Complete the following configuration steps:

1. On the AIX server, issue the following IBM Storage Protect administrative command:

   setopt EnableAIXS3Interface Yes

2. On the AIX server, define an object agent by issuing the following IBM Storage Protect administrative command. To set the high-level address (HLA) and low-level address (LLA), specify the IP address of the host system and the port that the object agent will use.

   define server object_agent_name 
   hla=object_agent_host_system_ip_address 
   lla=object_agent_port objectagent=yes

   Tip: The default value for the object agent port is 9000. If a local object agent is already running on the system, the object agent that is being configured for the AIX server must use a different port number.
3. From the AIX server system, copy the following two items to a directory on the object agent host system on Linux:
   • Object agent server directory
   • Server public certificate

   The object agent server directory was created when you ran the DEFINE SERVER command. The directory includes the following file and certificates:

   • A configuration file that creates and automatically starts an object agent service
   • Certificates for communication between the object agent and the server

   The object agent server directory is created in the server instance directory: /server_instance_home_dir/object_agent_name

   For example, /home/tsminst1/OBJAGENT1

   The server public certificate (cert256.arm) is typically located in the server instance directory.

4. In the object agent server directory that you copied in the previous step, locate the object agent configuration file (spObjectAgent_objectagentname_serverport.config).
   For example: spObjectAgent_OBJAGENT1_1500.config

   In the object agent configuration file, update the locations of the files that are shown in this example.

    objagentexe=\"/opt/tivoli/tsm/server/bin/spObjectAgent\"
       keystore="/home/tsminst1/OBJAGENT1/agentcert.p12"
       pwdfile="/home/tsminst1/OBJAGENT1/agentcert.pwd"
       serverkeypub="/home/tsminst1/OBJAGENT1/cert256.arm"
       agentconfig=\"/home/tsminst1/OBJAGENT1/spObjectAgent_OBJAGENT1_1500.config\"

5. In the object agent configuration file, override the SERVERHLA parameter by using the AIX server IP address:

   serverhla=aix_server_ip_address

   Tip: The object agent uses this value to locate the IBM Storage Protect server.
6. To create the object agent on the host system, run the spObjectAgent executable file with the configuration file, on one line, for example:

   /opt/tivoli/tsm/server/bin/spObjectAgent service install 
   /home/tsminst1/TSMGUI11_OBJ_AGT/spObjectAgent_TSMGUI11_OBJ_AGT_1500.config
   

   Tip: The service is installed and started in one step. To verify that the service is running, use the native system management commands to query the status. Review the system logs to resolve any discrepancies.
7. Register an object client on the IBM Storage Protect server on the AIX operating system by issuing the following IBM Storage Protect server command:

   register node nodename type=objectclient

   Important: Record the login user ID and password that are automatically generated. You will need the credentials to connect to the object agent.
8. To connect the IBM Storage Protect Plus object client to the object agent, go to the IBM Storage Protect Plus online documentation and follow the instructions in Adding a repository server as a backup storage provider.