Installing NimBUS Infrastructure on Unix
========================================

This section describes two scenarios:
- Installing NimBUS Infrastructure on a unix computer on your internal network.
- Installing NimBUS Infrastructure on a unix computer in a DMZ.


--------------------------------------------------------------------------------

First some nimldr usage information (may be useful in the procedures below): 

[root@anton /tmp]# ./nimldr -h
Usage: ./nimldr [flags]
Common flags:
        -d <debuglevel 0-5>
            default=0
        -l <installation logfile>
            default=nimldr.log
        -t <path to use for temporary files during installation>
            default=/opt/nimbus/tmp
        -D <NimBUS Domain name>
        -H <NimBUS Hub name>
        -p <NimBUS installation path>
            default=/opt/nimbus
	-f <package file name>
	    default installation file is detected by the system
	    NOTE: Case sensitive, and without the .zip extension
        -u install as current user, not as root
            NOTE: This is NOT recommended!
        -v prints version of ./nimldr
        -h prints this help text

Installation file on local machine:
        -F <directory containing installation file>

Installation file on a NimBUS Distribution Server:
        -I <IP address of NimBUS Hub running a Distribution Server>
            NOTE: This will override the -H option
	-V <package version>
	    get the specified version of the package, not the latest one
Installation modes:
        -r install Robot only (default mode)
        -i install Infrastructure (Robot, Hub, Nas and Distsrv)
        -E express installation (uses defaults or supplied flags)


Copyright(c) 1998-2007, Nimsoft Corp.

-------------------------------------------------------------------------------

Express installation allows you to set all parameters on the commandline, and 
the nimldr will use these values (or default values if none are supplied) for 
the installation. This allows installations to be scripted, which can be useful
for large-scale implementations.



1. Installing NimBUS Infrastructure on a unix computer on your internal network
========================================================= 

In this case you have to copy the following file from the NimBUS Web Server 
application and bring them to the DMZ host (e.g. using a CD or ftp):


- nimldr for all unix platforms. 
Copy the file to a folder on the DMZ host.

Note in the example below: the installation archive for your unix type will be 
downloaded from an archive on a NimBUS Hub (193.71.55.147 in the example below).


Uncompress the file:
# uncompress nimldr.tar.Z

Extract nimldr.tar (this makes a directory on your disk with tree-
structure, where you can access the different UNIX platforms): 
# tar xf nimldr.tar

Enter the sub-directory to which your UNIX platform was copied 
(e.g. LINUX) and run nimldr. 
 
# ./nimldr 




a) Robot installation, installation file on a distsrv
==================

[root@rhfc4-dev tmp]# ./nimldr

This program will help you install NimBUS on the current system.
You will be given a series of questions, default answers are in brackets:
  query? ==>[default]
Pressing Enter directly will use the default value, otherwise you should
type in the requested information.

If express installation is specified, the default value will be used
automatically.

A log of the installation is found in the file: nimldr.log

What are we installing? (1=Robot,2=Infrastructure)
==>[1]

Where should nimldr store temporary files?
==>[/opt/nimbus/tmp]
Beginning Robot installation:

Do we have the installation file locally?
==>[no]

Is there a host running a NimBUS Hub we can query for the installation file?
==>[yes]

What is the IP address of the host running a NimBUS Hub?
==>[] 193.71.55.147

Preparing to search for Archives:

What is the NimBUS Domain called (*=search)?
==>[Development]

What is the NimBUS Hub called (*=search)?
==>[StianServer]

What is the installation file called?
==>[install_linux]

Searching for Archives:
 1 /Development/StianServer/wsstian/distsrv

We need to log in to NimBUS to query the Archive
Enter NimBUS username and password...
        Username: administrator
        Password:
Beginning download of install_linux
-
Done!
Extracting files from archive /opt/nimbus/tmp//install_linux.zip to temp directory /opt/nimbus/tmp/

Where should NimBUS be installed?
==>[/opt/nimbus]

What is this NimBUS Domain called?
==>[Development]

Which NimBUS Hub should this Robot connect to?
==>[StianServer]

