Documentation PDF

PROTECT. ACCESS. COMPLY. SHARE

IBM i
The File Servers application in the Command Center provides a simple web-based user interface for administration tasks, providing streamlined backup
and recovery for file system data on IBM i clients by using an access node.
To get started, configure clients, backup sets, and subclients.
Schedule backups, or run them as needed.
Restore to the same host or to a new host in the case of a disaster.
The Command Center provides summary information about the file system jobs.

Key Features
The table provides an overview of the file system supported features.

10/25/2023 Commvault Systems Page 2 of 31

Feature Support
Content
Files Yes
You can use wildcards to filter the backup
content.
Folders Yes
You can use wildcards to filter the backup
content.
Pre-process and post-process commands
Pre-backup process Yes
Post-backup process Yes
Backup Schedules
Immediate Yes
Schedules Yes
You can have more than one schedule for each
subclient.
Backup Types
Full Yes
Incremental Yes
Synthetic Full
Restore Destinations
Destination client is where you performed the backup operation Yes
Destination client is different from where you performed the Yes
backup operation
Restore to original folder Yes
Restore to a new folder Yes
Restore Contents
All file and folders in the backup Yes
File or folder subset Yes
Restore Options
Overwrite if it (the data) already exists Yes

10/25/2023 Commvault Systems Page 3 of 31

Getting Started with IBM i File System
Review each of the topics to get started with IBM i file system. Some of the steps require administrative knowledge of IBM i and must be implemented by
or with assistance from an IBM i expert.

Step 1: Review Requirements

Review the following requirements:
IBM i
System Requirements
License Requirements
IBM i VTL
System Requirements
License Requirements

Step 2: Install the Commvault Package

If your backup administrator has not already installed the Commvault package, then you must install it.
For more information, see Installing the Commvault Package .

Step 3: Obtain Your User Credentials Information

Obtain the following information from your backup administrator:
The Command Center URL
Your Command Center user credentials

Step 4: Log on to the Command Center

Access the Command Center by using the URL that was displayed on the installation completion page, or that you received from your backup
administrator.

Step 5: Complete the Core Setup Wizard

Configure core information by completing the Core Setup Wizard .

Step 6: Complete the IBM i File Server Application Setup Wizard

Configure the IBM i file server application by completing the Setup Wizard for the IBM i Application .

Step 7: To Configure IBM i VTL, Install VTL on the Linux Access Node
Install VTL on the Linux access node.
For more information, see Installing VTL on the Linux Access Node .

Step 8: Prepare for Your First Backup and Restore

1. Create a backup set .
2. Create a subclient .
3. Determine the alerts that you want the software to trigger.
For information on how to configure alerts, see Creating an Alert Definition .

Step 9: Perform Your First Backup and Restore

1. Perform a backup .
2. Perform a restore .

10/25/2023 Commvault Systems Page 4 of 31

System Requirements - IBM i File System Agent
The following are the requirements for the IBM i File System Agent:

Operating System Architecture

IBM i IBM i 7.4 Power PC
IBM i 7.3 Power PC
IBM i 7.2 Power PC
IBM i 7.1 Power PC
IBM i 6.1 Power PC

Hard Drive
150 MB of minimum disk space is required for installing the software.
400 MB of minimum free disk space is required for job result and log directory.

Miscellaneous
Network
TCP/IP services configured on the IBM i computer.
IPv6 is not supported.
The QSYSWRK subsystem must be active on the IBM i computer.
The SSHD services must be active between the IBM i computer and the access node for automatic package installation.

Operating System Language

For IBM i machines that do not have English as the primary language, English must be installed as a secondary language.
Must have a user profile with English language setting on the IBM i machine set to non-English as the primary language.

Firewall
If you use TCP/IP communication between the access node and the IBM i clients, then the following requirements apply:
The firewall configuration on the access node must include settings to accept a communication request from a client that uses the selected TCP/IP
port range. For information on how to set the ports, see Controlling the Ports for IBM i or OpenVMS File System Clients .
The firewall configuration on the client must include settings to accept a communication from an access node computer that uses port 9401 (or
the TCP/IP port number configured that is configured for the access node).
The firewall configuration on the access node must include the range of bidirectional ports to transfer data between the IBM i client and the access
node, along with the communication port.
The firewall configuration on the access node and the client must not restrict communication on established connections in both directions. For
information on how to configure a firewall between the client and the access node, see Firewall: Overview .

