Table of Contents

1. AdventNet Framework Installation........................................................................................................2
1.1 Installing AdventNet WebNMS 4.7................................................................................................2
1.2 java 1.4 installation..........................................................................................................................3
1.3 Service Pack3 Installation...............................................................................................................4
1.4 Registering WebNMS.....................................................................................................................4
2. Database Server (mysql) setup...............................................................................................................5
2.1 mysql3 database server installation.................................................................................................5
2.2 mysql5 database server installation.................................................................................................5
3. IEMS Manager Release Installation.......................................................................................................6
3.1 Prerequisite for IEMS manager release installation........................................................................6
3.2 Manager Release Installation Instructions......................................................................................6
4. IEMS manager server as a demon .......................................................................................................10
5. Client Setup..........................................................................................................................................11
5.1 Firefox and java plugins setup on linux machine..........................................................................11
5.2 java policy file...............................................................................................................................12
1. AdventNet Framework Installation
Create an user account on the linux machine and do all the following steps from the 
created user.
The user creation on the linux machine is to be done by the root user and through the 
following command
system­config­users
For the rest of the document it is assumed that a user admin is created and rest of the 
steps are executed by the user admin.
Note. The user name not necessary to be admin it can be anything.

1.1 Installing AdventNet WebNMS 4.7
Locate the file AdventNet_WebNMS4_7_0_Linux_Professional.bin from the 
environment CD, this file will be there in the following path
IEMSEnvironment/server/managerServer
go to the path and execute
./AdventNet_WebNMS4_7_0_Linux_Professional.bin
The installation GUI appears. Choose the combo(server and client) setup for the 
installation and follow the instruction for installation.

If GUI doesn't appears when running the 
AdventNet_WebNMS4_7_0_Linux_Professional.bin file and gives the following error 
“The installer is unable to run in graphical mode. Try running the installer with the 
­console or ­silent flag”

Then do the following before running the bin file again.

troubleshooting
check if  libXp.so.6 is present in /usr/lib, if not present then check for libXp.so.6.2.0 
in /usr/lib, if libXp.so.6.2.0 is present then do the following from root user 

cd /usr/lib
ln ­s libXp.so.6.2.0 libXp.so.6
if   libXp.so.6.2.0 is not present in /usr/lib then copy the  libXp.so.6 from the CD source 
to the /usr/lib

Note. the libXp.so.6 file will be there in the following path of the CD source
IEMSEnvironment/server/managerServer

Note. Also create a directory named xml as described below
cd /home/admin/AdventNet/WebNMS
mkdir xml

Note. Also check that the following .so file exist on the machine on which the WebNMS 
is being installed 
/lib/libdb­3.2.so
If not exists then make a soft link for this file using either  /lib/libdb­4.3.so or /lib/libdb­
4.2.so file
cd /lib
ln ­s  libdb­4.3.so libdb­3.2.so
After successfully installation of  WebNMS now we have to install the service pack3 of 
WebNMS.
Before installing the patch we have to untar the jdk in the following path from the 
environment CD
See the next section for java installation.

1.2 java 1.4 installation
Copy the tar file j2sdk1.4.2_13.tar from the environment CD in the following path 
/home/admin
and untar it by the following command
cd /home/admin
tar ­xvf   j2sdk1.4.2_13.tar
this will make a directory j2sdk1.4.2_13 in /home/admin
1.3 Service Pack3 Installation
Run the UpdateManager.sh from the following path

cd /home/admin/AdventNet/WebNMS/bin  (If the WebNMS is installed in 
the  /home/admin/AdventNet/WebNMS 
path)
./UpdateManager.sh

A GUI will appear . In the GUI give the path of the service pack file with extension 
.ppm (AdventNetWebNMS_4_7_ServicePack_3.ppm) . Click the install button to install 
the service pack.

Note. The service pack file is in the following path of the environment CD
IEMSEnvironment/server/managerServer

After successful installation of the service pack3, provide the license file to use the 
WebNMS as a registered user.
See the next section for details.

1.4 Registering WebNMS
This step is required to use the WebNMS as a registered user, do the following.
cd /home/admin/AdventNet/WebNMS
./WebNMSLauncher.sh &

A GUI will appear asking for license file . Give the path of the License.xml in the GUI 
and press ok. After accepting the license the WebNMSLauncher will appear.

Now exit the WebNmsLauncher
Note. The  License.xml file is there in the following path of the environment CD
IEMSEnvironment/server/managerServer
2. Database Server (mysql) setup

