3.3.1 Installing Web NMS

This section discusses the installation procedure of AdventNet Web NMS using different modes on operating systems such as Windows, Linux, and Solaris. AdventNet Web NMS can be downloaded from http://www.adventnet.com/products/webnms/download.html.

This topic explains

• Installing Web NMS Professional Edition

• Installing Web NMS Standard / Express Edition

• Troubleshooting

For information on various Web NMS Editions, refer to Quick Tour.

Installing Web NMS Professional Edition

This section covers the following modes of installation

• GUI Mode

• Command or Console Mode

• Silent Mode

GUI Mode

The GUI mode is an interactive GUI based installation mode.

Steps to install Web NMS Professional Edition

1. Download the installation files (.exe file for Windows and .bin files for Linux and Solaris).

2. Check the executable permission of the .bin file. If the file is not executable, execute the following command:

chmod a+x <filename> where <filename> is the corresponding .bin file

3. Execute the downloaded file. The InstallShield Wizard with the Welcome message is displayed.

4. Click Next.

5. The License Agreement screen is displayed. Select "I accept the License Agreement".

5. Click Next.

6. The Localization screen is displayed. Choose the required language - English (default), Japanese, or Chinese.

7. Click Next.

8. The Edition screen is displayed. It provides the choice of Server and Client and Advanced installation options. Select Server and Client to install the Combo package (BE server, FE server and Client) and Advanced to install the Standalone versions of BE, FE and Client.

9. Click Next.

10. If you have chosen Server and Client, skip this step and proceed to the next. If you have chosen Advanced, perform this step and proceed. When Advanced is chosen, the OEM Edition - Advanced screen is displayed with various installation options. Select the required type of installation. Click Next.

11. The Optional Components screen is displayed. Choose to install the Javadocs and Tutorials, if required. By default, the two options are selected.

12. Click Next. The directory location screen is displayed. Specify the location where Web NMS has to be installed. Use the Browse button to specify a different location.

13. Click Next. The details of the installation (pre-installation summary) is displayed. If you need to change any of it, use the Back button to modify.

14. Click Next. The installation begins. Once the installation is complete, a final screen is displayed. Click Yes, I want to view the Readme file (if it is not selected) to view the README for the product.

15. Click Finish.

After installation, when you start Web NMS, you need to provide the license information. For more information, refer to Licensing the Product.

Top

Command/Console Mode

The Command or Console mode is an Interactive and Non-GUI based installation mode. The user can install Web NMS through the command prompt.

Steps to install Web NMS Professional Edition in Command or Console mode

1. Download the installation files (.exe file for Windows and .bin files for Linux and Solaris).

2. Check the executable permission of the .bin file; if the file is not executable, then execute the following command: chmod a+x <filename> where <filename> is the corresponding .bin file.

3. Execute the file to install Web NMS as follows

• For Windows <File Name>.exe -console

• For Linux/Solaris : <File Name>.bin -console

4. The above command will initiate an interactive installation procedure. The user needs to select the options from the messages displayed on the command prompt.

Top

Silent Mode

The Silent mode is a Non-interactive and Non-GUI based installation mode. This mode of installation is generally useful for automated setups. The user can specify all the options required in a text file and the installation process continues without manual intervention.

Steps to install Web NMS in Silent mode

1. Download the installation files (.exe file for Windows and .bin files for Linux and Solaris).

2. Check the executable permission of the .bin file; if the file is not executable, then execute the following command: chmod a+x <filename> where <filename> is the corresponding .bin file.

3. For building the installoptions.txt file required for installation, open a new text file and copy the following contents and save the file as installoptions.txt.
    

#****************************************************** -W locale.lang=English -W OEMProducts.selectedValue=OEMADV -W OEMAdvance.selectedValue=OEMADVBE -W StdCustom.optComponents=Javadocs,Tutorials -G replaceExistingResponse="yesToAll" #*******************************************************

The editable options beginning with "-W" can have the following values.

Options	Description
locale.lang	Specifies the language in which the Installation will take place. English Chinese Japanese
OEMProducts.selectedValue	Specifies the options for installation OEMSTD for standard installation OEMADV for advanced installation
OEMAdvance.selectedValue	Specifies the category for advanced installation OEMADVBE for Back-End Server installation OEMADVFE for Standalone Front-End Server installation OEMADVClient for Standalone Client installation
StdCustom.optComponents	Specifies the option for including Javadocs and Tutorials. The valid values are Javadocs - For installing only Javadocs Tutorials - For installing only Tutorials Javadocs,Tutorials - For installing both Javadocs and Tutorials

4. Execute the .exe or .bin files as follows where <InstallLocation> should be replaced by the path where Web NMS has to be installed.
   
   For Windows:

<File Name>.exe -is:javaconsole -silent -options installoptions.txt -P ProductRoot.installLocation=<InstallLocation>

For Linux:

./<File Name>.bin -is:javaconsole -silent -options installoptions.txt -P ProductRoot.installLocation=<InstallLocation>

For Solaris:

