For the Oracle, Oracle RAC or SAP for Oracle iDataAgent,
if you have custom SQL settings, you must turn off these settings to
ensure that the instance browse works correctly and that the instance status is
correctly fetched. To do this, create and edit the
cvlogin.sql file with the appropriate contents at
ORACLE_HOME/sqlplus/admin. For example, run the
following command:
edit file $ORACLE_HOME/sqlplus/admin/cvlogin.sql
Then include the following contents in the
cvlogin.sql file:
To create an instance, from the CommCell Browser, locate the correct client computer node, and right-click the agent node for which you want
the new instance created, click All Tasks, and then click New Instancefrom the
shortcut menu.
To modify an existing instance, from the CommCell Browser, right-click the instance you want to modify, and then click
Properties from the shortcut menu.
From the General
tab, enter the name (up to 32
characters) for the instance. In addition, provide the required access information for
this instance.
For various iDataAgents,
you can add/modify an application/database user account. See the appropriate section as follows in
User Accounts and Passwords for more information:
If your agent uses the Details
tab,
enter the required database connect string and other optional parameters.
For the Oracle, Oracle RAC and SAP for Oracle iDataAgents, see
the
Oracle iDataAgents section in
User Accounts and Passwords for more information.
From the
Storage Device
tab, select storage policy copies to be used for, as applicable, data
backups, command line data backups and log backups. Within these tabs
you can click Data
Paths to display the details of the data paths associated with the
primary storage policy copy of the selected storage policy.
If your agent uses the
Software
Compression tab, and you want to enable software compression for the
selected
backups, click the tab and select the option appropriate to your environment.
If you want to enable data encryption, from the
Encryption
tab
select encryption settings for third-party or RMAN command line backups.
Click OK to save the instance.
A message advises you to schedule backups for your new instance. It is
recommended you elect to set a schedule now. You can also associate this
instance with an All Agent Types schedule policy (which is automatically
created by the system, or can be a user defined Data Protection schedule
policy). If you have already associated a schedule policy at a previous
level (Agent, Client, or Client Computer Group) the schedules defined in the
Schedule Policy will be automatically applied to the new instance. See
Schedule Policy for
more information.
For agents that offer an OK
option, click OK to acknowledge the message. This procedure is now
complete.
For agents that offer Yes and No options to this
message, click No if you don't want to create a backup schedule at
this time, and this procedure is complete. If you click Yes, a dialog box
prompts you to back up
all subclients of this instance.
Click Yes.
The Backup Options dialog box appears, which allows you to create the
necessary schedules.
From the Backup Options
dialog box, select the type of backup that you want to schedule.
If you want to access Advanced Backup Options,
click Advanced.
After selecting the backup type and any advanced options, click OK.
The Schedule Details dialog box appears.
From the Schedule
Details tab of the Schedule Details dialog box, select the scheduling options
that you want to apply, then click OK.
NOTES
A default subclient is created for the Oracle instance, which includes all the objects in the instance.
When you are done with this procedure, open the Subclient
Properties dialog box for the default subclient and verify that
the Resync Catalog option available in the
Backup Arguments tab is selected. This
would help you to successfully perform a full system restore in the
event of destroyed or damaged client.
After creating the instance for DB2, you can now create one or more
Backup Sets for this
instance.
From the CommCell Browser, right-click the instance you want to modify, and then click
Properties from the shortcut menu.
Click the General tab of the
Instance properties box to change the required access information for
this instance.
If your agent uses the Accounts
tab, use this tab to specify the Windows account used by the system. For
MySQL iDataAgent, use this tab to specify the MySQL Server user account.
If your agent uses the Restore View Names
tab, use this tab to enter or modify a list of text patterns for the view
through which the system displays a database's data documents when you browse.
If your agent has the
Security
tab, you can
view CommCell resource associations to enable or disable user groups that
can perform system operations on associated resources.
For an Oracle instance, click the Details
tab to change the database connect string and other optional parameters.
For an Oracle RAC instance, go to the next step. Otherwise, go to
Step 12.
Click the Details
tab, and type or select values for the fields at the bottom of the dialog
box as appropriate. For the DB2 DPF instance, to associate a database
partition with a different client, click the affected partition in the
DB2 Partition Clients field, click Modify,
and click from the list in the
Edit
Directory Share Name Pair dialog box the name of the new client for the
partition. Then click OK.
Click the Oracle instance (Client/Instance/Status) that you want to
modify. Then click Modify.
In the
Update Instance dialog box, update the desired field values by typing or
browsing as appropriate. Then click OK.
Repeat the previous two steps for each Oracle instance that you want to
modify.
From the Storage Device
tab(s), select storage policy copies to be used for, as applicable, data
backups, command line data backups and log backups. Within these tabs
you can click Data
Paths to display the details of the data paths associated with the
primary storage policy copy of the selected storage policy.
For the MySQL
iDataAgent, select the storage
policy for the log backups from the
Log Backups
tab.
If your agent uses the
Software
Compression tab, and you want to enable software compression for the
selected
backups, click the tab and select the appropriate
option.
If you want to enable data encryption, from the
Encryption tab
select encryption settings for third-party or RMAN command line backups.
Click OK to save the configuration changes.
A message advises you to schedule backups for your new instance. It is
recommended you elect to set a schedule now. If you click No, this procedure is now
complete. If you click Yes, a dialog box
prompts you to back up
all subclients of this instance.
Click Yes.
The Backup Options dialog box appears, which allows you to create the
necessary schedules.
From the Backup Options
dialog box, select the type of backup that you want to schedule.
If you want to access Advanced Backup Options,
click Advanced.
After selecting the backup type and any advanced options, click OK.
The Schedule Details dialog box appears.
From the Schedule
Details tab of the Schedule Details dialog box, select the scheduling options
that you want to apply, then click OK.
For most agents except Oracle and SQL Server, you cannot delete an instance if there is only one instance present for
an agent. To delete the final instance for most agents except the ones
identified, you must first remove the agent
software from the client computer. For Oracle RAC, which does not involve
agent software, you can delete the instance under the RAC pseudo-client.
When you delete a specific instance positioned in the level below the
corresponding agent or pseudo-client in the CommCell Console, the following actions occur:
The corresponding backup data for that instance becomes immediately
unavailable, thus making it inaccessible for restore purposes. In
effect, the backup data is deleted.
All child levels contained within the level are deleted in the
CommCell Browser.
All job schedules and job histories that pertain to any of the
levels within the deleted instance are deleted.
If you delete an Oracle iDataAgent instance included within an Oracle RAC
instance (node), the backup data is not deleted, and it is available for
restore by another eligible client.
You cannot delete an instance if it is being backed up. Attempts to
delete an instance under such conditions cause the deletion to fail. If
a backup is in progress, either wait for the backup to complete or kill
the backup job using the Job Manager. Once the backup is no longer in
progress, you can delete the instance level.
To add a Lotus Domino Server partition to your
system configuration on Windows platforms:
From the CommCell Browser, right-click the Notes
iDataAgent node, click All Tasks
and then click Add
NewPartition. The system discovers all new partitions, and displays them in the
Add New Partition
dialog box.
To add a partition, select the check box located to the left of the
partition name.
Assign a storage policy to the partition by clicking in its Storage Policy
box and selecting a policy from the list.
Click OK to save your settings.
The Backup Schedule screen displays. To create a backup schedule for the new partition,
select one of the
three options:
To disregard backup schedules, click the Do Not Schedule radio
button and click OK. The screen exits with no backup schedule
established for the new partition. This task is now complete.
To link the new partition with a pre-defined policy, click the
Associate with Generic Schedule Policy radio button, choose from the
list, and click OK to exit the screen. This task is now complete.
To establish a backup schedule for the new partition, click the
Schedule radio button, and click OK. Go to Step 6.
The system displays a Backup All Subclients prompt verifying that
you want to backup all the subclients of this partition except the transaction
logs subclient. Click OK to backup.
The Backup Options dialog box appears, which allows you to create the
necessary schedules.
From the Backup Options
dialog box, select the type of backup that you want to schedule.
If you want to access Advanced Backup Options,
click Advanced.
After selecting the backup type and any advanced options, click OK.
The Schedule Details dialog box appears. From the
Schedule
Details dialog box, select the scheduling options
that you want to apply, then click OK.
Although it is possible to create multiple partitions during installation of
the iDataAgent, you may need to add additional partitions at a later date. For
clients running Unix, you repeat the installation procedure except as
noted below:
Place the
software installation disc for the Unix platform into the disc drive. You can also install the
product using a disc drive mounted on another computer on the network.
Open a Terminal window, navigate to the disc and enter cvpkgadd.
This package contains scripts which need super-user permission to execute.
Read the license agreement. Type y and press Enter to continue.
The following message displays (note that the menu options displayed below
will vary depending on platform):
1.CVGxMA
2.CVGxOrIDA
3.CVGxDB2IDA
4.CVGxLndbIDA (Add New Partitions Only)
5.CVGxLndocIDA
6.Exit
Module number: [4]
Enter the module number corresponding to CVGxLndbIDA (Add New Partitions Only).
The partition number that displays
reflects how many partitions have already been created.
In this example, two
partitions are already in existence; therefore, the new partition is
numbered as 3:
Please enter Notes DB Partition Name
for partition 3.
Partition Name:
Type the name of the partition, then
press Return (or Enter).
The following message prompts you to enter the Notes User
Name for the partition. This is the user name used by the iDataAgent
to log on to the Notes database.
Please enter Notes User Name for this
partition.
Notes User Name:
Type the Notes User Name for the partition, then press
Return.
The following message prompts you to enter the Notes Home
Directory for the partition. This is the directory in which the Lotus Notes
software is installed.
Please enter Notes Home Directory for
this partition.
Notes Home Directory:
Type the Notes Home Directory for the partition, then press
Return.
The following message prompts you to enter the Notes Data
Directory for the partition. This is the directory in which all databases
reside.
Please enter Notes Data Directory for
this partition.
Notes Data Directory:
Type the Notes Data Directory for the partition, then press Return.
The following message displays:
You have entered all the required
information for this partition.
Please review it now, and accept
"yes", if it is correct:
Partition Name........ your entry here
Notes User............ your entry here
Notes Home Directory.. your entry here
Notes Data Directory.. your entry here
Is this correct? [yes]
After verifying the above information, press Return to continue.
The following message displays:
Configured 3 partition(s) of Notes so
far.
Would you like to configure another
partition? [no]
If you don’t want to configure another partition, press Return.
(To configure another partition type yes and press Return to
repeat the process starting at Step 5.)
The following message displays:
Please select one storage policy for
this IDA from the list below:
1)SP_Library2_2
2)SP_MagLibrary3_3
Enter the module number corresponding
to the storage policy to use for the configured partition.
After configuring the partition, the install program
verifies the information entered during install and checks all requirements.
A summary similar to the following displays:
Successfully installed CVGxLndbIDA.
Press ENTER to continue ...
Press Return when prompted.
If this is the last component to be installed, enter the
number corresponding to the Exit option on the menu.
Enter the text pattern in the space provided. This pattern does not have to
match any actual Notes view name.
When there are multiple names listed, highlight a name and use the Up
or Down buttons to promote or demote that name. This adjusts the pattern's
priority in the system's browse search algorithm.
Click OK to save your settings.
If desired, you can assign a specific Restore View Name to documents at
the subclient level using the Subclient Properties Databases tab.
From the CommCell Browser, click Configure from any of these
locations:
For Notes Database iDataAgent
right-click the partition node with the subclient to which you want to assign
databases, select All Tasks and then click Configure.
For Notes Document iDataAgent
right-click the backup set node with the subclient to which you want to
assign databases, select All Tasks and then click Configure.
From the Add/Modify database/subclient configuration for
partition/backup set
dialog box, for each database that you want to assign click its Subclient box
and select the
desired subclient from the list. Alternatively, you can select
a range of databases and use Change all selected databases
to list to assign a single subclient to all the databases in one step.
Regardless
of the assignment method, your choices always include:
The default subclient
Any user-defined subclients
The Do Not Backup subclient
If you choose the Do Not Backup subclient, the database will not be backed up.
For the Notes Document iDataAgent,
click the Restore View Name box for the database element that you want to
assign to the
subclient to make the list arrow appear. Click again to make the list
appear. Select an option from the list.
To change
a user account for executing pre/post commands for Data Protection jobs:
From the CommCell Browser, expand the tree to view the appropriate level
icon for the affected agent.
From the agent, instance/partition, or backup set/archive set level, right-click
the appropriate icon, click All Tasks, and click New Subclient
from the short-cut menu.
From the subclient level, right-click the subclient icon and click
Properties from the short-cut menu.
From the Subclient Properties dialog box, create and/or configure the subclient
as appropriate. Then click the Pre/Post Process tab.
From the Pre/Post Process tab, click Change.
From the
User Account dialog box, select one of the account options. If you select
Impersonate User, type the appropriate user name and password.
To change
a user account for restoring to mapped/shared network drives and restricted directories:
From the CommCell Browser, expand the tree to view the desired level icon
for the affected agent. Then right-click the icon and click All Tasks
from the short-cut menu.
Click the appropriate Browse or Restore option. Then populate,
select, and click as appropriate to access the Restore Options (for All SelectedItems) dialog box.
From the Restore Options (for All Selected Items) dialog box,
click Advanced.
From the
Advanced Restore
Options dialog box, select Impersonate (Windows, NetWare) User.
Then type the appropriate user name and password.
From the CommCell Browser, click Configure from any of these
locations:
For Notes Database iDataAgent
right-click the partition with the subclient to which you want to assign
databases, select All Tasks and then click Configure.
For Notes Document iDataAgent
right-click the backup set with the subclient to which you want to
assign databases, select All Tasks and then click Configure.
When the discovery process completes, the system redisplays the Add/Modify database/subclient in partition/backup
set dialog box which displays the databases that have
already been assigned; plus any newly discovered databases that have not been assigned.
The unassigned databases are those that have no entry in the Subclient column.
To assign these databases, click the Subclient box of each database that you want to
assign and select the desired subclient from the list. Alternatively, you can select
a range of databases and use Change all selected databases
to list to assign a single subclient to all the databases in one step.
Regardless of the assignment method, your choices always include:
The default subclient
Any user-defined subclients
The Do Not Backup subclient
If you choose the Do Not Backup subclient, the database will not back up.
For the Notes Document iDataAgent,
click the Restore View Name box for the database element that you want to
assign to the
subclient to make the list arrow appear. Click again to open the list. Select an option from the list. Alternatively, you can select
a range of databases and use Change all restore View names
to list to assign a single name to all the selected databases in one step.
To register your database assignments with the system, click Apply.
If you have no other databases to assign, click OK.
To create/modify an Instance