Deployment - Unix

Skip this page if you are not installing this agent on unix.

Click to continue with the deployment.

Follow the steps given below to install the External Data Connector software.

Installation

before you begin

 

Method 1: typical Install

Use this procedure to install directly on a client computer. Using this method will automatically create an External Data Connector instance in the CommServe.

Method 2: interactive Install

Use this procedure to install the software directly on client computer.

Method 3: Install Software from CommCell Console

Use this procedure to remotely install the software on a client computer.

Download Software Packages

Download the latest software package to perform the install.

System Requirements

Make sure that the computer in which you wish to install the software satisfies the System Requirements.

Method 1: typical Install

1. Place the Software Installation Disc on a client computer where NetBackup Server resides.  
2. Run the following command from the Software Installation Disc:

./cvpkgadd

 
3. The product banner and other information is displayed.

Press Enter to continue.

 
4. Read the license agreement. Type y and press Enter to continue.  
5. Enter 2 to select the Advance options. Please select a setup task you want to perform from the list below:

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]

6. Enter 5 to Symantec NetBackup Agent. Unix Setup Advances Options

Please select a setup task you want to perform from the list below:

[Record and Play]

  1] Create a recording of user selections (Record Mode)

  2] Play a recorded install on this computer

[Custom Package Creator]

  3] Create a custom install package

[De-coupled Installer]

  4] Pre-install software Components [De-couple Mode]

[Third Party Connector]

  5] Symantec NetBackup Agent

  6] NetApp Snap Manager for Oracle

  7] NetApp Snap Manager for SAP/Oracle

7. Click Next. Certain Calypso packages can be associated with a virtual IP, or in other words, installed on a "virtual machine" belonging to some cluster. At any given time the virtual machine's services and IP address are active on only one of the cluster's servers. The virtual machine can "fail-over" from one server to another, which includes stopping services and deactivating IP address on the first server and activating the IP address/services on the other server.

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]

8. If you have only one network interface, press Enter to accept the default network interface name and continue.

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

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.
We found one network interface available on your machine. We will associate it with the physical machine being installed, and it will also be used by the CommServe to connect to the physical machine. Note that you will be able to additionally customize Datapipe Interface Pairs used for the backup data traffic later in the Calypso Java GUI.

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

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

9. Click Next. Please specify the client name for this machine.

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]

10. Type the appropriate number to install the latest software scripts and 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.
Installation Scripts Pack provides extra functions and latest support and fix performed during setup time. Please specify how you want to get this pack.

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

11. Press Enter. Keep Your Install Up to Date - Latest Service Pack

Latest Service Pack provides extra functions and latest support and fix for the packages you are going to install. You can download the latest service pack from software provider website.

If you decide 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.

Do you want to download the latest service pack now? [no]

12. Press Enter to accept the default path and continue, or

Enter a path to modify the default path and press Enter.

NOTES

  • Do not use the following characters when specifying the path:

    !@#$%^&*():/?\

Please specify where you want us to install Calypso binaries.

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]

13. Press Enter to accept the default location for the log files and continue, or

Enter a path to modify the default location and press Enter.

NOTES

  • All the modules installed on the computer will store the log files in this directory.
Please specify where you want to keep Calypso log files.

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]

14. Press Enter. Most of Calypso processes run with root privileges, but some are launched by databases and inherit database access rights. To make sure that registry and log files can be written to by both kinds of processes we can either make such files world-writeable or we can grant write access only to processes belonging to a particular group, e.g. a "calypso" or a "dba" group.

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]

15. If you indicated Yes in the previous step, you will be prompted for the group name that must be used to launch processes.

Enter the group name and then press Enter.

Please enter the name of the group which will be assigned to all Calypso files and on behalf of which all Calypso processes will run.

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

16. Type a network TCP port number for the Communications Service (CVD) and press Enter.

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

Every instance of Calypso should use a unique set of network ports to avoid interfering with other instances running on the same machine.

The port numbers selected must be from the reserved port number range and have not been registered by another application on this machine.

Please enter the port numbers.

Port Number for CVD : [8600]

Port Number for EvMgrC: [8602]

17. If this computer and the CommServe is separated by a firewall, type Yes and then press Enter.

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.

Is there a firewall between this client and the CommServe? [no]
18. Type the fully qualified domain name for CommServe Host Name and press Enter.

NOTES

  • Ensure that the CommServe is accessible before typing the name; otherwise the installation will fail.
