Install the SRM Unix File System Agent

Where to Install

Installing on a Global Zone or Unix Server

Install the software directly on the computer hosting the global zone or the Unix Server that you wish to protect. Make sure the computer satisfies the minimum requirements specified in the System Requirements.

Installing on a Non-Global Zone

Install the software on each of the non-global zones where you have application data.

Verify that the computer in which you wish to install the software satisfies the minimum requirements specified in System Requirements - SRM Unix File System Agent.

It is recommended to install the software on the global zone to protect non-changing or static data on non-global zones. If the data is dynamic or contains application data, install the software on the non-global zone.

Install Requirements

The following procedure describes the steps involved in installing the SRM UNIX File System Agent. If you choose to install additional 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 SRM Server has been installed in the CommCell. Also, keep in mind that the CommServe and SRM Server must be installed and running (on the same computer), before you can install the Agent.
• 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 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.

Multi Instancing

• By utilizing the Multi Instancing feature, the same Agent and MediaAgent software can be installed on a computer multiple times, but not all components support Multi Instancing. This limitation can apply to the component you are installing, or to one already installed on the computer. Prior to installing multiple instances of a software component on the same computer, carefully review the information contained in Multi Instancing, and follow the instructions in the How to Use Multi Instancing section for the additional screens that will appear during the installation process.

Agent Specific

Package Management Systems

You can use the Red Hat Package Manager (RPM) package management system to install all Linux versions of the agent. Also, you can use the Advanced Packaging Tool (APT) package management system to install all Debian Linux versions of the agent. For step-by-step instructions, see Base Software Install for RPM Package Manager and Base Software Install for APT Package Manager.

AIX

If you are installing on an AIX computer, and if you have a dual-layer DVD, be sure to issue the following command from the command line to mount the DVD:

/usr/sbin/mount -v 'cdrfs' -f'' -p'' -r'' /dev/cd0 /mnt

HP-UX

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

Red Hat Linux

Red Hat Linux will create an entry in the /etc/hosts file when it is first installed, in the following format:

<ip_address> <host name> localhost

For example, if the host name of your computer is bluesky, the entry will look something like this:

192.168.1.111 bluesky localhost

If you have not already done so, edit the /etc/hosts file. The edited entry should look like this:

127.0.0.1 localhost

Depending upon your environment, and using the above example again, you may also need an entry similar to this:

192.168.1.111 bluesky

Ubuntu Linux

Before installing the software on Ubuntu Linux systems, be sure to install the binutils package by running the apt -get install binutils command as root.

Before You Begin

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

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. 

• Mount the installation disc on the non-global zone.

  mkdir <Non-Global Zone root location>/<Non-Global Zone local directory>

  mount –F lofs <Global zone software Install Disc mount point> <Non-Global Zone root location>/<Non-Global Zone local directory>

  Connect to Non-Global Zone terminal

• Run the following command from the Software Installation Disc:

  ./cvpkgadd

Press Enter to continue.

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]

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]

Press Enter to continue

NOTES

• When you install on non-clustered computer, you must select the number associated with the option Install on a physical machine.

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]

If you have multiple network interfaces, enter the number corresponding to the network interface that you wish to use as default, and then press Enter to continue.

NOTES

• The interface name and IP addresses depend on the computer in which the software is installed and may be different from the example shown.

Please check the interface name below, and make connections if necessary:

Physical Machine Host Name: [angel.company.com]

Press Enter to accept the default name and continue, or
Enter a new client name for the computer and then press Enter to continue.

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 Client name: [angel]

Select Components for Installation

NOTES

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

Press Enter to continue.

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 176MB 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 Setup Complete.

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:

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.

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

Successfully installed CVGxSRM.
Press ENTER to continue ...

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]

The installation is now complete.

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.

Agent Specific

• For the AIX, HP-UX, Linux and Solaris SRM Agents, a registry key is available to allow you to define where core files will be generated in the unlikely event of an application process crash. Generating core files in file systems other than root will help maintain system integrity. Refer to dCOREDIR for information about implementing this registry key.

• To run Backup or Data Collection job successfully when this Agent is installed on a freshly installed Linux computer that has SELinux enabled, set SELinux enforcing to 0 as /usr/sbin/setenforce 0.