Deploy Secondary Hubs and Robots on Linux

This article describes the process for deploying hubs and robots using the nimldr utility.
uim901
Install_nimldr
This article describes the process for deploying hubs and robots using the nimldr utility.
2
2
Understand The nimldr Utility
The
nimldr
utility installs secondary hubs and robots on Linux . You can run nimldr in express mode to perform a silent installation.
Cloud deployment is not supported on AIX.
Flags for nimldr
You can execute nimldr with flags to modify how the installer runs, or to specify information.
Usage
Flag
Description
All installations
-?
Help
-d
Debug level, 0 - 5 (default, 0)
-l
Installation logfile
-t
Location for temporary files during installation; default is
/opt/nimsoft/tmp
-D
NimBUS domain name
-H
NimBUS hub name
-N
Override robot name Default,
robot_hostname
-p
NimBUS installation path; Default,
/opt/nimsoft
-f
Override package file name. The default installation file is detected by the program.
Note
: The file name is case-sensitive. Omit the .zip extension.
-u
Install as the current user, and not as root (
not
recommended).
-o
First probe port
If you omit this flag (recommended), the system assigns the first probe to port
48000
, or the first available subsequent port. Specify any available port. The port number increments by 1 for each subsequent assignment.
-R
The IP address for the robot
-a
Set the automatic unregister flag. Default,
no
-s
Set the robot to passive mode
-A
set
robotip_alias
for NAT. This is a special case, use caution.
-v
Print the version of
nimldr.
-h
Print this help text.
Installation file is on local system
-F
If the installation file is on the local system, specify the directory containing the installation file.
Installation file is on a NimBUS Distribution Server
-I
The IP address of the NimBUS hub running a Distribution Server. This parameter overrides the
-H
flag.
-U
The username for logging in to the hub.
-S
The password for logging in to the hub.
-V
Package version Use the specified version of the package, and not the latest one.
Installation modes
-r
Install only the robot (default)
-i
Install an Infrastructure (robot, hub, nas, and distsrv)
-E
Express installation This method uses the defaults, or supplied flags.  The installation file must be on the local system.
-X
Silent express installation If there is an error, this method fails instead of going to interactive mode. The installation file must be on the local system.
Cloud installation
(
option not available for AIX systems
)
-C
The number of restarts until robot is expected to become active
-M
DNS name of the system running the hub
nimldr Robot and Hub Questions
During the install process, the nimldr utility prompts you to answer questions. The following table lists all the potential questions. Not all questions are asked. Some questions depend on your answers to previous questions, and some depend on the type of installation you are performing.
In the installer, the default answers are in brackets. Press
Enter
to accept the default.
Question
Answer
Where should nimldr store temporary files?
opt/nimsoft/tmp
(default)
Directory of your choice
Do we have the installation file locally?
Yes
No
Where do we have the installation file(s)?
Path
to installation files
Is there a host running a hub we can query for the installation file?
Yes
No
What is the IP address of the host running a hub?
IP address
What is the Domain called?
Domain name
(if it exists)
Desired name
(if it is created)
*
(asterisk) to search for domains
What is the hub called?
Hub name
(if it exists)
Desired name
(if it is created)
*
to search for hubs
What is the installation file called?
install_
platform
Which of these archives would you like to connect to?
Archive name
Enter username and password.
Username
and
password
for the administrator account set up during UIM installation
Where do we have the installation files?
Install file directory
(if local)
What are we installing?
1
(robot only)
2
(robot and hub, tunnel server, or tunnel client)
Would you like to install the Distribution Server (distsrv)?
distsrv is the UIM probe archive
Yes
No
Where should the software be installed?
/opt/nimsoft
(default)
Automatically unregister robot from hub on termination?
No
(default)
Yes
Should this robot run in passive mode?
No
(default; robot sends data to hub)
Yes
(hub must request data from robot)
What is this Domain called?
Domain
set up during UIM installation
Which hub should this robot connect to?
Hub name
What is this hub called?
Hub name
What is that hub's IP address?
IP address
Are you setting up a tunnel between this hub and another hub?
Yes
No
Would you like to initialize the security settings on this hub?
Yes
(default)
No
Please specify the administrator user password.
Password
for the account created during UIM installation
Are you setting up a tunnel between this hub and another hub?
No
(default, installation completes and the installer exits)
Yes
(installation continues)
Nimldr Tunnel Client Questions
Answer the following questions to set up a tunnel client hub.
Question
Answer
What is the IP address of the tunnel server hub?
Tunnel server hub IP address
What port is the server listening on?
Port number assigned during UIM installation; typically 48000 (default)
What password was used to generate this certificate?
Password that is defined when the tunnel client certificate was created during tunnel server setup
What file is the client certificate in?
Path and file name for the client certificate that was copied from the tunnel server to the tunnel client
Run the nimldr Utility
Run the nimldr utility to install secondary hubs and robots.
Follow these steps:
  1. If UIM software is installed and running on the system, turn off all UIM processes and remove the software. Execute:
    /opt/Nimsoft/bin/niminit stop /opt/Nimsoft/bin/inst_init.sh remove
  2. Verify that the system
    /etc/hosts
    file maps 127.0.0.1 to localhost, and its own IP address to its hostname.
  3. Download and unpack the installers:
    1. On the client computer, browse to your UIM Server home page:
      http://
      server_name_or_IP
      :<wasp_port>/uimhome
      The default wasp port number is 80.
      Click the
      Installers
      tab. Under
      Infrastructure Installers
      , select
      UNIX installation utility (nimldr) for all platforms
      , and save the archive on the client. If the client system does not have a browser, download the installer to another computer and copy it to the client. Ensure the file is named
      nimldr.tar.Z
      .
    2. Uncompress and extract the file,
      nimldr.tar.Z
      , using the tar command:
      # tar -xzf nimldr.tar.Z
      This command creates the subdirectories that contain nimldr installers for various Linux platforms.
      On certain non-Linux UNIX platforms, the tar command does not contain the
      -z
      option. In such cases, follow these steps:
      1. Use
        uncompress nimldr.tar.Z
        or
        gunzip nimldr.tar.Z
        to uncompress nimldr.tar.Z file.
      2. Use
        tar -xf nimldr.tar
        or
        tar -xvf nimldr.tar
        to extract the contents of the nimldr.tar file.
  4. Enter the appropriate subdirectory for your platform. For example,
    LINUX_23_64
    .
  5. Change the file permissions to add executable permissions for the file owner:
    # chmod 755 nimldr
  6. Launch the installer. If the client is on the:
    • Same network segment as the primary hub, execute:
      # ./nimldr
    • Different network segment, execute:
      # ./nimldr -I NMS_server_name_or_IP_address
  7. Answer the nimldr questions to install the hub.
  8. If you are installing a tunnel server hub:
    1. Answer the nimldr tunnel server questions. The values are used to generate the tunnel client certificate, and save it to a file.
    2. Copy the certificate file to the tunnel client hub. After installation, install the certificate on the tunnel client hub.
  9. If you are installing a tunnel client hub:
    1. Ensure that the certificate file resides on the hub.
    2. Answer the nimldr tunnel client questions.
Installation progress is logged in the
nimldr.log
file, typically located in
opt/nimsoft/tmp
. To view it, execute:
tail -f /opt/nimsoft/tmp/nimldr.log
Example: Perform an Installation with a Local File
This example provides high-level steps to perform an installation with a local file.
Follow these steps:
  1. Copy
    install_LINUX_23_64-7_93.zip
    to a directory on the computer, such as
    /opt
    .
  2. Rename the version information from the install file
    install_LINUX_23_64-7_93.zip
    to
    install_LINUX_23_64.zip
    .
  3. Run
    ./nimldr
    from the
    LINUX_23_64
    directory.
  4. Specify
    y
    when the installer prompts you to specify whether the installation file is available locally (
    Do we have the installation file locally?
    ).
  5. Specify
    /opt
    when the installer prompts you to specify the installation file location (
    Where do we have the installation file(s)?
    ).
  6. Continue with the remaining installation steps.
Next Steps
  • Set up queues and tunnels between hubs. See the Hub probe documentation on the Probes Documentation Space for more information.
  • If you want to use Admin Console to manage this hub or its child robots or probes, deploy the Probe Provisioning Manager (ppm) probe to the hub. Use either Admin Console or Infrastructure Manager to deploy the probe from your local archive.