PTF Level
We recommend that you have the latest PTFs installed on the IBM i File System client. Go to the IBM Support Fix Central website for the latest PTFs that
are available for your operating system.
DISCLAIMER
Third-party maintenance (minor) releases or service packs that are supported by the Commvault software may not be listed in our System Requirements. When possible, Commvault
provides information on any known issues related to these minor releases or service packs. In some cases, these minor releases or service packs affect how the Commvault software works.
Commvault software may experience changes in functionality as the result of the third-party minor release or service pack. These changes are beyond the control of Commvault. Platforms
that are supported in the current version of Commvault software may not be supported in earlier versions of the software. Contact your software provider to ensure that third-party minor
releases or service packs are compatible with the Commvault software.
Additional considerations regarding minimum requirements and End-of-Life policies from third-party vendors also apply.

10/25/2023 Commvault Systems Page 5 of 31

System Requirements
The following are the requirements for the IBM i File System Agent with Commvault VTL:

Operating System Operating System Version Architecture

Client Operating System
IBM i IBM i 7.4 Modification 0 Power PC
IBM i 7.3 Modification 0 Power PC
IBM i 7.2 Power PC
IBM i 7.1 Power PC
IBM i 6.1 Power PC
VTL Access Node Operating System
Linux Red Hat Enterprise Linux/CentOS x64 or compatible processors
Red Hat Enterprise Linux/CentOS 7.2 with glibc 2.17.x x64 or compatible processors

Memory
16 GB minimum of memory is required

Hard Drive
1 GB of minimum disk space is required for installing the software.
To calculate the disk space requirements for the job results directory, see Job Results Directory Disk Space Calculation .
500 MB of free disk space is required for the log directory
1 TB or more disk volume for ContentStore NFS cache

Supported Firmware Versions of SCSI/HBA/FC Card

The following firmware versions of QLogic HBAs are supported:
QLE2562 FW:v7.03.00 DVR:v8.04.00.05.2.2-SCST.03-k-p
QLE2560 FW:v8.06.00 DVR:v8.04.00.05.2.2-SCST.03-k-p
QLE2560 FW:v8.07.00 DVR:v8.04.00.05.2.2-SCST.03-k-p
QLE2460 FW:v8.07.00 DVR:v8.04.00.05.2.2-SCST.03-k-p
QLE2562 FW:v8.07.00 DVR:v8.04.00.05.2.2-SCST.03-k-p

Note: The FC network zoning configuration is required to allow access to the VTL Server FC Target from IBM i servers.

DISCLAIMER
Third-party maintenance (minor) releases or service packs that are supported by the Commvault software may not be listed in our System Requirements. When possible, Commvault
provides information on any known issues related to these minor releases or service packs. In some cases, these minor releases or service packs affect how the Commvault software works.
Commvault software may experience changes in functionality as the result of the third-party minor release or service pack. These changes are beyond the control of Commvault. Platforms
that are supported in the current version of Commvault software may not be supported in earlier versions of the software. Contact your software provider to ensure that third-party minor
releases or service packs are compatible with the Commvault software.
Additional considerations regarding minimum requirements and End-of-Life policies from third-party vendors also apply.

10/25/2023 Commvault Systems Page 6 of 31

License Requirements - IBM i File System Agent
For information about licensing, see the Commvault Licensing Program Guide .

10/25/2023 Commvault Systems Page 7 of 31

Setup Wizard for the IBM i Application
When you log on to the Command Center for the first time, a setup wizard guides you through the core setup required by the applications available in
the Command Center. After you complete the core setup, complete the setup wizard specific to the Servers application.
To complete the setup wizard for an IBM i server, you must first set up at least one Linux server as an access node. When selecting the packages to install,
you must include the File System for IBM i package. You will need the following server information for the IBM i server:
The server name
The host name
The data folder for the Commvault software
The CVD port that the access node CVD will use to talk to the IBM i server. (Note that this is different than the port used between the access node
CVD and the CommServe computer.)
The credentials that you use to access the server
The Linux server that you created as the access node