What is that NimBUS Hub's IP address?
==>[193.71.55.147]
Starting NimBUS:

Cleaning up temporary files
Finished Robot installation!
[root@rhfc4-dev tmp]#

 
b) Hub installation, installation file on local disk
================


[root@rhfc4-dev tmp]# ./nimldr

This program will help you install NimBUS on the current system.
You will be given a series of questions, default answers are in brackets:
  query? ==>[default]
Pressing Enter directly will use the default value, otherwise you should
type in the requested information.

If express installation is specified, the default value will be used
automatically.

A log of the installation is found in the file: nimldr.log

What are we installing? (1=Robot,2=Infrastructure)
==>[1] 2
A NimBUS Robot and Hub will be installed.

Would you like to install the NimBUS Alarm Server (nas)?
==>[yes]

Would you like to install the Distribution Server (distsrv)?
==>[yes]

Where should nimldr store temporary files?
==>[/opt/nimbus/tmp]
Beginning Robot installation:

Do we have the installation file locally?
==>[no] yes

Where do we have the installation file(s)?
==>[] /tmp
Extracting files from archive /tmp/install_linux to temp directory /opt/nimbus/tmp/

Where should NimBUS be installed?
==>[/opt/nimbus]

What is this NimBUS Domain called?
==>[] Development

What is this NimBUS Hub called?
==>[rhfc4-dev]

What is this NimBUS Hubs IP address?
==>[193.71.55.49]
Starting NimBUS:

Waiting for Hub to start...
distsrv: NimBUS home '/opt/nimbus' found from NIM_ROOT variable

Are you setting up a NimBUS Tunnel between this Hub and another Hub?
==>[no] 

Would you like to initialize the security settings on this Hub?
==>[yes]

Please specify the administrator user password:
        Type password:
        Retype password:
Initializing security for this Hub...Security initialized!
Cleaning up temporary files
Finished Robot installation!
[root@rhfc4-dev tmp]#





2. Installing NimBUS Infrastructure on a unix computer in a DMZ
=============================================================

Copy the following files from the NimBUS Web Server application
and bring them to the DMZ host (e.g. using a CD or ftp): 

- nimldr for all unix platforms (to install NimBUS infrastructure components 
and DMZ on the DMZ host. 
- Installation archive for your unix type.

Copy the files into a folder on the DMZ host.

Procedure:
Uncompress the file:  
# uncompress nimldr.tar.z 

Extract nimldr.tar (this makes a directory on your disk with tree-structure, 
where you can access the different UNIX platforms):  
# tar xf nimldr.tar 

Enter the sub-directory to which your UNIX platform was copied (e.g. Linux) and 
run nimldr. 

a) Hub installation, Tunnel server
======================
This section applies to a installation where you install the tunnel server 
component on the DMZ host, and then brings the client certificate file (and 
password) to the hub on the outside and installs the tunnel client component 
there.

[root@rhfc4-dev tmp]# ./nimldr

This program will help you install NimBUS on the current system.
You will be given a series of questions, default answers are in brackets:
  query? ==>[default]
Pressing Enter directly will use the default value, otherwise you should
type in the requested information.

If express installation is specified, the default value will be used
automatically.

A log of the installation is found in the file: nimldr.log

What are we installing? (1=Robot,2=Infrastructure)
==>[1] 2
A NimBUS Robot and Hub will be installed.

Would you like to install the NimBUS Alarm Server (nas)?
==>[yes]

Would you like to install the Distribution Server (distsrv)?
==>[yes]

Where should nimldr store temporary files?
==>[/opt/nimbus/tmp]
Beginning Robot installation:

Do we have the installation file locally?
==>[no] yes

Where do we have the installation file(s)?
==>[] /tmp
Extracting files from archive /tmp/install_linux to temp directory /opt/nimbus/tmp/

Where should NimBUS be installed?
==>[/opt/nimbus]

What is this NimBUS Domain called?
==>[] Development

What is this NimBUS Hub called?
==>[rhfc4-dev]

What is this NimBUS Hubs IP address?
==>[193.71.55.49]
Starting NimBUS:

