Instances - Lotus Notes / Domino Server - How To
Topics | How To | Related Topics
Create an Instance
Modify an Instance
Delete an Instance
Change the User Account
Add a Lotus Domino Server Partition on Windows
Add a Lotus Notes Database Partition on AIX
Add a Restore View Name
Assign Databases to a Subclient
Change Account for Executing Pre/Post Commands for Data Protection (Lotus Notes Database)
Change Account for Restoring to Mapped/Shared Network Drives and Restricted Directories
Discover and Assign New Databases
Before You Begin
-
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:
set heading on;
set pause off;
Required Capability: See
Capabilities and Required Actions
To create/modify an Instance
- 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 Instance from 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.
Required Capability: See
Capabilities and Required Actions
To modify an 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.
Before You Begin
- 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.
Required Capability: See
Capabilities and Required Actions
To delete an
instance positioned in the level below the corresponding agent or
pseudo-client
- From the CommCell Browser, right-click the instance that you want to
delete, click All Tasks and then click Delete.
- Click Yes to confirm the deletion. (Clicking No
cancels the deletion and retains the node.)
- Type the requested phrase in the Enter Confirmation Text dialog box and
click OK. This should delete the instance.
To delete an
Oracle iDataAgent instance included
within an Oracle RAC instance (node)
- Right-click the Oracle RAC instance, click Properties, and
click Details.
- Click the instance that you want to delete within
Client/Instance/Status and click Delete.
- Repeat the previous step for each Oracle
iDataAgent instance (except the last
one remaining) within the Oracle RAC
instance that you want to delete.
- Click OK. This should delete the Oracle
iDataAgent instance(s).
|
With the exceptions noted above, you can no longer access the corresponding
backup data for restore purposes. |
Before You Begin
Required Capability Administrative
Management
To change the
user account
- From the CommCell Browser, expand the agent tree, right-click the desired
instance, and then click Properties.
- From the General dialog box, click the Change button associated
with the User Account information.
- From the Impersonate NT User dialog box, enter the requested
information.
- Click OK to save the settings.
Required Capability: See
Capabilities and Required Actions
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
New Partition. 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.
This task is now complete.
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:
Required Capability: See
Capabilities and Required Actions
To add
a Lotus Notes Database partition on Unix
-
Log on to the client as root.
-
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.
This task is now complete.
Before You Begin
Review Instances - Restore View Names
Required Capability: See
Capabilities and Required Actions
To add a Lotus Domino Server
Restore View
- From the CommCell Browser, expand a Notes Document
iDataAgent
node, right-click a
partition, and click Properties.
- From the Restore View Names tab, click Add.
- 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.
This task is now complete.
Required Capability: See
Capabilities and Permitted Actions
To assign databases to a
subclient:
- 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.
- For both iDataAgents, you
can use the Subclient Properties
(Databases) tab to access its Configure
button.
- 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 save the subclient configuration, click OK.
Required Capability: See
Capabilities
and Permitted Actions
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.
- Click OK to save the settings.
Required Capability: See
Capabilities
and Permitted Actions
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 Selected
Items) 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.
- Click OK to save the settings.
Required Capability: See
Capabilities and Permitted Actions
To discover and assign new
databases:
- 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.
- For both iDataAgents, you
can use the Subclient Properties
(Databases) tab to access its Configure
button.
- From the Add/Modify database/subclient configuration for
partition
dialog box, click Discover.
- 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.
Back to Top