Package Installation on the IBM i Client

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 access node, and if the SSH connectivity between the access node and the IBM i client machine exists.
Automatic installation on the IBM i client performs following tasks.
Starts SSH sessions from the access node 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 follow the manual steps to install the CVINSTPKG on the IBM i client. For more information, see
Installing the CVINSTPKG.savf Installation Package .
After the Commvault package is installed on the IBM i client, all updates that are installed on the access node are automatically pushed to all of the
connected IBM i clients during the first communication session between the access node and the IBM i client.

10/25/2023 Commvault Systems Page 8 of 31

Installing VTL on the Linux Access Node
To use an IBM i VTL plan for backups, install VTL on the Linux access node.

Before You Begin

Prior to installing VTL for the IBM i File System Agent on the Linux access node, you must configure the following components:
Index Server Cloud for Hybrid File Store
Configure the Index Server Cloud .

Note: Add the NFS Index role while creating the Index Server Cloud.

Install the following Commvault packages on the Linux access node:

MediaAgent
File System
IBM i File System
Developer SDK – Python
Configuring the Hybrid File Store Cache
Storage Policy
Create a storage policy for your ObjectStore. This storage policy will be the main storage for your IBM i data. You can create an additional
copy of this data for redundancy.
MediaAgent with NFS Index capability

Procedure
1. On the Linux access node, change the directory to the Commvault Base folder:
[root@glass /root]# cd /opt/Commvault/Base
2. Start the installation script with the following command:
[root@glass Base]# ./cvibmivtl_setup

Note:
If there is no Internet access, you must download the cv_vtl.tgz package and the NFS-Ganesha package from the Download Center.

For instructions about installing the NFS-Ganesha package, see Getting Started with Hybrid File Store .

Use the option -f cv_vtl.tgz to install the VTL binaries.

Commvault services are stopped during the installation. Verify that there are no running jobs that use this server.

This command will verify that Ganesha and all required RPM packages are installed. If any of the RPM packages are missing, this command will
attempt to install them. In case the command failed to install any of the missing dependencies, the installation may abort and you will be required
to install those missing dependencies or provide a location where those RPM files are located.
The installation requires a kernel development package be present on the system, and the version of the running kernel and kernel development
package must be the same. The required package can be found on the OS installation DVD or on the Internet.
If you have the DVD with RPM for your kernel, add -r option with a path to the RPM location. For example:
[root@glass Base]# mount -o ro /dev/cdrom /media
[root@glass Base]# ./cvibmivtl_setup -r /media/Packages
One or more options [-r path] can be used as a search path for additional RPMs when required (for example, a DVD folder with RPM modules). This
option also can be used when there is no direct connection to the Internet, and required packages are downloaded manually.
The installation script will collect configuration information. The following information will be collected from the user:
Commvault login name and password (this user must be capable to create ObjectStore client)
Number of tape drives you want to have in the VTL
Number of tape slots in the VTL
10/25/2023 Commvault Systems Page 9 of 31
 Size of the tapes. The size must be 16 GB or larger per tape.
The number of tapes to add. The maximum number of tapes is limited by a number of slots.
The 2 symbol barcode prefix, which consists of any combination of characters 0-9 and A-Z.
The client name for the Hybrid File Store. This is the client against which the actual data from all tapes will be stored.
The storage policy name for Hybrid File Store client. Storage policy where data from all tapes will be stored.
The MediaAgent name where Index Server is configured with NFS Index capabilities.
Local path for the Disk Library.
Once all information is collected, the command will download, compile and install the SCST driver on the acess node, configure and install the VTL
package, create the Hybrid File Store client, and then add the VTL Library to storage resources.
A tape storage with the following naming format is created:
access_node_host_name-IBMVTL
An IBM i VTL plan with the following naming format is created:
access_node_host_name-Plan
3. If FC network zoning is not configured, configure FC network zoning to allow access to the VTL Server FC Target from IBM i servers.

Results
The VTL tape storage appears in the Tape page. (From the navigation pane, go to Storage >Tape.)

10/25/2023 Commvault Systems Page 10 of 31

Backup Plan for IBM i VTL
To perform backups, you need to assign a new or existing plan to the subclient. The plan identifies a library that stores backup data.
You can create an IBM i VTL plan only when the CommCell environment has at least one VTL storage configured.
You can use the IBM i VTL plan for IBM i servers only.

10/25/2023 Commvault Systems Page 11 of 31