Waiting for Hub to start...

Are you setting up a NimBUS Tunnel between this Hub and another Hub?
==>[no] yes

Is this Hub going to be a Tunnel Server?
==>[no] yes

Setting up the Server:

The Server needs to generate a CA certificate
This certificate will be used to sign Client certificates


What is the name of your orgainzation?
==>[My Company Inc.] Nimsoft Corp.

What is the name of the organizational unit?
==>[SysAdmin] Development

What is the administrator email address?
==>[sysadmin@my.company.com] root@rhfc4-dev.nimsoft.com
What password should we use for the Server certificate?
        Type password:
        Retype password:
Generating CA certificate - this may take a few moments...
Done generating CA certificate!

Creating a Client Certificate:

The Client will need this certificate to connect to this Server


What is the IP address of the Client Hub?
==>[] 193.71.55.147

What is the name of your orgainzation?
==>[Nimsoft Corp.]

What is the name of the organizational unit?
==>[Development]

What is the administrator email address?
==>[root@rhfc4-dev.nimsoft.com]
What password should we use for this certificate?
        Type password:
        Retype password:

What file should the certificate be written to (full path)?
==>[/opt/nimbus/client.txt] /tmp/193.71.55.147.txt

Generating Client certificate - this may take a few moments...
Done creating Client certificate /tmp/193.71.55.147.txt

Would you like to initialize the security settings on this Hub?
==>[yes]

Please specify the administrator user password:
        Type password:
        Retype password:
Initializing security for this Hub...Security initialized!
Cleaning up temporary files
Finished Robot installation!
[root@rhfc4-dev tmp]#
--------------------------------------------------------------------------------

NOTE: 
Copy the file /opt/nimbus/193-71-55-147.txt to removable medium or transfer 
electronically to 193.71.55.147 and set up Tunnel Client there. Communication 
will be possible between the two systems on port 48003/tcp.


 
b) Hub installation, Tunnel Client
=======================
This section applies to a installation where you install the tunnel client 
component. Note that you will need client certificate file (and password) 
generated when you installed the tunnel server component.

[root@rhfc4-dev tmp]# ./nimldr

This program will help you install NimBUS on the current system.
You will be given a series of questions, default answers are in brackets:
  query? ==>[default]
Pressing Enter directly will use the default value, otherwise you should
type in the requested information.

If express installation is specified, the default value will be used
automatically.

A log of the installation is found in the file: nimldr.log

What are we installing? (1=Robot,2=Infrastructure)
==>[1] 2
A NimBUS Robot and Hub will be installed.

Would you like to install the NimBUS Alarm Server (nas)?
==>[yes]

Would you like to install the Distribution Server (distsrv)?
==>[yes]

Where should nimldr store temporary files?
==>[/opt/nimbus/tmp]
Beginning Robot installation:

Do we have the installation file locally?
==>[no] yes

Where do we have the installation file(s)?
==>[] /tmp
Extracting files from archive /tmp/install_linux to temp directory /opt/nimbus/tmp/

Where should NimBUS be installed?
==>[/opt/nimbus]

What is this NimBUS Domain called?
==>[] Development

What is this NimBUS Hub called?
==>[rhfc4-dev]

What is this NimBUS Hubs IP address?
==>[193.71.55.49]
Starting NimBUS:

Waiting for Hub to start...

Are you setting up a NimBUS Tunnel between this Hub and another Hub?
==>[no] yes

We need to login to NimBUS to set Tunnel options
Enter NimBUS username and password...
        Username: administrator
        Password:

Is this Hub going to be a Tunnel Server?
==>[no]

Is this Hub going to be a Tunnel Client?
==>[yes]

What is the IP address of the Tunnel Server Hub?
==>[] 193.71.55.147

What port is the Server listening on?
==>[48003]
What password was used to generate this certificate?
        Type password:
        Retype password:

What file is the client certificate in (full path)?
==>[/opt/nimbus/tmp//client.txt] /tmp/193.71.55.147.txt

Done setting up Client
Cleaning up temporary files
Finished Robot installation!

[root@rhfc4-dev tmp]# 

