Install the ProxyHost iDataAgent - Unix - Clustered Environment

Install Requirements

For an overview of deploying the software components in a clustered environment, see Clustering Support.

Review the following Install Requirements before installing software on a Unix cluster:

General

• Review Install Considerations before installing the software.
• Agents should be installed only after the CommServe and at least one MediaAgent have been installed in the CommCell. Also, keep in mind that the CommServe and MediaAgent must be installed and running (but not necessarily on the same computer), before you can install the Agent.
• Ensure there is an available license on the CommServe for the Agent.
• Verify that you have the Software Installation Disc that is appropriate to the destination computer’s operating system.

Cluster

• Refer to Installing the Software on the Cluster for important overview information about installing MediaAgent or Agent software in a Unix clustered environment.
• Check the following on the cluster computer in which you wish to install the software:
  • Cluster software is installed and running.
  • Active and passive nodes are available.

Agent Specific

Complete the following steps:

1. Install the Base software and the required agents on all the nodes that are included in the cluster service. See Installation for more information.
2. Be sure to install your software to the appropriate directories per the directives in UNIX Clusters.
3. Verify that all of the computers to which software will be installed satisfy the minimum requirements specified in the appropriate System Requirements.
4. Ensure that services are up and running on the remote hosts.

HP-UX

• If you are installing on a HP-UX computer, you must manually mount the installation disc as described in Mount the Software Installation Disc.

Before You Begin

• Log on to the client as root.
• The install package requires super-user permissions to execute.

Install Procedure

Getting Started

You can also install the product using a disc drive mounted on another computer on the network.

• On Solaris, double-click the cvpkgadd program from the File Manager window.
• On other Unix platforms, open the Terminal window, navigate to the software installation disc and then enter ./cvpkgadd. 

NOTES

• For Install data protection agents on this computer option, follow the steps described in this procedure.
• Advance options provide additional setup features such as record and play setup, creating a custom package and External Data Connector Agent software.

  To create a custom package and for record and play setup, follow the steps described in Custom Package - Unix.

  To install the External Data Connector Agent, follow the steps described in External Data Connector - Unix.

Advance options provide extra setup features such as creating custom package, recording/replaying user selections and installing External Data Connector software.

1) Install data protection agents on this computer

2) Advance options

3) Exit this menu

Your choice: [1]

Press Enter to continue.

If your computer is 64-bit, see Install Unix Agents on 64-bit Platform for step-by-step procedure.

1) All platforms (32 bit)

2) FS and MA only (64 bit)

Your choice: [1]

Cluster Selection

You now have a choice of performing a regular Calypso install on the physical host or installing Calypso on a virtual machine for operation within a cluster.

Most users should select "Install on a physical machine" here.

1) Install on a physical machine

2) Install on a virtual machine

3) Exit

Your choice: [1]

WARNING: You should follow this path ONLY if this host participates in a cluster and you really want to install Calypso on the virtual machine. This is NOT how most people will use Calypso.

If you got into this screen by mistake, hit ^C and restart cvpkgadd.

Virtual Machine Host Name:

Would you like to use fully qualified "example.company.com" instead of "example"?

Use longer "example.company.com" name? [yes]

If you still must install for the active node, type no, press Enter, and perform the install for the virtual machine for the active node.

NOTES

• This prompt appears only when installing on a passive node.

Virtual Machine Client Name: [hpuxmc1]

NOTES

• This prompt appears only when the Unix File System iDataAgent is not installed on the physical node.

Network interfaces with the following IPs are available on your system. Please select the one that you want to be associated with Calypso physical machine. The interface should be static, and should not get disabled in case of cluster failover.

1) mackrel71
2) mackrel
3) mackrel1

Interface number: [1] 2

Physical Hostname: [mackrel]

It does not have to be the network host name: you can enter any word here without spaces. The only requirement is that it must be unique on the CommServe.

Physical Machine Node Name: [mackrel]

Select Components for Installation

A confirmation screen will mark your choice with an "X". Type "d" for Done, and press Enter to continue.

NOTES

• To select multiple component, enter the number by adding a space.
• Your screen may look different from the example shown.
• Components that either have already been installed, or which cannot be installed, will not be shown.
• In addition, the list of modules that appear depends on the specific Unix File System in which the package is installed. (e.g., CVGxWA will appear only when the installation package is run on a Solaris computer.)

Select the Calypso module that you would like to install

[ ] 1) Media Agent        [1301] [CVGxMA]
[ ] 2) FileSystem IDA     [1101] [CVGxIDA]
    >) >>>>> NEXT PAGE  >>>>>>

[a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]

Enter number(s)/one of "a,n,r,q,d,>,<,?" here: 2

Base Software Installation

Otherwise, accept no, press Enter to continue.

NOTES