IBM i File System Configuration
File servers
The File servers page displays the following information:
The file server name
The last backup time
The application size
The plan
The SLA status
You can perform the following operations on the active server details page:
Adding an Additional Server .
Add a gateway .
View the server job history .
Add additional Commvault software to the server .
Update the software .
Retiring a Server .

Subclients
Subclients contain the specific data that you want to protect. You can map drives to subclients.
Create subclients when you have data that needs different RPOs (recovery point objectives) or retention times.
The subclient details page displays the following information:
The latest backup information
The date and time of the next backup
The data storage policy
The content that is included in the subclient
Add or edit pre-process and post-process command batch files.
The security that is associated with the subclient
The following operations are available on the subclient details page:
Change the plan.
Delete a subclient. In the upper-right of the page, click Delete.
Note: You cannot delete the default subclient.
Perform a backup .
Change the subclient content.
View the subclient job history. For information on the job history, see Jobs .
To view the backup history, in the upper-right of the page, click Backup History.
To view the restore history, in the upper-right of the page, click Restore History.

10/25/2023 Commvault Systems Page 12 of 31

Adding an Additional IBM i Server
You can add an additional IBM i server to your Commvault solution to replace an existing server or to help reduce the load on existing servers.

Procedure
1. From the navigation pane, go to Protect > File Servers.
The File Servers page appears.
2. In the upper-right of the page, from the Add server list, select Add IBM i server.
The Add IBM i server dialog box appears.
3. In the Server name box, type the server name.
4. In the Host name box, type the host name.
5. In the Commvault data path box, type the location for data files.
6. 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. Use a value of 0 to indicate that it is the default port number.

7. Optional: From the Plan list, select the plan that the software uses to protect the data.

Note: To use a VTL library for data storage, select an IBM i VTL plan.

8. To set the IBM i user credentials, in the IBM i user credentials area, complete the following steps:
1. In the User name and Password boxes, type the credentials for the IBM i server.

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".
2. From the Access node client list, select the access node name or client group name on which the File System Agent was installed.
9. 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 the IBM documentation.

10. 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.
11. 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.
10/25/2023 Commvault Systems Page 13 of 31
 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”
12. 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.
13. 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.
14. Click Save.

Result
The software creates the additional IBM i server.

10/25/2023 Commvault Systems Page 14 of 31

Managing IBM i File System Backup Sets
When you create a new IBM i file system client, a default backup set is created automatically with 7 pre-defined subclients, which manage backup and
restore operations for the client.
You can create additional backup sets to provide a separate administration point for a specific group of subclients.

Procedure
1. From the navigation pane, go to Protect > File Servers > IBM_i_Server.
The IBM i server properties page appears.
2. In the upper-right of the page, click the action button , and then click Add backup set.

The Create new backup set dialog box appears.

3. In the Backup set name box, type the backup set name.
4. From the Plan list, select the plan that the software uses to protect the data.

Note: To use a VTL library for data storage, select an IBM i VTL plan.

5. To make the backup set the default, select the Make this the default backupset check box.
6. Click OK.

Result
The software creates the backup set.

What to Do Next
Create subclients for the data that you want to protect.

10/25/2023 Commvault Systems Page 15 of 31

Managing IBM i File System Subclients
Subclients contain information about what data is backed up. You can create a user-defined subclient to manage and back up specific data files.
Subclients can contain a combination of files and directories.
You can use wildcards to define the subclient content, exclusions, and exceptions.
For more information on the supported IBM i wildcards, see Supported Wildcards for IBM i File System s.
You can create subclients for specific folders and files that frequently change or have a different backup schedule.

About This Task

The following subclient content options are available:
Commvault pre-defined content that consists of one or more of the following data:
Security objects
Configuration objects
IBM system libraries
User libraries
Documents, folders, and distribution objects
IBM directories and the user objects that are contained in the directories
User-defined content is a set of folders and directories that you define.

Before You Begin

1. If you do not want to use the default backup set, create a backup set .
2. Make sure that you have the following information:
The plan to assign to the subclient

Note: You can only assign a plan to a subclient when it is the only subclient in the backup set.

Plans contain information about how often the software backs up the data and the storage library.
For more information, see Plans .

