|
The Domino Mailbox Archiver Agent is
installed on the computer from which the Domino Server resides. (This
computer is referred to as the Client computer in this install
procedure.) Verify that the computer in which you wish to install the
software satisfies the minimum requirements specified in
System
Requirements - Domino Mailbox Archiver Agent.
The following procedure describes the steps involved in installing the
Domino Mailbox Archiver Agent. If you choose to
install multiple components simultaneously, refer to the appropriate
procedures for installation requirements and steps specific to the
component. Note that when you install multiple components, the sequence
of the install steps may vary.
Review the following Install Requirements before installing the
software:
General
- Agents should be installed only after the CommServe and at least one
MediaAgent have been. Also, keep in mind that the CommServe® software and MediaAgent must be installed and running (but not
necessarily on the same computer), before you can install the
Agent.
- This software should be installed in a CommCell component with current versions of the CommServe
Server and MediaAgent software.
- Close all applications and disable any programs that run automatically,
including anti-virus, screen savers and operating system utilities. Some of
the programs, including many anti-virus programs, may be running as a service.
Stop and disable such services before you begin. You can re-enable them after
the installation.
- Ensure there is an available license on the CommServe software for the Agent.
- Verify that you have the
software
installation disc that is appropriate to the destination computer’s
operating system.
Make sure that you have the latest
software
installation disc before
you start to install the software. If you are not sure, contact your
software provider.
Firewall
- If the CommServe® Server, MediaAgent and/or Clients communicate across two-way firewall(s):
- Ensure port 8400 is allowed connections through the firewall.
- In addition a range of bi-directional ports (consecutive or
discrete) must also be allowed connections through the
firewall.
For information on configuring the range of ports, see
Port
Requirements for Two-way Firewall.
- If the CommServe Server, MediaAgent and/or Clients communicate across one-way firewall(s):
- Identify a range of outbound ports (consecutive or discrete) for use
by the software.
For information on configuring the range of ports, see
Port
Requirements for One-way Firewall.
-
If the MediaAgent/Client communicates with the CommServe Server across a one-way
firewall, you must add the MediaAgent/Client host name (or the IP address) in
the CommServe computer before installing the necessary software on the
MediaAgent/Client computer.
Agent Specific
- If you have edited the Domino servers local host file to resolve
Notes port mapping issues, make sure that the network interface names are
recognized by the DNS server and are not just local host file entries.
Check the default values before accepting them. Otherwise, the CommServe
and MediaAgent may not be able to access the client using the interface
names that you have entered.
- Ensure that the Domino Server ID does not have an associated
password. If the Domino Server ID has a password associated with it, you
must enable the option on the ID called Dont prompt for password from
other Notes based programs. For more information on the subject, see
Domino
Server ID.
|
|
Collect the following information
before installing the software. Use the space provided to record the
information, and retain this information in your Disaster Recovery
binder. |
1. |
Install folder location:________________________________________________________________
See Select Components for Installation
for more information.
|
2. |
If the CommServe Server and the client computer communicate across a firewall:
Firewall ports: ______________________________________________________________________
Hostnames and/or IP Addresses and corresponding GxCVD port numbers of
computers on the other side of the firewall:______________
Keep Alive Interval minutes:____________________________________________________________
Hostname for outgoing tunnel
connections:_________________________________________________
Tunnel Initialization Interval
seconds:_____________________________________________________
See Firewall Configuration for more information.
|
3. |
CommServe Host Name or the CommServe IP address:______________________________________
See Configuration of Other
Installation Options for more information.
|
4. |
Client computer's Host name (NetBIOS name) or IP address____________________________________
See Configuration of Other
Installation Options for more information.
|
5. |
Job result folder location:________________________________________________________________
If necessary, Name and Password for the specified folder:_______________________________________
See Configuration of Other
Installation Options for more information.
|
6. |
Storage Policy used by the default subclient:________________________________________________
See Storage Policy Selection for more information.
|
7. |
Client Group to which this Client will be associated:_____________________________________________
See Client Group Selection for more information.
|
8. |
Time and frequency for Install of Automatic Updates:_________________________________________
See Schedule Automatic Update for more information.
|
9. |
Login name and password for a user with administrator privileges to
access the Domino Server:
_____________________________________________________________________________________ |
|
- Log on to the Domino Server as a local Administrator or as a member
of the Administrators group on that computer.
|
8. |
Select a new or existing instance you wish to use during install. |
![](../screens/dm_lotus_notes/select_instance.gif) |
9. |
Select the component(s) to install. NOTES
- Your screen may look different from the example shown.
- Components that either have already been installed, or which cannot be installed, will be dimmed.
Hover over the component for additional details.
- The Special Registry Keys In Use field will be enabled when GalaxyInstallerFlags
registry keys have been enabled on this computer. Hover over the field to
see which keys have been set, as well as their values. For more information,
see
Registry Keys.
Click Next to continue.
To install the Domino Mailbox Archiver Agent, expand the
DataArchiver Agents folder and select:
|
![](../screens/common/select_platforms.gif) |
10. |
Specify the location where you want to install the software. NOTES
Click Browse to change directories.
Click Next to continue.
|
![](../screens/common/destination_path.gif) |
|
11. |
Select from the following:
- If this Client communicates with the CommServe Server and/or MediaAgent across a
firewall, select Yes, configure firewall services, and then click
Next to continue.
Proceed to the next Step.
- If firewall configuration is not required, click No, do not configure
firewall services and then click Next to continue. Proceed to
the next section.
NOTES
- Operating systems, such as Windows 2008 and Windows Vista, may have more
than one profile present. When you select No to configure firewall
services, verify that firewall settings are not enabled in the profile(s).
- If the system detects firewall settings are present in the profile(s),
you must select from the following:
- Disable firewall for ALL profiles: Employ caution when
choosing this option; firewall settings will be disabled in all
profiles. This requires a system reboot; installation automatically
resumes after reboot.
- No, Firewall is not enabled: Select this option if your
firewall settings allow communication with the CommServe computer.
Click Back to configure firewall services.
|
![](../screens/common/firewall.gif) |
12. |
Click the Specify list of machine across the firewall option and then
specify the list of hosts separated from this computer by a firewall. Make sure
you correctly describe whether the firewall allows two-way communication (but on
a limited range of ports), or one-way communication (with either only remote
host being able to make connections to this computer, or vice versa).
For all one-way firewalls allowing incoming connections and those one-way
firewalls allowing outgoing connections without additional port filtering, skip
this step.
Click Next to continue.
NOTES
- Consider the following:
- On the CommServe Server, this list should include all the
MediaAgents and Clients that are on the other side of the
firewall.
- On the MediaAgents/Clients this should include the CommServe
computer, and any other Clients/MediaAgents on the
other side of the firewall with which communications will be
established.
- For each machine on the other side of the firewall that you want to
configure, choose the type of firewall configuration based on the firewall setup in
your environment. Choose from the following options:
- Click on 2-way firewall if you can open certain ports as
bi-directional ports.
- Click 1-way firewall; host is reachable from this machine
on the machine that is on the secure side of the firewall.
- Click 1-way firewall; host is NOT reachable from this machine
on the machine that is on the public / DMZ side of the firewall.
- If you wish to communicate with computers in a clustered
environment, ensure that you add the Host Name/IP Address of all
physical nodes in the cluster (even if no CommCell components are
installed) and all the virtual nodes in which CommCell components are
installed.
- Type the host name or the IP address and the GxCVD port number of the
host name, and
click Add to place it in the Host Name/IP Address List.
|
![](../screens/common/firewall_host_name.gif) |
13. |
Click the Specify list of restricted open ports option and then
specify the port range. Add the starting and ending port range and then click
Add to place it in the Open Port List. Repeat as needed.
If firewall separating this computer from others allows incoming connections,
but these connections can be made only on a limited set of ports, then configure
the appropriate port range here. For all other scenarios, skip this step.
Note that if you do not specify hostname(s) as well as port number(s), then
the firewall services will not be configured.
NOTES
- Typically in a two-way firewall, the open ports must be indicated for
all computers. In a one-way firewall, the ports must be specified on
computers in the open side, if they are open in a restricted way. Note that
the port ranges are not required for computers that are fully closed in the
one-way firewall. For example, laptops which are configured as clients in
the Workstation Backup Agent.
- In a clustered environment, make sure the firewall ports specified here
are open for communication on all the physical nodes as well as the virtual
nodes.
Click Next to continue.
|
![](../screens/common/firewall_ports.gif) |
14. |
If desired, modify the Keep Alive interval.
Click Next to continue.
|
![](../screens/common/firewall_keep_alive.gif) |
15. |
Optionally, select Advanced Firewall Configuration and specify a local
host name interface to use for outgoing tunnel connections through
the firewall. Otherwise, the interface and port is automatically selected for
you by the OS. Click Next to continue.
|
![](../screens/common/firewall_bind.gif) |
16. |
If desired, modify the Tunnel Initialization interval.
Click Next to continue.
|
![](../screens/common/firewall_tunnel.gif) |
17. |
Select Download Pack(s) and Install to download and install the latest service packs and post packs from the software provider.
NOTES
- Internet connectivity is required to download updates.
- This step is applicable when installing on the first instance.
- Updates are downloaded to the following directory:
<software installation>/Base/Temp/DownloadedPacks.
They are launched silently and installed automatically for the first instance.
Click Next to continue.
|
![](../screens/common/install_latest_sp_updates.gif) |
|
18. |
Enter the fully qualified domain name of the CommServe computer. (TCP/IP network
name. e.g., computer.company.com)
NOTES
-
Do not use spaces when specifying a new name for the CommServe Host Name.
- If a component has already been installed, this screen will not
be displayed; instead, the installer will use the same Server Name as previously
specified.
Click Next to continue.
|
![](../screens/common/server_name.gif) |
19. |
Enter the username and password information for an external
domain user account or a CommCell user account. This authorizes the installation
of an agent on the CommCell.
NOTES
- This window is only displayed when the Require Authentication for Agent
Installation option is selected in the CommCell Properties. Users must belong to a User
Group with Administrative Management capabilities to enable this feature. For more
information, see
Authentication for Agent Installs.
Click Next to continue.
|
![](../screens/common/authentication.gif) |
20. |
Enter the following:
- The local (NetBIOS) name of the client computer.
- The TCP/IP IP host name of the NIC that the client computer must use to communicate with the CommServe
Server.
NOTES
-
Do not use spaces when specifying a new name for the Client.
- The default network interface name of the client computer
is displayed if the computer has only one network interface. If the
computer has multiple network interfaces, enter the interface name that
is preferred for communication with the CommServe Server.
- If a component
has already been installed, this screen will not be displayed; instead, the
install program will use the same name as previously specified.
Click Next to continue.
|
![](../screens/common/client_name.gif) |
21. |
Specify the following and click Next to continue:
- Type the location of the client's job results directory, or click Browse.
NOTES
- The Agent uses the job results directory to store the client's backup and
restore job results.
|
![](../screens/common/job_results.gif) |
|
22. |
Select a Client Group from the list. Click Next to continue.
NOTES
- This screen will be displayed only if Client Groups are configured in
the CommCell Console. For more information, see
Client
Computer Groups.
|
![](../screens/common/client_group.gif) |
|
23. |
Select one or more partitions from the Available Partitions pane to include in the install.
NOTES
Click Next to continue. |
![](../screens/dm_lotus_notes/select_partitions.gif) |
|
24. |
Select the storage policy through which you want to back up/archive the
indicated component (subclient, instance, etc.)
NOTES
- A storage policy directs backup data to a media library. Each library
has a default storage policy.
- When you install an Agent, the install program creates a default subclient
for most Agents.
- If desired, you can change your storage policy selection at any time
after you have installed the client software.
- If applicable, enable Global Filters for the default subclient.
- If this screen appears more than once, it is because you have selected
multiple agents for installation and are configuring storage policy
association for each of the installed agents.
Click Next to continue.
If you want to use different storage policies for any of the available
partitions, leave them unconfigured in this step and add them using the
CommCell Browser after the installation is complete. See
Add a Lotus
Domino Server Partition on Windows. |
![](../screens/common/storage_policy.gif) |
25. |
Select Download Pack(s) and Install to download and install the latest service packs and post packs from the software provider.
NOTES
- Internet connectivity is required to download updates.
- This step is applicable when installing on the first instance.
- Updates are downloaded to the following directory:
<software installation>/Base/Temp/DownloadedPacks.
They are launched silently and installed automatically for the first instance.
Click Next to continue.
|
![](../screens/common/install_latest_sp_updates.gif) |
|
26. |
Verify the summary of selected options.
NOTES
- The Summary on your screen should
reflect the components you selected for install, and may look different from
the example shown.
Click Next to continue or
Back to change any of the options.
The install program now starts copying the software to the computer.
This step may take several minutes to complete.
|
![](../screens/common/install_summary.gif) |
27. |
The System Reboot message may be displayed. If so, select one of the following:
- Skip Reboot
This option will be displayed if the install program
finds any files belonging to other applications, that need to be
replaced. As these files are not critical for this installation,
you may skip the reboot and continue the installation and reboot the
computer at a later time.
- Reboot Now
If this option is displayed without the
Skip Reboot
option, the install program has found files required by the software
that are in use and need to be replaced. If Reboot Now is displayed
without the Skip Reboot option, reboot the computer at this point. The
install program will automatically continue after the reboot.
- Exit Setup
If you want to exit the install program, click
Exit
Setup.
|
![](../screens/common/reboot.gif) |
|
28. |
If necessary, select this option to schedule an automatic installation of software
updates.
NOTES
Click Next to continue.
|
![](../screens/common/updates_schedule.gif) |
|
29. |
Click Next to continue.
NOTES
- Schedules help ensure that the data protection operations for the
Agent are automatically performed on a regular basis without user intervention.
For more information, see
Scheduling.
|
![](../screens/common/schedule_reminder.gif) |
30. |
Setup displays the successfully installed components.
NOTES
- The Setup Complete message displayed on
your screen will reflect the components you installed, and may look different
from the example shown.
- If you install an Agent with the CommCell Console open, you need to
refresh the CommCell Console (F5) to see the new Agents.
- If Reboot Now button is displayed make sure to reboot the
computer before performing any other operations from the computer.
Click Finish to close the install program.
The installation is now complete.
|
![](../screens/common/setup_complete.gif) |
|
General
-
Install post-release updates or Service Packs that may have been released
after the release of the software. If you are installing a Service Pack,
verify and ensure that it is the same version as the one installed in the
CommServe Server. Alternatively, you can enable
Automatic Updates for
quick and easy installation of updates in the CommCell component.
- After installing the Agent, you may want to configure the Agent before running
a data protection operation. The following list includes some of the most common
features that can be configured:
- Configure your subclients - see
Subclients
for more information.
- Schedule your data protection operations - see
Scheduling
for more information.
- Configure Alerts - See
Alerts and Monitoring
for more information.
- Schedule Reports - See
Reports for more
information.
The software provides many more features that you will find useful. See the
Index for a complete list of supported
features.
Agent Specific
The following configuration tasks are required before performing an Archive
Operation using this DataArchiver Agent:
- After installing the Domino Mailbox Archiver Agent, restart the Domino
Server by typing the command restart server
from the Domino Server Console.
-
After installing the Domino Mailbox Archiver Agent, the Lotus Notes Mailbox
master template should be configured to display a stub icon for each message
archived. When this configuration is performed, the Lotus Notes client mailbox will automatically display archived messages with a stub icon. Users can
then recall the archived message by opening the message in the Lotus
Notes client mailbox.
See
Configure Stub Icons for Lotus
Notes Mailboxes for step-by-step instructions.
- The Domino Server should be up and running while performing discoveries
of mail databases.
-
Archiving Rules are initially disabled by default. You must clear the Disable All Rules option in the Subclient Properties (Archiving Rules) or (Rules) tab and configure the archiving rules before conducting rules-based Archive Operations.
-
The Domino Mailbox Archiver Agents provides three modes which further direct
how archive and recovery operations behave for each subclient. These modes can
be selected using the General tab of the Subclient Properties
dialog box and should be configured prior to running the first archive
operation.
See Operation Modes
for more information.
Disaster Recovery Considerations
- Before you use your agent, be sure to review and understand the associated
full system restore (or disaster recovery) procedure. The procedure for some
agents may require that you plan specific actions or consider certain items
before an emergency occurs. See
Disaster Recovery for more information
regarding your agent.
|