Adding the IBM i File System Agent Client

After you install the File System Agent on the access node, create an IBM i File System Agent client in the CommCell Console.

Procedure

1. From the CommCell Browser, right-click Client Computers, point to New Client > File System, and then click IBM i.

   The New iSeries Client Configuration dialog box appears.

2. On the General tab, enter the IBM i File System Agent client configuration information.

   1. On the General tab, in the Client Name box, type the IBM i File System Agent client name.

   2. In the Host Name box, type the host name of the IBM i File System Agent client.

   3. In the Data folder box, type the location of the data files for the IBM i File System Agent client.

   4. In the CVD Port box, type or select the CVD port number.

      Note

      The port number must be the same port value that you specified in the IBM i File System Agent client host configuration. The default value is 9401.

   5. To set the IBM i user credentials, in the IBM i User Credentials area click Change. Then, on the Enter User Name and Password dialog box, type the IBM i user credentials, and click OK.

      Note

      The software uses this user profile to run the Commvault operations and to set ownership of Commvault binaries.

      You must select a user profile that meets the following requirements:

      • The profile has the *SECOFR user class and with all special authorities.

      • The profile is enrolled in the QDLS file system when QDLS data protection is required.

      • The profile has the language parameters set to English by using “LANGID(ENU) CNTRYID(US) CCSID(00037)”.

      • For IBM i machines that do not use English as the primary language and that only have non-English language libraries, use a subsystem that has a Subsystem library attribute (SYSLIBLE) set to the English library “QSYS2924” to run Commvault jobs. For more information about how to enable the secondary language for a subsystem, see IBM documentation.

      • You cannot use the following system user profiles: "QDBSHR", "QDOC", "QLPAUTO", "QLPINSTALL", "QRJE", "QSECOFR", "QSPL", "QDFTOWN", "QTSTRQS", "QSYS".

   6. In the Subsystem Description box, type the IBM i subsystem description of the active subsystem name where the Commvault services run. Use the following format:

      “<Library_Name>/<Subsystem_Description>”.

      For example, if you specify “QSYS/QCTL”, then the software runs the Commvault services, backup and restore jobs, under the QCTL subsystem.

      Note

      For IBM i machines that do not use English as the primary language and that only have non-English language libraries, use a subsystem that has a Subsystem library attribute (SYSLIBLE) set to the English library “QSYS2924” to run Commvault jobs. For more information about how to enable the secondary language for a subsystem, see IBM documentation.

   7. In the Job queue box, type the Job queue name in the following format: “<Library>/<JOBQ_object>”

      The job queue must be connected to the subsystem that you specified in the Subsystem Description box. If the job queue is not connected, then select the Create job queue check box. When you select this check box, the software creates creates a separate job queue under the Commvault CVLIBOBJ library and connects to the specified subsystem.

   8. To have the software create a separate job queue under the Commvault CVLIBOBJ library and connect to the specified subsystem, select the Create job queue check box.

      Example

      If the Subsystem Description is “QSYS/QCTL” and you select the Create job queue check box, then the default value for the job queue is “CVLIBOBJ/QCTL”

   9. In the Job Priority box, type or select the job priority of the Commvault jobs that run on the IBM i client. The valid values are 1-9, where 1 is the highest priority. The default value is 5.

   10. In the Run Priority box, type or select the job run priority of the Commvault jobs that run on the IBM i client. The valid values are 1-99, where 1 is the highest priority. The default value is 50.

3. On the Proxy Client tab, select the proxy clients for the IBM i File System Agent client.

   1. From the Available Proxy Nodes list, select the access node name or client group name where you installed the IBM i File System Agent.

   2. Click Add.

      The access node name or client group name appears in the Selected Proxy Nodes list.

      Note

      • Linux clients and client groups that have IBM i File System Agent installed are displayed in the Available Proxy Nodes list. You can select one or more clients or client groups. The proxies are selected for performing a backup operation based on the order of the Selected Proxy Nodes list.

      • When you select a client group, ensure that at least one client in the group has the IBM i File System Agent installed. Otherwise, the backup job will go to a pending state.

      • If an access node fails during a backup job and the backup job goes to a pending state, when the job is resumed, that access node will be selected for the job automatically. If that access node fails, the next access node is selected based on the order of the Selected Proxy Nodes list. On resuming the backup job, the proxy selection always starts from the first access node in the Selected Proxy Nodes list.

      • All the access nodes in the Selected Proxy Nodes list must be at the same Service Pack level.

4. Click OK.

Results

After you create the IBM i client, the Commvault package is automatically installed during the next backup or browse if the SSH services are active on IBM i client machine and the proxy, and if the SSH connectivity between the proxy and the IBM i client machine exists.

Automatic installation on the IBM i client performs following tasks.

• Starts SSH sessions from the proxy to the IBM i client to copy CVINSTPKG.savf.

• Extracts the required objects, and executes the installation command.

• Creates the CVLIB and CVLIBOBJ program libraries when they do not exist.

• Copies the required files into the CVLIB program library.

• Creates the class object, job description, and job queue when the option to create the job queue is selected.

• Copies the configuration files to the data directory.

• Prepares the data directory.

• Changes the subsystem description by adding the new routing entry and attaches the job queue, when the option to create the job queue is selected.

• Starts the Commvault services in the specified subsystem.

• Sets the ownership for library, directories, and files to the specified user profile.

• Deletes the Commvault temporary files and temporary libraries.

If the SSHD server is not installed on the IBM i client, then you must manually install the CVINSTPKG on the IBM i client. For more information, see Installing the CVINSTPKG.savf Installation Package on the IBM i Client.