Procedure
1. From the navigation pane, go to Protect > File Servers.
The File Servers page appears.
2. Click the IBM_i_server.
The IBM_i_server page appears.
3. Under Subclients, on the right of the page, click Add subclient.
The Add subclient dialog box appears.
4. In the Subclient name box, type the subclient name.
5. In the Save while active section, complete the following steps:
1. To determine whether a user can update an object while the object is being saved, in the Save while active box, select one of the following
options:

10/25/2023 Commvault Systems Page 16 of 31

 If you Then
selected
*NO Select this option when you do not want to save the objects that are in use.
*LIB Select this option when you need to save the objects in a library while they are used by another
job. All of the objects reach a checkpoint at the same time and are saved in a consistent state in
relationship to each other.
*SYNCLIB This option is only available when you have custom subclient content that contains libraries.
Select this option when you want to have all the objects and libraries that are part of the save
operation reach a checkpoint together and be saved in a consistent state in relationship to each
other.
When you select this option, the software makes the Backup library content(s) as objects check
box unavailable.
Note: You cannot specify more than 32 libraries.
When you synchronize a backup, the software:
Starts the synchronization by using the "STRSAVSYNC" command
Sends messages that are related to synchronization to the message queue (when this is
selected)
Runs a command after the synchronization completes (when this option is specified)
Saves the objects and libraries that are part of the save operation when they reach a
checkpoint together in a consistent state
*SYSDFN Select this option when you need to save the objects in a library while they are in use by
another job. Objects in a library may reach checkpoints at different times and may not be in a
consistent state in relationship to each other.

2. To set the time that the backup operation waits for an object that is in use, or for transactions that have a pending change to reach a
commit boundary before it continues the save operation, in the Save active wait time (seconds) box, type the number of seconds.

If you selected Then

*LIB or *SYSDFN Valid values: 0-99999
*SYNCLIB Valid values: 0-99999
The default is 600 seconds.

3. Optional: To specify the message queue that the save operation uses to notify the user that the checkpoint process for a library is
complete, in the Synchronization queue box, type the message queue.
The format must be "<Library_Name>/Message_Queue>" (for example, QGPL/SYNCQ).
4. Optional: To specify the command path that the software runs when the libraries that are in the subclient content reach the synchronized
checkpoint, in the Command to be run when libraries are synchronized box, enter the command path.
For example, "/QSYS.LIB/QGPL.LIB/SYNC.CMD".
6. In the Backup Configuration section, perform one of the following steps to determine the plan or policies to use for the backup operations:
To use a server plan, enable the Use backup plan slider, and then select a server plan.

Note: To use a VTL library for data storage, select an IBM i VTL plan.

To use a storage policy and a schedule policy, disable the Use backup plan slider, select a storage policy and a schedule policy.
7. In the Backup process settings section, enter the following information:
Pre-backup process: Enter the path to the batch file.
For example, /QRCA.LIB/PREBACKUP.PGM.
Post-backup process: Enter the path to the batch file.
For example, /QRCA.LIB/POSTBACKUP.PGM.
10/25/2023 Commvault Systems Page 17 of 31
 For more information about pre-processes and post-processes, see Example: Creating a Pre- or Post-Process Script .
8. Click Save.

Result
The software adds the subclient and you can perform backup and restore operations on the subclient. If you assigned a plan to the subclient, the
following operations happen:
The software automatically backs up the subclient according to the schedule plans
The software assigns the plan to the subclient's backup set

10/25/2023 Commvault Systems Page 18 of 31

Managing IBM i File System 1-Touch Disaster Recovery Subclients
A disaster recovery subclient is created automatically under the default backup set when an IBM i client is created. You can manage the DR subclient and
run backups on it so that you are prepared for a disaster recovery.

Procedure
1. From the navigation pane, click Protect > File Servers > IBM_i_server.
The IBM i server details page appears.
2. Under Subclients, click DR subclient.
The DR Subclient page appears.
3. In the General section, click Edit, and then select a plan.

Note: A schedule is not inherited from the plan for a DR subclient.

4. In the Disaster recovery configuration section, click Edit, and then complete the following steps:
1. In the Abort DR backup if running longer than (minutes) box, type the time threshold in minutes that the DR backup job can run.
This is the maximum time that the IBM i client computer can be kept in a restricted state.

Note: When this time period expires, the software aborts the job and starts all of the subsystems. When you set this value, add the
following time durations together to get the proper value:
The maximum time that the IBM i client computer can be kept in a restricted state.
If specified, the maximum time that a restricted state program takes to notify users that the system will be suspended.