Please specify hostname of the CommServe below. Make sure the hostname is fully qualified, resolvable by the name services configured on this machine.

CommServe Host Name:

19. Enter the number corresponding to the storage policy through which you want to back up the iDataAgent and press Enter. Please select one storage policy for this IDA from the list below:

1) SP_StandAloneLibrary2_2

2) SP_Library3_3

3) SP_MagLibrary4_4

Storage Policy: [1]

20. Type 3 to the Exit option and press Enter.

The installation is now complete.

Certain Calypso packages can be associated with a virtual IP, or in other words, installed on a "virtual machine" belonging to some cluster. At any given time the virtual machine's services and IP address are active on only one of the cluster's servers. The virtual machine can "fail-over" from one server to another, which includes stopping services and deactivating IP address on the first server and activating the IP address/services on the other server.

Currently you have Calypso installed on physical node stone.company.com.

Now you have a choice of either adding another package to the existing installation or configure Calypso on a virtual machine for use in a cluster.

1) Add another package to stone.company.com
2) Install Calypso on a virtual machine
3) Exit

Your choice: [1]

Method 2: Interactive Install

1. Place the Software Installation Disc on a client computer that satisfies the minimum requirements specified in the System Requirements.  
2. Run the following command from the Software Installation Disc:

./cvpkgadd

 
3. The product banner and other information is displayed.

Press Enter.

 
4. Read the license agreement. Type y and press Enter.  
5. Press Enter. Please select a setup task you want to perform from the list below:

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]

6. Enter the number corresponding to the binaries that you wish to install.

NOTES

  • Select 32 bit when installing on a 32-bit computer.
  • When installing on a 64-bit computer, if this is the first package, determine whether you want to install 32-bit binaries or 64 bit binaries.

    You can determine this by verifying whether all the components that you wish to install in this computer are supported in 64-bit in System Requirements.

    Note that when the first component is installed using 64-bit binaries, you cannot subsequently install another component using 32-bit. (Or vice-versa.)

This machine supports both 32 bit and 64 bit binaries. By default, we will install 32 bit binary set that has full support for all the modules included in this package. Please note that 64 bit binary set currently only support limited modules.

1) All platform (32 bit)

2) FS and MA only (64 bit)

Your choice: [1]

7. Press Enter. Certain Calypso packages can be associated with a virtual IP, or in other words, installed on a "virtual machine" belonging to some cluster. At any given time the virtual machine's services and IP address are active on only one of the cluster's servers. The virtual machine can "fail-over" from one server to another, which includes stopping services and deactivating IP address on the first server and activating the IP address/services on the other server.

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]

8. If you have only one network interface, press Enter to accept the default network interface name and continue.

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

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.
We found one network interface available on your machine. We will associate it with the physical machine being installed, and it will also be used by the CommServe to connect to the physical machine. Note that you will be able to additionally customize Datapipe Interface Pairs used for the backup data traffic later in the Calypso Java GUI.

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

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

9. Press Enter. Please specify the client name for this machine.

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]

10. Type the appropriate number to install External Data Connector.

A confirmation screen will mark your choice with an "X".

Type d for Done, and press Enter.

Install Calypso on physical machine 172.19.99.62

Please select the Calypso module(s) that you would like to install.

[ ] 1) MediaAgent [1301] [CVGxMA]>

[ ] 2) UNIX File System iDataAgent [1101] [CVGxIDA]

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

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

11. Press Enter. Do you want to use the agents for restore only without consuming licenses? [no]
12. Type the appropriate number to install the latest software scripts and 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.
Installation Scripts Pack provides extra functions and latest support and fix performed during setup time. Please specify how you want to get this pack.

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

13. Press Enter. Keep Your Install Up to Date - Latest Service Pack

Latest Service Pack provides extra functions and latest support and fix for the packages you are going to install. You can download the latest service pack from software provider website.

If you decide 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.

Do you want to download the latest service pack now? [no]

14. Press Enter to accept the default path and continue, or

Enter a path to modify the default path and press Enter.

NOTES

  • Do not use the following characters when specifying the path:

    !@#$%^&*():/?\

Please specify where you want us to install Calypso binaries.

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]

15. Press Enter to accept the default location for the log files and continue, or

Enter a path to modify the default location and press Enter.

NOTES

  • All the modules installed on the computer will store the log files in this directory.
Please specify where you want to keep Calypso log files.

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]

16. Type no.

NOTES

