Installation Guide

System Requirements

• Hardware Requirements

• Software Requirements

• Installation Procedure

• Manager
• Agent
  

The following is the minimum hardware and software requirements for installing and using WebNMS SNMP Agent for Linux.

Hardware Requirements  

The performance exhibited by WebNMS SNMP Agent for Linux will depend considerably on the CPU and memory of the installed system. The following is the suggested minimum configuration:

Software Requirements

Installation Procedure

Installing Linux Manager
 
Installation of the Linux Manager / Remote Installation Tool and the Agent is very simple. To Install the Linux Manager / Remote Installation Tool kindly follow the steps given below.

1. Extract the zip file AdventNet_LinuxManager.zip .
2. Go to AdventNet/LinuxManager directory.
3. Login as root by executing the command "su" or "su root" .
4. Run the script Installation_step1.sh present under AdventNet/LinuxManager directory by executing "sh Installation_step1.sh"
5. Exit from the root user .
6. Run the script Installation_step2.sh by executing "sh Installation_step2.sh".

• Installation_step1.sh should be run from root.
• Installation_step2.sh should be run from any other normal account (other than root account).

1. Go to AdventNet/LinuxManager/bin Directory. Set the path by running the script setenv.sh.( dot space setenv.sh . setenv.sh. Leave a space between dot and setenv.sh)  .
   
2. Start the Manager by running sh StartServer.sh present under AdventNet/LinuxManager/bin directory. This will start the Manager in the default port 8080.
1. To change the default port of the Manager
   
1. Open AdventNet/LinuxManager/server/apache/conf/httpd.conf
2. Change  the line "Listen 8080"   to  "Listen <free port  number>"  present in line number 220.
3. Open install.exp present in AdventNet/LinuxManager/server/apache/data/ directory.
4. Change the port Number 8080 present in the line wget http://$manager:8080/AdventNet_LinuxAgent.zip\r to
    <free port Number>
5. Then start the Server by executing sh StartServer.sh.
   
   
3. To access the LinuxManager type in the browser as : http://<machine-name>:8080  or http://<machine-name>:<changed port number>
   
4. To stop the LinuxManager execute the script StopServer.sh present under AdventNet/LinuxManager/bin directory as "sh StopServer.sh".

1. Execute uninstall.sh from AdventNet/LinuxManager directory by executing sh uninstall.sh. (The uninstall.sh script should be executed from the root account)
   
2. After executing the script you can remove the entire AdventNet/LinuxManager directory.
   

1. When the http://<machine-name>:8080 is accessed for the first time, the following screen shot will be seen  LinuxManager_First_Screen
2. The next step is to discover the nodes present in the particular network. For this enter the ip address in the text box "Network IP" present in the left panel. and Click Discover. For eg if we enter the IPAddress 192.168.111.0 , then the manager will discover all nodes which starts with ip 192.168.111.
3. After Discovery the LinuxManager looks like LinuxManager_AfterDiscovery.
4. To Install the Agent in a particular  node say "amp-linux4.india.adventnet.com" just click the "Install agent" link.
   
5. A pop up window will appear  LinuxManager_PopUpWindow.
6. By default the Agent will be installed in the guest account. If you want you can change the User Name and Password and then click Install.
7. On successful installation the LinuxManager will put the LinuxAgent.zip under the specified account (by default guest account) and will start the linuxagent present under AdventNet/LinuxAgent/bin directory.
8. If the Installation is successful you can see the following screen shot (LinuxAgent Index Page.)
   
9. After Installation we can query the agent any time by clicking on the node name or the computer image present. LinuxManager AfterInstallation

1.  Extract the AdventNet_LinuxAgent.zip file.
2.  From the AdventNet/LinuxAgent/bin directory start the agent by executing the linuxagent executable.  (sh StartAgent.sh)
3.  This will start the linuxagent in the default ports.
1. SNMP Port Number       :: 8001
2. Snmp Trap Port Number :: 8002
3. HTTP Port Number        :: 8040
   
4.  From the web browser query the agent by connecting to the agent, through the port 8040.  http://<machine-name>:8040.
5.  You can query the snmp nodes by connecting to the port 8001.
6.  To stop the LinuxAgent run sh StopAgent.sh from AdventNet/LinuxAgent/bin directory.