• Select Download from the software provider website to download the latest software scripts from your software provider website.

  Make sure you have internet connectivity when you are using this option.

• Select Use the one in the installation media, to install the software scripts from the disc or share from which the installation is performed.
• Select Use the copy I already have by entering its unix path, to specify the path if you have the software script in an alternate location.

If you choose to download it from the website now, please make sure you have internet connectivity at this time. This process may take some time depending on the internet connectivity.

1) Download from the software provider website.

2) Use the one in the installation media

3) Use the copy I already have by entering its unix path

Your choice: [1] 2

NOTES

• Internet connectivity is required to download updates.
• This step is applicable for multi instancing.

Press Enter to continue.

NOTES

• The amount of free space required depends on the components selected for install, and may look different from the example shown.

Press Enter to accept the default path and continue, or
Enter a path and then press Enter to continue.

Press Enter again to confirm the path.

It must be a local directory and there should be at least 170MB of free space available. All files will be installed in a "calypso" subdirectory, so if you enter "/opt", the files will actually be placed into "/opt/calypso".

Installation Directory: [/opt]

..

Calypso will be installed in /opt/calypso.
Press ENTER to continue ...

NOTES

• All the modules installed on the computer will store the log files in this directory.
• The amount of free space required depends on the components selected for install, and may look different from the example shown.

Press Enter to accept the default path and continue, or
Enter a path and then press Enter to continue.

Press Enter again to confirm the path.

It must be a local directory and there should be at least 100MB of free space available. All log files will be created in a "calypso/Log_Files" subdirectory, so if you enter "/var/log", the logs will actually be placed into "/var/log/calypso/Log_Files".

Log Directory: [/var/log]

..

Calypso log files will be created in /var/log/calypso/Log_Files.
Press ENTER to continue ...

Press Enter to assign a new group, or
Type No and then press Enter to continue.

We highly recommend now that you create a new user group and enter its name in the next setup screen. If you choose not to assign a dedicated group to Calypso processes, all temporary and configuration files will be created with -rw-rw-rw permissions.

If you're planning to backup Oracle DB you should use "dba" group.

Would you like to assign a specific group to Calypso? [yes]

Enter the group name and then press Enter to continue.

Press Enter again to continue.

For installs on a Solaris computer, proceed to the next step. Otherwise, skip to Storage Policy Selection.

In most of the cases it's a good idea to create a dedicated "calypso" group. However, if you're planning to use Oracle iDataAgent or SAP Agent, you should enter Oracle's "dba" group here.

Group name: dba

REMINDER

If you are planning to install Calypso Informix, DB2, PostgreSQL, Sybase or Lotus Notes iDataAgent, please make sure to include Informix, DB2, etc. users into group "dba".
Press <ENTER> to continue ...

Type a network TCP port number for the Client Event Manager Service (EvMgrC) and press Enter.

NOTES

• For more information about Network TCP Ports, see Network TCP Port Requirements.
• For more information about these services, see Services.
• If the port number you entered already exists, a message will be displayed Port #### is already reserved in /etc/services. To work around this issue, enter different port number.

For firewall options and configuration instructions, see Firewall Configuration and continue with the installation.

If you do not wish to configure the firewall services, type No and then press Enter to continue.

NOTES

• Ensure that the CommServe is accessible before typing the name; otherwise the installation will fail.
• If you enter a short name which resolves to the same IP address as the fully qualified CommServe name, you will be asked if you would prefer to use the fully qualified name.

CommServe Host Name:

NOTES

• This is only displayed when the Authentication for Agent feature is enabled in the CommCell Properties. Users must belong to a User Group with Agent Management capabilities to enable this feature. For more information, see Authentication for Agent Installs.

Click Enter to continue.

User Name :

Password :

Press <ENTER> to continue ...

Kernel Parameters

NOTES

• The number of streams specified ensures that concurrent backup/restore streams would have sufficient system resources. For more information on the subject, see Configuring Kernel Parameters for Macintosh and Configuring Kernel Parameters for Solaris.

This prompt is relevant only when you install/upgrade on a Macintosh or Solaris computer as appropriate.

Number of streams: [10]

Type Yes, and then press Enter to automatically update the file and continue, or
Press Enter to accept the default No and continue (if you do not want to automatically update the file).

This prompt is displayed only when you install/upgrade on a Solaris (8 or 9) or Macintosh computer.

Please review the changes below and answer "yes" if you want us to apply them to the /etc/system file. Otherwise, the installation will proceed, the changes will be saved to some other file, and you will have to apply them manually.

set shmsys:shminfo_shmmni=8570 (was 7930)
set shmsys:shminfo_shmseg=8420 (was 7780)
set semsys:seminfo_semmns=10320 (was 9680)
set semsys:seminfo_semmni=8570 (was 7930)
set semsys:seminfo_semmsl=8570(was 7930)