Most of Software processes run with root privileges, but some are launched by databases and inherit database access rights. To make sure that registry and log files can be written to by both kinds of processes we can either make such files world-writeable or we can grant write access only to processes belonging to a particular group, e.g. a "calypso" or a "dba" group.

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 Software processes, you will need to specify the access permissions later.

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

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

17. Type d for done. Access Permissions for Other Users

Installer will assign full access rights to root user and its belonging group for all installed Software files and its processes.

For any other users, you can specify the access permissions now.

However, since you chose not to assign a dedicated group in previous step, make sure you specify sufficient access rights for other users if you are also planning to install Software agents involving third party software protection.

[X] 1) Allow read permission to other users

[X] 2) Allow write permission to other users

[X] 3) Allow execute permission to other users

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

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

18. If you indicated Yes in Step 16., you will be prompted for the group name that must be used to launch processes.

Enter the group name and then press Enter.

NOTES

  • See your Unix systems administrator for assistance in creating a user group.
Please enter the name of the group which will be assigned to all Software files and on behalf of which all Software processes will run.

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

19. Type a network TCP port number for the Communications Service (CVD) and press Enter.

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

Every instance of Calypso should use a unique set of network ports to avoid interfering with other instances running on the same machine.

The port numbers selected must be from the reserved port number range and have not been registered by another application on this machine.

Please enter the port numbers.

Port Number for CVD : [8600]

Port Number for EvMgrC: [8602]

20. If this computer and the CommServe is separated by a firewall, type Yes and then press Enter.

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.

Is there a firewall between this client and the CommServe? [no]
21. Type the fully qualified domain name for CommServe Host Name and press Enter.

NOTES

  • Ensure that the CommServe is accessible before typing the name; otherwise the installation will fail.
Please specify hostname of the CommServe below. Make sure the hostname is fully qualified, resolvable by the name services configured on this machine.

CommServe Host Name:

22. Press Enter. Commcell Level Global Filters are set through Calypso GUI's Control Panel in order to filter out certain directories or files from backup Commcell-widely. If you turn on the Global filters, they will be effective to the default subclient. There are three options you can choose to set the filters.

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]

23. Type the number of a Client Group and press Enter.

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.
Client Group(s) is currently configured on CommServe cs.company.com. Please choose the group(s) that you want to add this client client.company.com to. The selected group(s) will be marked (X) and can be deselected if you enter the same number again. After you are finished with the selection, select "Done with the Selection".

[ ] 1) Unix

[ ] 2) DR

[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

24. Enter the number corresponding to the storage policy through which you want to back up the External Data Connector and press Enter. Please select one storage policy for this IDA from the list below:

1) SP_StandAloneLibrary2_2

2) SP_Library3_3

3) SP_MagLibrary4_4

Storage Policy: [1]

25. Type 3 to the Exit option and press Enter.

The installation is now complete.

Certain Calypso packages can be associated with a virtual IP, or in other words, installed on a "virtual machine" belonging to some cluster. At any given time the virtual machine's services and IP address are active on only one of the cluster's servers. The virtual machine can "fail-over" from one server to another, which includes stopping services and deactivating IP address on the first server and activating the IP address/services on the other server.

Currently you have Calypso installed on physical node stone.company.com.

Now you have a choice of either adding another package to the existing installation or configure Calypso on a virtual machine for use in a cluster.

1) Add another package to stone.company.com
2) Install Calypso on a virtual machine
3) Exit

Your choice: [1]

Method 3: Install Software from CommCell Console

1. From the CommCell Browser, select Tools | Add/Remove Software | Install Software.
2. Click Next.
3. Select Unix and Linux.

Click Next.

4. Select Manually Select Computers.

Click Next.

5. Enter the fully qualified domain name of the computer on which the NetBackup Server resides.

For example: apple.domain.company.com

The External Data Connector software will be installed on this client computer.

Click Next.

6. Click Next.
7. Specify UserName and Password of client computer.

Click Next.

8. Select External Data Connector.

Click Next.

9. Click Next.
10. Click Next.
11. Select Immediate.

Click Next.

12. Click Finish.
13. You can track the progress of the job from the Job Controller or Event Viewer window.
14. Once the job is complete, right-click the CommServe computer, click View and then click Admin Job History.
15. Select Install/Upgrade/Remove Software.

Click OK.

16. You can view the following details about the job by right-clicking the job:
  • Items that succeeded during the job
  • Items that failed during the job
  • Details of the job
  • Events of the job
  • Log files of the job