IEMS   Manager   release   supports   both   the   mysql3   and   mysql5   database   servers.   The 
Mysql5 database server is needed to support the database replication and in order to 
support the fail over of manager server.

2.1 mysql3 database server installation
Note. Do all the below steps from the user by whom the AdventNet is installed. Make 
sure that the iems manager server should be down and the mysql  database server should 
be down.

Copy the mysql3Package.tar in some path
give the following command 
tar ­xvf mysql3Package.tar
This will create a folder named  mysql3Package

      cd mysql3Package

Before   invoking   the   below   said   script,   export   the   WEBNMSOME   environment 
variable to the correct value. If not exported then the value is asked in the script.

./mysql3Install.sh
This script will install the mysql3 in the following path
$WEBNMSHOME/../../mysql

2.2 mysql5 database server installation
Note. Do all the below steps from the user by whom the AdventNet is installed. By the 
installation scripts the database is installed  on the machine on which the AdventNet is 
installed. So prior to install the database server , installed the AdventNet on the machine.

Copy the mysql5Upgrade.tar in some path
give the following command

tar ­xvf mysql5Upgrade.tar
 This will create a folder named  mysql5Upgrace

cd mysql5Upgrade

Before invoking the below said script, export the WEBNMSOME environment 
variable to the correct value. If not exported then the value is asked in the script.

./upgradeToMysql5.sh

This script will install the mysql5 in the following path
$WEBNMSHOME/../../mysql
And if the any mysql is installed in the $WEBNMSHOME/../../mysql path then it 
will be backed to the $WEBNMSHOME/../../mysql3 folder

3. IEMS Manager Release Installation

3.1 Prerequisite for IEMS manager release installation
IEMS manager server should not be running. If it is running then the user will be 
asked to stop it when he is installing the manager release through manager_install.sh 
script. If he chooses not to stop the manager server then the manager release will not be 
installed, and if he chooses to stop the manager server, then the script would do the next 
things for release installation.

All the steps below has to be executed from the OS user by whom the WebNMS  is 
installed.

Note: The ems 2_18 release over 2_17 required the db retrofit script to be run before the 
release installation. The manager server has to be down before the retrofit script to be 
run.

3.2 Manager Release Installation Instructions
Do the following steps for installing IEMS Manager release on linux based server:

1. Copy   the   manager   release   deliverable   from   IEMS   manager   release   CD   to  the 
 manager server machine .

2. Export variable WEBNMSHOME to the path where WEBNMS server is installed 
like if WEBNMS is installed in the following path 
/home/admin/AdventNet/WebNMS then do the following 
<prompt> export WEBNMSHOME=/home/admin/AdventNet/WebNMS

if user does not do the export on the prompt then the value of  WEBNMSHOME 
will be asked in the manager_install.sh script execution.

3. Untar the manager release as follows
tar ­xvf ems<rel number>.tar
It will make a folder of the name ems<rel number>
cd ems<rel number>/scripts
./manager_install.sh

This is an interactive script, and following are the options which are asked during 
the script execution and their meaning.
WEBNMSHOME=<path picked up by the script>
Want to change it (y/n) :

WEBNMSHOME's default value is picked up by the script and shown to the user, 
if it is wright then provide the n/N option to the script, if this value is wrong then 
provide the y/Y option to the script.

if y/Y option is provided then the next print is 

Enter WEBNMSHOME =

give the value here and press enter, the next print is as, as if you have provided n 
or N option

if n/N  option is provided then the next print is

MANAGERRELEASE PATH=<path picked up by the script>
Want to change it (y/n) :

MANAGERRELEASE's default value is picked up by the script and shown to the 
user, if it is wright then provide the n/N option to the script, if this value is wrong 
then provide the y/Y option to the script.
if y/Y option is provided then the next print is 

Enter MANAGERRELEASE Path=

give the value here and press enter, the next print is as, as if you have provided n 
or N option

if n/N  option is provided then the next print is

Start the release install  process (y/n) :

If the n/N option is provided the the script will be ended.
If the y/Y option is provide then the next print is based on the following scenario 
If the manager server is up then the print is as follows

IEMS server is up so it has to be stopped before further activity
Do you Want to stop the IEMS manager server (y/n) :

If the n/N option is provide then the script will be exited with the following print
The IEMS server should not be running for release installation. So exiting !!!

