This application is bundled along with Web NMS 5. You can also download this tutorial from the AdventNet web site. Please use the following URL to download the tutorial:
If you are using the downloaded tutorial from the web site, then extract the tutorial under <Web NMS HOME> directory.
Creating User and Group
The Security related configurations have to be done before deploying the Nar. That is User/Group should be created before installing the NAR. Refer the section Using Authorization Service for more details.
Installing the Application
To install the tutorial application,
Stop the Web NMS Server if it is running (double-click Shutdown NMS Server icon from the Web NMS Launcher or invoke ShutDown.bat/sh from <Web NMS Home>bin directory
Run DeploymentWizard.bat/.sh file under <Web NMS HOME>/bin /developertools directory.
Select the NarInstall/Uninstall tab.
Select the Install button in the screen.
Click the Browse button in the NAR INSTALLER pop-up screen.
Select the tutorials/ems_tutorial/EMS_Tutorial1.0.nar from the File Chooser pop-up screen and click the Select button.
Click the OK button in the NAR INSTALLER pop-up screen.
On clicking OK button, NmsPwsNarInstaller screen will pop-up.
Check the ReadMe for more details about the nar.
Click the Next button.
In the final screen , click Install button.
This will install and show the status in the progress bar. See that the progress is 100%.
Click the Close button.
Now the installation is complete. Three entries will be listed in the Uninstall section of the Deployment Tool. The entries are EMS_Tutorial1.0.nar, ChassisScreen and SwitchConfiguration.
Click the Exit button to quit the Deployment Wizard.
Reinitialize Web NMS using reinitialize_nms.bat/.sh under <Web NMS Home>/bin directory. Both, the data and configuration are reinitialized.
This tutorial will function only if Web NMS is reinitialized. Hence, after installing the tutorial, reinitialize Web NMS.
Ensure you use separate Web NMS installation for tutorial application development and installation.
Do not experiment on Web NMS deployed in real world.
When this tutorial application is installed, the existing files which require changes, from the installed Web NMS are backed up. However, when you un-install this tutorial application, the files modified will be restored from the backup.
Uninstalling the Application
To uninstall the tutorial application,
Run the DeploymentWizard.bat/.sh file under <Web NMS HOME>/bin/developertools directory.
Select the NarInstall/Uninstall tab.
In the Uninstall section, select the EMS_Tutorial1.0.nar entry
Click Uninstall button in the screen.
On clicking Uninstall button, NmsPwsNarUninstaller screen will pop-up.
In that, click Uninstall button.
This will uninstall and show the status in the progress bar. See that the progress is 100%.
Click Close button. All the three entries pertaining to the Nar will be removed. Now the uninstallation is complete.
Click Exit button to quit the Deployment Wizard.
Note: To install the NAR created by you, select EMS_User1.0.nar
Modifying the Application
If you want to modify the application and try out other features, you can edit the EMS project of this application bundled with this tutorial.
Use File -> Import to invoke Import Wizard in Eclipse then select Import Existing Project option in the tree.
Check the "Project from file system" option and browse and give the root directory of the project as <Web NMS HOME>/StudioTools/Studio/projects/EMS_Tutorial directory.
Make the changes (supported by the AdventNet Web NMS EclipsePlugin) to the project as per your requirement.
Save, compile, and package the project into NAR.
Un-install the existing installed NAR and install the new NAR generated with your changes.
Caution: Un-installing the original NAR is mandatory as only one Eclipse NAR is permitted to be deployed in AdventNet Web NMS.
For complete details on Working with EclipsePlugin, refer to the Web NMS EclipsePlugin Guide.