2. To notify users, move the Notify users toggle key to the right, and then complete the following steps:
1. In the Delay (min) before switch to restricted mode box, select the number of minutes.
2. In the Notification message box, type the message that the software sends to the users.

Note: Use the ## parameter in the message string to indicate the time in minutes.

3. In the DVD Image file format box, type the format of the DVD image name.
4. In the Temporary directory for virtual DVD images box, type the full path that is located on the IFS file system where the software can
create the DVD catalog image.
5. In the Command to bring the system into restricted state box, type the command that the software uses to set the IBM i LPAR to a
restricted state.
6. In the Program to execute while system is in restricted state box, type the full path to the program the software runs after the DVD
catalog images are created and before the system returns from the suspended state.

Note: If you selected the option to have the IPL performed later, and you specify this parameter, then the restricted state program runs
after the backup completes and before the software performs the IPL.

7. In the Run custom startup program box, type the full path to the program that starts the subsystems.

Note: Leave this field blank to use the startup program that is specified in the IBM i client’s system value QSTRUPPGM to start the
subsystems and services. If you specify any custom startup program, then the subsystems and services start according to the specified
program. If you selected the option to perform the IPL after the backup, then the system value QSTRUPPGM is updated with the custom
startup program.

8. To create the single DVD image file, move the Create single DVD file toggle key to the right.
If you do not enable this option, the DVD images will be crated with a standard size of 4.7 GB.
9. Click Save.

10/25/2023 Commvault Systems Page 19 of 31

Supported Wildcards for IBM i File System
You can use a wildcard to represent one or more characters when you define the content for backups and filters for a subclient.

Note: If the subclient content consists of wildcard characters and no eligible files are found for the backup, the backup operation can still successfully
complete.

Wildcards Description Examples