If the y/Y option is provide then the script try to down the iems manager server
the following prints comes up

Shutting down the IEMS manager server please wait ...
Enter User Name=

The user name has to be entered after that the password will be asked 

Enter Password=

After entering the correct password the script try to down the manager server.
If the wrong user name or password is entered then the following print would  
appear

Authentication failed for user <user name entered>. Please verify the user name 
and password

Want to try again (y/n):
If the manager server is successfully down then the following prints will appear 

IEMS manager server is successfully down.

Before Uninstalling the manager release which is installed
Do you Want to retain the already existing manager users (y/n) :

If the manager server is down then the prints are as follows

IEMS server is currently down. continuing with the activities ...

Before Uninstalling the manager release which is installed
Do you Want to retain the already existing manager users (y/n) :

Now the manager server is down and the user is asked to retain the existing  
manager users, before uninstalling the previous manager release if it is installed.

If n/N option is provided.

Then all the users created in the previously will be deleted and only the root user 
will be installed with default password.

If y/Y option is provided then all the previously created users will be retained in 
the system.

 The next prints are as follows

Uninstalling previous manager nar ...
Previous manager nar uninstalled successfully.

Installing current manager nar ...
Current manager nar installed.

completing the process Please Wait ...
Installation successful.

Do you Want to start the IEMS manger server (y/n) :
 If n/N option is provide then the script will exit without starting the iems manager 
server.
The manager server can be started standalone from the script startiems.sh from  
the following path $WEBNMSHOME/bin as follows

cd $WEBNMSHOME/bin
nohup ./startiems.sh &

Note:  Before   executing   the     startiems.sh   script   please   export   the  

WEBNMSHOME environment variable as described in step 2.

If   y/Y     option   is   provided   then   the   manager   server   will   be   started   and   the 
following prints will appear and the script will exit.

Server startup has been initiated Please see the log file
<WEBNMSHOME>/logs/Start_Web_NMS_Server_<Date   and   time   of   server  
start>.log
Thank You

Note : To stop the manager server through script do the following.
cd $WEBNMSHOME/bin
./shutdowniems.sh

If WEBNMSHOME environment variable is not set then it will be asked in the 
script otherwise it will not be asked.
The user name and password will be asked to down the manager server.

4. IEMS manager server as a demon 
Procedure to make iems manager process as demon on linux machine 

All the below steps is to be executed by the OS user root.

 copy   the   iemsd   script   from   $WEBNMSHOME/bin/iemsd   to   the   /etc/init.d 

folder by the user root like as follows
cp $WEBNMSHOME/bin/iemsd /etc/init.d/

 cd /etc/rc5.d
 ln ­s ../init.d/iemsd S85iemsd
  now invoke the system­config­services command from the root user
and make sure that the mysqld service should be unchecked and iemsd service
should be checked. Now save and exit from the system­config­services gui
screen.
./system­config­services &

5. Client Setup
Since the iems application is web based and only requires the web browser on the client 
side. These web browsers can be firefox/mozilla on linux machines and 
IE/firefox/mozilla on windows machines.
The browsers should also have the java plugins installed to run the iems application.
The firefox 2.0.0.14 and the java 6 are provided  in the environment CD at the following 
path IEMSEnvironment/client 

5.1 Firefox and java plugins setup on linux machine.
Untar the jre1.6.0.tar in some path like /home/admin

cd /home/admin
tar ­xvf <path to tar file>/jre1.6.0.tar

This will make a folder jre1.6.0 in the current path
now untar the firefox.tar in the same path like the following

tar ­xvf <path to tar file>/firefox.tar

This will make the firefox folder in the current path

Now make the java plugin link in the firefox folder

cd <path where you untar the firefox tar>/firefox/plugins
ln ­s <path where you untar the jre 
tar>/jre1.6.0/plugin/i386/ns7/libjavaplugin_oji.so .
Now to start the firefox browser go to the following directory
<path where you untar the firefox tar>/firefox
./firefox &

5.2 java policy file
Since the iems application is uses java applets, and the applet runs on the client's jvm, 
which requires some privileges granted by the user. These access  privileges are granted 
in the java.policy file.
This file should be presented in the user's home directory and as a hidden file on the 
linux machine, and on windows it should be in the users Documets's and Setting folder.

Java.policy file is there at the following path of the environment CD
IEMSEnvironment/client
On linux :
cd <user's home directory>
cp <Path to the java.policy>/java.policy .java.policy