./<File Name>.bin -is:javaconsole -silent -options installoptions.txt -P ProductRoot.installLocation=<InstallLocation>

Where,

InstallLocation is any writable location in the system, where the product has to be to installed.
installoptions.txt is the text file which supplies different arguments to the installer (creating this file is explained above)

Points to remember while installing in Silent Mode.

1. Avoid installing Web NMS using silent mode in a previously installed location.

2. Changing the variable name in the installoptions.txt file (value on LHS of "=") leads to installation failure.

3. The variable OEMAdvance.selectedValue will have no effect if OEMProducts.selectedValue is set to OEMSTD.

Top

Installing Web NMS Standard / Express Edition

This section covers the following modes of installation

• GUI Mode

• Command or Console Mode

• Silent Mode

GUI Mode

The GUI mode is an interactive GUI based installation mode.

Steps to install Web NMS Standard / Express Edition

1. Download the installation files (.exe file for Windows and .bin files for Linux and Solaris).

2. Check the executable permission of the .bin file. If the file is not executable, execute the following command:

chmod a+x <filename> where <filename> is the corresponding .bin file

3. Execute the downloaded file. The InstallShield Wizard with the Welcome message is displayed.

• For Windows: <File Name>.exe

• For Linux/Solaris: ./<File Name>.bin

4. Click Next.

5. The License Agreement screen is displayed. Select "I accept the License Agreement".

5. Click Next.

6. The Localization screen is displayed. Choose the required language - English (default), Japanese, or Chinese.

7. Click Next.

8. The Category of Installation screen is displayed. It provides the choice of Server and Client and Remote Client options. Select Server and Client to install the Combo package (BE server, FE server and Client) and Advanced to install the Standalone Application Client. (This option is not shown in Express Edition, as it doesn't support java client)

9. Click Next.

10. The directory location screen is displayed. Specify the location where Web NMS has to be installed. Use the Browse button to specify a different location.

13. Click Next. The details of the installation (pre-installation summary) is displayed. If you need to change any of it, use the Back button to modify.

14. Click Next. The installation begins. Once the installation is complete, a final screen is displayed. Click Yes, I want to view the Readme file (if it is not selected) to view the README for the product.

15. Click Finish.

After installation, when you start Web NMS, you need to provide the license information. For more information, refer to Licensing the Product.

Top

Command/Console Mode

The procedure is same as explained under Installing Web NMS Professional Edition.

Top

Silent Mode

The Silent mode is a Non-interactive and Non-GUI based installation mode. This mode of installation is generally useful for automated setups. The user can specify all the options required in a text file and the installation process continues without manual intervention.

Steps to install Web NMS in Silent mode

1. Download the installation files (.exe file for Windows and .bin files for Linux and Solaris).

2. Check the executable permission of the .bin file; if the file is not executable, then execute the following command: chmod a+x <filename> where <filename> is the corresponding .bin file.

3. For building the installoptions.txt file required for installation, open a new text file and copy the following contents and save the file as installoptions.txt.
    

#****************************************************** -W locale.lang=English -W STDCategory.selectedValue SERVER -G replaceExistingResponse="yesToAll" #*******************************************************

The editable options beginning with "-W" can have the following values.

Options	Description
locale.lang	Specifies the language in which the Installation will take place. English Chinese Japanese
STDCategory.selectedValue	Specifies the options for installation SERVER for server and client installation CLIENT for standalone client installation

4. Execute the .exe or .bin files as follows where <InstallLocation> should be replaced by the path where Web NMS has to be installed.
   
   For Windows:

<File Name>.exe -is:javaconsole -silent -options installoptions.txt -P ProductRoot.installLocation=<InstallLocation>

For Linux/Solaris:

./<File Name>.bin -is:javaconsole -silent -options installoptions.txt -P ProductRoot.installLocation=<InstallLocation>

Where,

InstallLocation is any writable location in the system, where the product has to be to installed.
installoptions.txt is the text file which supplies different arguments to the installer (creating this file is explained above)

Points to remember while installing in Silent Mode

1. Avoid installing Web NMS using silent mode in a previously installed location.

2. Changing the variable name in the installoptions.txt file (value on LHS of "=") leads to installation failure

Top

Troubleshooting

In case of any errors during installation, follow the steps listed below to produce the logs files.

• Create a text with the same name as that of the installer and with extension as ".sp". i.e,
  For <File Name>.bin, create a text file named <File Name>.sp
  For <File Name>.exe, create a text file named <File Name>.sp
  Example: If the file name is AdventNet_WebNMS4_Linux.bin, create a text file named AdventNet_WebNMS4_Linux.sp

• Open the ".sp" text file in a editor, add is.debug=1 as the content

• Save the ".sp" text file in the same directory where the binary file resides.

• Change to the directory where the binary file is present by executing cd command

• Invoke the installer as
  ./<File Name>.bin -is:javaconsole -is:log log.txt [for Linux/Solaris]
  <File Name>.exe -is:javaconsole -is:log log.txt [for Windows]

• The above command will create the log file named log.txt. Mail the log file to nms-support