How to Install the BrightStor SRM UNIX / Linux Agent

Document ID : KB000055668
Last Modified Date : 14/02/2018
Show Technical Document Details

Manually Installing the BrightStor SRM UNIX\ Linux Agent

General Information:

BrightStor SRM automatically installs the UNIX Agent during the registration of UNIX / Linux computers. If you want to install the agent manually, however, you can use the following procedure.

Note:

You need Superuser (root) access rights to install and configure the RSC server

Agent file location:

  • Copy the appropriate TAR file from the CD-ROM or from SRM Application server and paste it into temporary directory on the UNIX workstation. You can find the TAR files in the following directory on the CD-ROM:

    Application Server\Software\Intel\Config\InstallAgent\UNIX

    Or on SRM application server:

    \\..Brightstor srm data\Database\configuration\installagent\unix

The following table displays the correct TAR file to copy:

OSTAR File
IBM AIX aix-4.1.tar
aix-4.3.tar
Sun Solaris Sol7.tar
HP-UX hpux-10.20.tar
hpux-11.tar
Linux linux.tar
z/OS and OS/390 linux390.tar

Aix, Linux, HP-UX:

  1. Unzip the UNIX installation bundle to a temporary directory using the following command for, HP, and AIX:

    tar xvf <unix.tar>

    Note: For Linux use this command: tar xvfP <unix.tar>

  2. Change to the temporary directory and run the deploy script. You can choose from the following options when running this script: To run the agent normally, use the following command, supplying an installation directory in the format shown:

    ./deploy <full_installation_directory_path>

    For example:

    ./deploy /usr/rsc

    Note: The installation directory cannot be a subdirectory of /usr/rsc.

    • To set a fixed port number for all the communication that occurs between the UNIX agent and the BrightStor SRM Application Server (for example, if you are working behind a firewall), use this command:

      ./deploy -p <portnum> <full_installation_directory_path>


    When the installation ends successfully, the following message appears:

    Rscd deployment finished successfully

  3. Register the UNIX computer with the SRM Windows client registration wizard.

SOLARIS:

Notes:

  • The UNIX Agent is installed as a daemon only on Solaris machines.

  • You need Superuser (root) access rights to install and configure the RSC server.

  • If you are installing the BrightStor SRM UNIX agent on a 32-bit SunOS 5.6 system, you must update the system with the patch 105401-12 provided on the Sun Support CD-ROM or available at:

    http://sunsolve.sun.com/pub-cgi/show.pl?target=patchpage

  • If the node name and the host name of the UNIX computers are different, the data collection fails.
  1. Unzip the UNIX installation bundle to a temporary directory using the following command for Solaris:

    tar xvf <unix.tar>

  2. Change to the temporary directory and run the deploy script.

    • As a daemon, use this command:

      ./deploy -d <full_installation_directory_path>

      For example:

      ./deploy "d /usr/rsc


    Note: The installation directory cannot be a subdirectory of /usr/rsc.

    • To set a fixed port number for all the communication that occurs between the UNIX agent and the BrightStor SRM Application Server (for example, if you are working behind a firewall), use this command:

      ./deploy - d - p <portnum> <full_installation_directory_path>

    When the installation ends successfully, the following message appears:

    Rscd deployment finished successfully

  3. Register the UNIX computer with the SRM Windows client registration wizard.

Failed Installations

If the installation of the UNIX agent fails, an error message displays. See the following table for solutions on resolving the error:

Error Message Resolution
Error 1: file <filename> could not be found.

If the missing file is one of the installation files, ensure that you have the proper permissions to copy the files to the installation directory.

If the missing file is a system file (such as/etc/rpc, or /etc/inetd.conf) that does not reside in the expected place, make a soft link (ln "s) that points to the actual location of the file.

Error 4: user is not root.Identify root user (su -) and run again.
Error 6: System is not supported by the productThe target computer's OS is not supported. See the README file for a list of supported operating systems.
Error 7: RPC service is not configured properly or not active.Ensure that the RPC services on your computer are working.
Error 8: failed to refresh the inetd process.RPC registration failed, typically because the inetd process did not refresh. Stop and restart the inetd process.
Error 9: not enough space on the file system to install BrightStor rscd. Choose an installation directory with at least 15 MB of free disk space.
Error 10: Installation Directory must begin with /. Run the installation again using the full path of the installation directory.
Error 11: Installation Directory must not be a subdirectory of /usr/rsc. You cannot install to a subdirectory or /usr/rsc. Run the installation again and choose a different installation directory.

Uninstalling the BrightStor SRM UNIX Agents

To uninstall the BrightStor SRM UNIX agents on BrightStor SRM, follow these steps:

Note: You must ensure you have Superuser (root) access rights.

  1. Change to the following directory:

    /usr/rsc

  2. Run the deploy script with the --remove parameter enabled:

    ./deploy --remove