Do you want us to apply these changes now? [no]

Changes saved into /etc/system.gal.1744

Press <ENTER> to continue.

NOTES

• The settings that are displayed are the maximum or minimum required settings. Value ’640’, which is provided for various shared memory segment or semaphore requirements, is a maximum value based on 10 streams.

Press Enter to continue.

This prompt is displayed only when you install/upgrade on a Solaris (8 or 9) computer, in cases where the install detects that the computer does not have the maximum or minimum required shared memory settings.

set shmsys:shminfo_shmmax=4199304
set shmsys:shminfo_shmmin=1
set semsys:shminfo_shmmni=640
set semsys:shminfo_shmseg=640
set semsys:seminfo_semmns=640
set semsys:seminfo_semmni=640
set semsys:seminfo_semmsl=640
set maxusers=256

Enable Global Filters

NOTES

• Select Use Cell level Policy to inherit the global filter policy configuration set for the CommCell, i.e., if the Use Global Filters on All Subclients option is selected in the Global Filters dialog box (from the CommCell Console’s Control Panel), then this policy will be applied to the default subclient as well. If is not selected, then the global filters will not be applied to the default subclient.
• Select Always use Global filters to always apply the global filters policy to the default subclient regardless of the policy set for the CommCell.
• Select Do not use Global filters to disregard applying the global filters to the default subclient regardless of the policy set for the CommCell.

1) Use Cell level policy
2) Always use Global filters
3) Do not use Global filters

Please select how to set the Global Filters for the default subclient? [1]

Client Group Selection

A confirmation screen will mark your choice with an "X". Type d for done with the selection, and press Enter to continue.

NOTES

• This screen will be displayed only if Client Groups are configured for the CommCell. For more information, see Client Computer Groups.

[a=all n=none r=reverse q=quit d=done >=next <=previous ?=help]

Enter number(s)/one of "a,n,r,q,d,>,<,?" here: 2

Storage Policy Selection

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 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.

1) SP_StandAloneLibrary2_2
2) SP_Library3_3
3) SP_MagLibrary4_4
4) fornax_fornax_HWCmp
5) ranger_ranger_HWCmp
6) fornax_fornax_ClntCmp
7) fornax_fornax_MACmp
8) fornax_fornax_NoCmp

Storage Policy: [3]

ProxyHost Installation

Press Enter to continue.

Successfully copied xx files

Successfully installed CVGxProxyIDA.

Press ENTER to continue ...

Setup Complete

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.

IMPORTANT:

In addition to installing Calypso on this computer, you will also need to create a Job Schedule for each iDataAgent that has been installed on this client computer.

Job Schedules are required to allow the Calypso iDataAgents to perform automated backup and restore operations.

Job Schedule creation can be accomplished through the Calypso CommCell Console administration interface.

+---------------------+

NOTES

• Only modules that are not installed/upgraded appear in the list.
• Your screen may appear different from the example shown.
• If you are installing on AIX, FreeBSD, IRIX or Tru64 computers, if this module was the last possible module to install, you are automatically exited from the program. Otherwise, type the number for the Exit option and then press Enter. The installation is completed.

1) FileSystem iDataAgent
2) Exit

Module number: [1]

NOTES

• Internet connectivity is required to download updates.
• This step is applicable for multi instancing.

Press Enter to continue.

The installation is now complete.

Now you have an option of installing Calypso on physical machine, another virtual machine or you can add a new package to hpuxmc1.company.com.

1) Add a new package to hpuxmc1.company.com
2) Install Calypso on the physical machine
3) Install Calypso on another virtual machine
4) Exit

Your choice: [1]

Post-Install Considerations

General

• Install post-release updates or Service Packs that may have been released after the release of the software. When you are installing a Service Pack, 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.

Cluster

• The cvclusternotify script should be added as part of the normal cluster startup/shutdown procedure. The script is provided as a generic template, and it must be run at the beginning of node shutdown and at the end of new active node startup. In both cases, data protection services must be up and running.

  Run the following command to notify Calypso that the specified "virtual node" is going up or down because of a cluster failover:

  Usage:

  cvclusternotify -inst <Instance> -cn <Client Name> -start|-shutdown

  Where:

  cvclusternotify - Program to notify Calypso of cluster failovers

  Example:

  For two-node cluster, if the virtual client name is "virtual" and the application instance is "Instance001", run the following command:

  • To shutdown:

    cvclusternotify -inst Instance001 -cn "virtual" -shutdown

  • To start up:

    cvclusternotify -inst Instance001 -cn "virtual" -start

• On failover of a Linux cluster, Services may be killed by cluster services during a virtual machine failover. To insure that the Services are re-started on the passive node, add commands in failover scripts to start Services.

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.