4.4 Installing and Registering a Framework Agent

Currently the Framework Agent is available for installation on the platforms listed below. For more information about the supported platforms, see Privileged Account Manager 3.5 System Requirements.

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

NOTE:Agents must be registered with the Framework Manager after installation. For more information about the command used to registering an agent, see the section Registering an Agent in the Privileged Account Manager Administration Guide.

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/netiq. To change this, create a directory in the required part of the file system and create a symbolic link to /opt/netiq.

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 <Installation package name>
  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> netiqnpam
  3. When installation is complete, check that the service is running by viewing the log file.

    The log file is located in /opt/netiq/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/netiq/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 (Optional)).

    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.

    For more information about the command used to registering an agent, see the section Registering an Agent in the Privileged Account Manager Administration Guide.

  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/netiq. To change this, create a directory in the required part of the file system and create a symbolic link to /opt/netiq.

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 <Installation package name>
  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/netiq/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/netiq/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 (Optional)).

    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.

    For more information about the command used to registering an agent, see the section Registering an Agent in the Privileged Account Manager Administration Guide.

  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/netiq. To change this, create a directory in the required part of the file system and create a symbolic link to /opt/netiq.

Prerequisite

When you are installing PAM agent in SLES 12 or later, ensure that LSB (Linux Standard Base) version 3.0 or later is installed.

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 <installation package name>.rpm
  2. After installation is complete, check that the service is running by viewing the log file.

    The log file is located in /opt/netiq/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/netiq/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 (Optional)).

    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.

    For more information about the command used to registering an agent, see the section Registering an Agent in the Privileged Account Manager Administration Guide.

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

4.4.4 Windows Agent Installation

In Windows environment, you can install the agents in the following ways: Interactive installation and Silent installation. The silent or unattended installation is useful when you need to install the agent in more than one server.

  1. (Conditional) For interactive installation, perform the following:

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

      <Installation file name>.msi

    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\Netiq\npum folder.

  2. (Conditional) For silent installation, use the following command:

    Syntax: msiexec /i <Installer Filename> /passive

    For more information about other msiexec command-line options, see Microsoft documentation.

  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\Netiq\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. Run the following command to register the agent with the Framework Manager, from the machine where the agent is installed.

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

    NOTE:Open cmd.exe with the Run as administrator option to run this command.

    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 (Optional)).

    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.

    For more information about the command used to registering an agent, see the section Registering an Agent in the Privileged Account Manager Administration Guide.

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

    For information, refer to Accessing the Console, and then Downloading and Installing NetIQ Privileged Account Manager License.

4.4.5 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/netiq. To change this, create a directory in the required part of the file system and create a symbolic link to /opt/netiq.

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 <Installation package name>
  2. After the Solaris installation package is uncompressed, use the following command to install the agent:

    pkgadd -d /<directory of .pkg file>/<installation package name>.pkg
  3. After installation is complete, check that the service is running by viewing the log file.

    The log file is located in /opt/netiq/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/netiq/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 (Optional)).

    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.

    For more information about the command used to registering an agent, see the section Registering an Agent in the Privileged Account Manager Administration Guide.

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