4.4 Installing and Registering a Framework Agent

Currently the Framework Agent is available for installation on the platforms listed below.  Refer to Section 2.3, Supported Platforms for more information regarding supported versions.

For detailed installation instructions for your platform, select from the list below:

NOTE:Agents must be registered with the Framework Manager after installation.

4.4.1 AIX Agent Install

The AIX installation package is compressed through gzip. In order to install the package, you must unzip the package through gunzip.  

By default, the installation program installs the software into /opt/novell. To change this, create a directory in the required part of the file system and create a symbolic link to /opt/novell.

To install the AIX agent:

  1. Copy the installation package to a temporary location and use the following command to extract the installation files:

    gunzip <filename>
    

    See the “NetIQ Privileged User Manager Readme” for the actual filename.

  2. After the AIX installation package is uncompressed, use one of the following methods to perform the installation.

    • The AIX smitty program

    • The following command:

      installp -acgNQqwX -d <directory of .bff file> netiqnpum
      
  3. When installation is complete, check that the service is running by viewing the log file.

    The log file is located in /opt/novell/npum/logs/unifid.log, if the default install location was used. If the agent installed correctly, it should be listening on 0.0.0.0:29120.

  4. Use the following command to register the agent with the Framework Manager. This command must be issued from the machine where the agent is installed.

    /opt/novell/npum/sbin/unifi regclnt register

    Four items of information are required:

    The registration server hostname: The hostname or IP address of the Framework Manager.

    The registration server port: Accept the default unless another application is using this port. After the host is registered, this port cannot be modified.

    The name or IP address of this host: The DNS name or IP address by which any other agent in the Framework can resolve the location of this machine on your network.

    The name of this agent: The name of the agent when it was created in the Framework Console (refer to Creating a Host Name for Each Agent).

    NOTE:When the above details have been provided, a valid username and password for the Framework Manager are required to complete the registration of the agent.

  5. Verify that the registration has been successful by viewing the host details on the Framework Console.

4.4.2 HP-UX Agent Install

The HP-UX installation package is compressed through gzip. In order to install the package, you must unzip the package through gunzip.  

By default, the installation program installs the software into /opt/novell. To change this, create a directory in the required part of the file system and create a symbolic link to /opt/novell.

To install the HP-UX agent:

  1. Copy the installation package to a temporary location and use the following command to extract the installation files:

    gunzip <filename>

    See the “NetIQ Privileged User Manager Readme” for the actual filename.

  2. After the HP-UX installation package is uncompressed, use the following command to install the agent:

    swinstall -s /<directory of .depot file>/<filename>.depot \*

  3. After installation is complete, check that the service is running by viewing the log file.

    The log file is located in /opt/novell/npum/logs/unifid.log, if the default install location was used. If the agent installed correctly, it should be listening on 0.0.0.0:29120.

  4. Use the following command to register the agent with the Framework Manager. This command must be issued from the machine where the agent is installed.

    /opt/novell/npum/sbin/unifi regclnt register

    Four items of information are required:

    The registration server hostname: The hostname or IP address of the Framework Manager.

    The registration server port: Accept the default unless another application is using this port. After the host is registered, this port cannot be modified.

    The name or IP address of this host: The DNS name or IP address by which any other agent in the Framework can resolve the location of this machine on your network.

    The name of this agent: The name of the agent when it was created in the Framework Console (refer to Creating a Host Name for Each Agent).

    NOTE:When the above details have been provided, a valid username and password for the Framework Manager are required to complete the registration of the agent.

  5. Verify that the registration has been successful by viewing the host details on the Framework Console.

4.4.3 Linux Agent Installation

Linux hosts use the RPM packaging system for installation, upgrade, and removal.

By default, the installation program installs the software into /opt/novell. To change this, create a directory in the required part of the file system and create a symbolic link to /opt/novell.

To install the Linux agent:

  1. Copy the installation package to a temporary location and use the following command to install the file:

    rpm -i <filename>.rpm

    See the “NetIQ Privileged User Manager Readme” for the actual filename.

  2. After installation is complete, check that the service is running by viewing the log file.

    The log file is located in /opt/novell/npum/logs/unifid.log, if the default install location was used. If the agent installed correctly, it should be listening on 0.0.0.0:29120.

  3. Use the following command to register the agent with the Framework Manager. This command must be issued from the machine where the agent is installed.

    /opt/novell/npum/sbin/unifi regclnt register

    Four items of information are required:

    The registration server hostname: The hostname or IP address of the Framework Manager.

    The registration server port: Accept the default unless another application is using this port. After the host is registered, this port cannot be modified.

    The name or IP address of this host: The DNS name or IP address by which any other agent in the Framework can resolve the location of this machine on your network.

    The name of this agent: The name of the agent when it was created in the Framework Console (refer to Creating a Host Name for Each Agent).

    NOTE:When the above details have been provided, a valid username and password for the Framework Manager are required to complete the registration of the agent.

  4. Verify that the registration has been successful by viewing the host details on the Framework Console.

4.4.4 SLES Agent Installation

SLES hosts use the RPM packaging system for installation, upgrade and removal. You can also use the zypper or rug command line interface.

By default, the installation program installs the software into /opt/novell. To change this, create a directory in the required part of the file system and create a symbolic link to /opt/novell.