* Any number of characters.
Use this wildcard in the following
scenarios
Back up all files of a specific
extension
Back up all files under a
specific directory
Back up all files with a specific
file extension that start with
the pattern
? A single character.
Use this wildcard in the following
scenario:
All files (or directories) that
match the character pattern
before and after the ?
*.doc backs up or filters all files that have a .doc file extension (for
example, status.doc, mission.doc) on all partitions and paths on the
client computer.
/Test/*.doc backs up all that have a .doc file extension in the /Test
directory.
a*.so backs up all files that have the .so file extension, and start with
the letter "a" (for example, alsvc.so, advdcc.so).
/Finance/Test* backs up all the files and directories that start with the
string "Test" under the /Finance directory.
/access? backs up or filters any directory or file that starts with the
string "access", followed by one character (for example, access1 or
access5).
/Class/report? backs up any directory or file under the /Class
directory that starts with the string "report" and contains one
character after the string (for example, "report1").


Tip: To match multiple characters,
use a ? for each character that
you want to match.

Applies only to the subclient

content for IFS type.
Does not apply to Optimized
scan.
Does not apply to filters and
exceptions.
[] A range of characters. /[a-m]* backs up or filters all files that start with the letters a-m on
the / (root) partition.
Applies only to the subclient
content for IFS type. /[AEIOU]*.doc backs up files that have a .doc file extension and that
start with the letters "A", "E", "I", "O", or "U".
Does not apply to Optimized
scan. /Finance/report[1-47-9] backs up the following files in the /Finance
directory:
Does not apply to filters and
exceptions. report1
report2
report4
report7
report8
report9
/Department-[A-CS] backs up the following files:
Department-A
Department-B
10/25/2023 Commvault Systems Page 20 of 31
 Department-C
Department-S
[!] The negation of a set or range of /root/[!AEIOU]*.doc backs up or filters files that have a .doc file
characters. extension in the /root directory and that start with a letter other
than the letters "A", "E", "I", "O", or "U".
Use the wildcard in the following
scenario:
Back up all files in a directory
that do not match the
characters specified in the
wildcard
Applies only to the
subclient content for IFS
type.
Does not apply to
Optimized scan.
Does not apply to filters
and exceptions.
** Any number of characters across /**/move.cpp - backs up or filters the file named move.cpp that is in
any number of path levels. any directory. (for example, /root/newapp/move.cpp and
/opt/kde3/src/move.cpp)
Applies only to the subclient
content for IFS type. /etc/** - backs up all directories and files under the /etc directory.
All sub-directories are included in the backup.
Does not apply to Optimized
scan.
Does not apply to filters and
exceptions.
*** Applies only to filters and The filter /test/mydir/*** filters the mydir directory and its contents.
exceptions.
The filter /test/*** and the exception /test/mydir/*** backs up the mydir
Use this wildcard in the following directory and all the contents of that directory.
scenarios:
To filter the directory/library
and the objects that are under
it.
To add an exception to the
filter.
Does not apply to Optimized
scan.

10/25/2023 Commvault Systems Page 21 of 31

IBM i File System Backups
Back up data that resides on your IBM i computer.
You can run backups immediately or configure a plan that includes a schedule.

Full Backup
Backups for any client start with a full backup. For Agents that support non-full backups, the full backup becomes a baseline to which subsequent backup
types are applied. For example, if an agent supports incremental backups, a full backup must be performed before an incremental backup can be
initiated.

Incremental Backup
An incremental backup contains only data that is new or has changed since the last backup, regardless of the type. On average, incremental backups use
less media and place less of a burden on resources than full backups.

10/25/2023 Commvault Systems Page 22 of 31

Performing IBM i File System Backups
Back up your IBM i file system data.

Procedure
1. From the navigation pane, go to Protect > File Servers.
The File Servers page appears.
2. Click the IBM_i_server.
The IBM_i_server page appears.
3. Under Subclients, in the Actions column for the subclient, click the action button , and then click Back up.

The Select backup level dialog box appears.

4. For Backup level, select the backup type.
5. Click OK.
The Backup options dialog box appears.
6. Optional: View the job details. Click the job ID.
7. Click OK.

What to Do Next
You can control or view the job. For more information, see Jobs .

10/25/2023 Commvault Systems Page 23 of 31

Performing IBM i File System DR Backups
Back up your IBM i file system data for disaster recovery.
For optimal DR backup size, do not create or include the following under QGPL, QSYS2, and QUSRSYS libraries:
Applied PTFs
Compiled programs
Image catalog
Journal or Journal receivers
OS related image catalog files
SAVF files
Spool output files
Adding these files and programs leads to additional DVD images.

Caution: Do not create any library starting with the letter 'Q'.

Procedure
1. From the navigation pane, go to Protect > File Servers.
The File Servers page appears.
2. Click the IBM_i_server.
The IBM_i_server page appears.
3. Under Subclients, in the Actions column for the subclient, click the action button , and then click Back up.

The Select DR backup level dialog box appears.

4. Select the DR backup type:
1. To resume the computer after the operation system is captured, click Resume (*STSSBS).
2. To use the reboot option, click Reboot (*IPL).
1. To leave the computer in restricted state after the DR backup operation and initial program load (IPL) complete, select the Leave
the system in restricted state check box.
5. Click OK.

Result
After the backup succeeds, the following data is backed up in the format of bootable optical volumes:
SAVSYS
LIC - License internal code.
OS/400 Objects in QSYS
SAVSECDTA
User profiles
Private authorities
SAVCFG (configuration objects)
*IBM Libraries (system libraries)
System libraries with user data: QSYS2, QGPL, QUSRSYS
Commvault Libraries: CVLIB, CVLIBOBJ
System files and Commvault files with logs
/QIBM/ProdData
/QOpenSys/QIBM/ProdData

10/25/2023 Commvault Systems Page 24 of 31

IBM i File System Restores
You can browse and restore backed up data for your subclient or an entire backup set.
Consider the following options before you perform a restore:
The data that you want to restore
The restore destination computer
The restore destination directory

10/25/2023 Commvault Systems Page 25 of 31

Performing IBM i File System Restores
Restore your backed up data to the original location on the same computer or to a new location on the same computer or a different computer.

Before You Begin

Perform a backup .

Procedure
1. From the navigation pane, go to Protect > File Servers.
The File Servers page appears.
2. Click the IBM_i_server.
The IBM_i_server page appears.
3. Under Subclients, in the Actions column for the subclient, click the action button , and then click Restore.

The Backup content page appears.

4. Choose the content that you want to restore.
To restore the contents of the entire backup set, select the check box next to Name.
To restore the contents of a subclient, select the appropriate subclient. You can select multiple subclients at the same time.
To restore particular files, expand the folder and then select the files.
5. Click Restore.
The Restore options dialog box appears.
6. From the Destination client list, choose the destination server for the restore.
7. Choose the restore location.
To restore to the original backup location, select the Restore to original folder check box.
To restore to a new location, clear the Restore to original folder check box, and then in the Destination path box, type the full path to the
destination folder.
8. To overwrite the existing data, select the Unconditionally overwrite if it already exists check box.
9. To use a saved user credentials to access the file system, enable the Impersonate user slider, and then select the credential to use.
10. Click Submit.

What to Do Next
You can control or view the job. For more information, see Jobs .

10/25/2023 Commvault Systems Page 26 of 31

Performing an IBM i 1-Touch Disaster Recovery Operation
You can recover to the same system or duplicate the system.

Note: If you duplicate the system, to avoid network issues on the source system, verify that the TCP/IP configuration is updated.

The operation creates a job that copies the DVD images and restores the data.
The software starts the DVD copy job (the status shows running) and places the restore job in a suspended state.
When the DVD copy job completes, the software sends an email notification. Use the DVD images to restore the minimum OS by following the IBM
manual, and then restore the Commvault libraries.

Note: The Virtual Image files created during the DR process are in UDF format. You can use any software to burn the physical DVD media that
supports UDF image format. The typical number of DVDs is between 5 to 7. The actual number depends on your system size.

After you restore the operating system and network, go to the CommCell Console and resume the suspended job.
For more information about restoring to a new client, see Adding an Additional IBM i Server .

Before You Begin

Verify and update the TCP/IP configuration.

Note: If the TCP/IP configuration changes, you must stop and restart the Commvault services.

Verify that the IASPs are properly configured.

Procedure
1. From the navigation pane, click Protect > Servers > IBM_i_Server.
2. In the upper-right, click Disaster Recovery.
The Disaster Recovery page appears.
3. From the Destination client list, choose the destination IBM i server for the restore.
4. From the User data backupset list, choose the backup set (for user data) of the source IBM i server.
5. From the DR backup job to recover list, choose a DR backup performed on the source IBM i server.
6. From the Client to restore DVD images list, choose the file system server to restore the DVD images.
The file system client computer can be a Linux access node, IHOST, or VIOS.
7. In the Destination path to store DVD images box, enter the path for storing the DVD images.

Note: The client computer must have enough disk space to store the DVDs that the software creates as part of the recovery operation. If there
is not enough disk space, then the job aborts and the DVDs become invalid.

8. In the Copy precedence for restore jobs list, enter the number of the copy that you want to restore.
To pick the primary copy, enter 0.
9. To write the list of objects restored to an output file, enter the path to the physical file object.
For example, library_name/physical_file_name.
10. To restore the spooled data file, select the Restore SPLFTDA check box.
11. Click Submit.

What to Do Next
You can control or view the job. For more information, see Jobs .
For more information about performing a 1-Touch disaster recovery operation, see IBM i File System Agent 1-Touch Disaster Recovery
Procedures .
10/25/2023 Commvault Systems Page 27 of 31
Trademark Acknowledgment
Commvault, Commvault and logo, the "CV" logo, Commvault Systems, Solving Forward, SIM, Singular Information Management, Simpana, Commvault
Galaxy, Unified Data Management, QiNetix, Quick Recovery, QR, CommNet, GridStor, Vault Tracker, InnerVault, Quick Snap, QSnap, IntelliSnap, Recovery
Director, CommServe, CommCell, ROMS, Commvault Edge, Simpana OnePass, and CommValue are trademarks or registered trademarks of Commvault
Systems, Inc. All other third party brands, products, service names, trademarks, or registered service marks are the property of and used to identify the
products or services of their respective owners. All specifications are subject to change without notice.

Products in Germany are not distributed using the "QNet" brand.

For more information about Commvault® software modules and solutions, and for up-to-date system requirements, please contact us:
www.commvault.com • 888.746.3849 • get-info@commvault.com
Commvault Worldwide Headquarters

1 Commvault Way • Tinton Falls, NJ 07724 • Phone: 888.746.3849 • Fax: 732.870.4525

Commvault Regional Offices

United States • Europe • Middle East & Africa • Asia-Pacific • Latin America & Caribbean Canada • India • Oceania

10/25/2023 Commvault Systems Page 28 of 31

10/25/2023 Commvault Systems Page 29 of 31