To install the SLES agent:

  1. Copy the installation package to a temporary location and use the following command to install the file:

    rpm -i <filename>.rpm

    See the “NetIQ Privileged User Manager Readme” for the actual filename.

  2. After installation is complete, check that the service is running by viewing the log file.

    The log file is located in /var/opt/novell/npum/logs/unifid.log, if the default install location was used. If the agent installed correctly, it should be listening on 0.0.0.0:29120.

  3. Use the following command to register the agent with the Framework Manager. This command must be issued from the machine where the agent is installed.

    /opt/novell/npum/sbin/unifi regclnt register

    Four items of information are required:

    The registration server hostname: The hostname or IP address of the Framework Manager.

    The registration server port: Accept the default unless another application is using this port. After the host is registered, this port cannot be modified.

    The name or IP address of this host: The DNS name or IP address by which any other agent in the Framework can resolve the location of this machine on your network.

    The name of this agent: The name of the agent when it was created in the Framework Console (refer to Creating a Host Name for Each Agent).

    NOTE:When the above details have been provided, a valid username and password for the Framework Manager are required to complete the registration of the agent.

  4. Verify that the registration is successful by viewing the host details on the Framework Console.

4.4.5 Windows Agent Installation

  1. Run the following install executable to start the installation:

    <filename>.exe

    See the “NetIQ Privileged User Manager Readme” for the actual filename.

  2. Follow the steps in the install wizard.

    The Agent service can be installed on any part of the normal file system. It defaults to the C:\Program Files\Novell\npum folder.

  3. After installation is complete, check that the service is running by viewing the log file.

    The log file is located in C:\Program Files\Novell\npum\logs\unifid.log, if the default install location was used. If the agent installed correctly, services should be listening on 0.0.0.0:29120 and 0.0.0.0:443.

  4. Use the following command to register the agent with the Framework Manager. This command must be issued from the machine where the agent is installed.

    <install_path>/novell/npum/bin/unifi.exe regclnt register

    Four items of information are required:

    The registration server hostname: The hostname or IP address of the Framework Manager.

    The registration server port: Accept the default unless another application is using this port. After the host is registered, this port cannot be modified.

    The name or IP address of this host: The DNS name or IP address by which any other agent in the Framework can resolve the location of this machine on your network.

    The name of this agent: The name of the agent when it was created in the Framework Console (refer to Creating a Host Name for Each Agent).

    NOTE:When the above details have been provided, a valid username and password for the Framework Manager are required to complete the registration of the agent.

  5. If you have been supplied with a license, log in to the Framework Console and install the license.

    For information, refer to Section 3.2, Accessing the Framework Console, and then Section 3.3, Installing a NetIQ Privileged User Manager License.

4.4.6 Solaris Agent Install

The Solaris installation package is compressed through gzip. In order to install the package, you must unzip the package through gunzip.  

By default, the installation program installs the software into /opt/novell. To change this, create a directory in the required part of the file system and create a symbolic link to /opt/novell.

To install the Solaris agent:

  1. Copy the installation package to a temporary location and use the following command to extract the installation files:

    gunzip <filename>

    See the “NetIQ Privileged User Manager Readme” for the actual filename.

  2. After the Solaris installation package is uncompressed, use the following command to install the agent:

    pkgadd -d /<directory of .pkg file>/<filename>.pkg

    See the “NetIQ Privileged User Manager Readme” for the actual filename.

  3. After installation is complete, check that the service is running by viewing the log file.

    The log file is located in /opt/novell/npum/logs/unifid.log, if the default install location was used. If the agent installed correctly, it should be listening on 0.0.0.0:29120.

  4. Use the following command to register the agent with the Framework Manager. This command must be issued from the machine where the agent is installed.

    /opt/novell/npum/sbin/unifi regclnt register

    Four items of information are required:

    The registration server hostname: The hostname or IP address of the Framework Manager.

    The registration server port: Accept the default unless another application is using this port. After the host is registered, this port cannot be modified.

    The name or IP address of this host: The DNS name or IP address by which any other agent in the Framework can resolve the location of this machine on your network.

    The name of this agent: The name of the agent when it was created in the Framework Console (refer to Creating a Host Name for Each Agent).

    NOTE:When the above details have been provided, a valid username and password for the Framework Manager are required to complete the registration of the agent.

  5. Verify that the registration has been successful by viewing the host details on the Framework Console.

4.4.7 Tru64 Agent Install

The Tru64 installation package is compressed through gunzip. In order to install the package you must unzip the package through gunzip.  

By default, the installation program installs the software into /opt/novell. To change this, create a directory in the required part of the file system and create a symbolic link to /opt/novell.

To install the Tru64 agent:

  1. Copy the installation package to a temporary location and use the following command to extract the installation files:

    gunzip <filename>
    tar –xvf <filename>
    

    See the “NetIQ Privileged User Manager Readme” for the actual filename.

  2. After the Tru64 installation package is uncompressed, use the following command to install the agent:

    setld -l NETIQNPUM/
    
  3. After installation is complete, check that the service is running by viewing the log file.

    The log file is located in /opt/novell/npum/logs/unifid.log, if the default install location was used. If the agent installed correctly, it should be listening on 0.0.0.0:29120.

  4. Use the following command to register the agent with the Framework Manager. This command must be issued from the machine where the agent is installed.

    /opt/novell/npum/sbin/unifi regclnt register

    Four items of information are required:

    The registration server hostname: The hostname or IP address of the Framework Manager.

    The registration server port: Accept the default unless another application is using this port. After the host is registered, this port cannot be modified.

    The name or IP address of this host: The DNS name or IP address by which any other agent in the Framework can resolve the location of this machine on your network.

    The name of this agent: The name of the agent when it was created in the Framework Console (refer to Creating a Host Name for Each Agent).

    NOTE:When the above details have been provided, a valid username and password for the Framework Manager are required to complete the registration of the agent.

  5. Verify that the registration has been successful by viewing the host details on the Framework Console.