Launching the IP/MPLSView Client

Launching the IP/MPLSView Client on Linux

1. To start the JAVA client in Linux, enter the following commands:
   $ cd /u/wandl/client

   $ ./ipmplsview

   The IP/MPLSView login screen is displayed.

2. To connect to a different server or to connect using a different port number, enter the following command from the /u/wandl/client directory:
   $ ./ipmplsview [server_host port_number]

   Substitutie the correct server_host and port_number. Note that if you specify a hostname for server_host, you need to edit the /etc/hosts file. If you specify an IP address for server_host, this extra step is not necessary.

   Alternatively, you can edit the ipmplsview file.

Launching the IP/MPLSView Client on Microsoft Windows

1. If you want to run the JAVA client on a Windows PC, double-click the IP-MPLSView Client desktop icon. The IP/MPLSView login screen should appear.

   Figure 1: IP/MPLSView Login Window

   
2. Select Login as a view only mode user only if you wish to use a viewer license instead of a full user license, to reserve the full user license for another session. Click the information i button to indicate how many licenses are currently in use. (Note that a license is not in use until after opening a network project.)
3. If you lose your shortcut icon, you can also double-click the ipmplsview.bat file in the directory where you installed IP/MPLSView (by default, C:\Program Files\wandl\IP-MPLSView). You can also open a DOS window (select Start Menu > Run and enter cmd or command in the Open field.). If you change directory to the directory where you installed IP/MPLSView, you can enter ipmplsview at the prompt to start the program.
4. To change the server, edit the SERVER variable in the ipmplsview.bat file. You can do this directly from the desktop icon by right-clicking the desktop icon and selecting Edit with Notepad or other similar menu option provided by your Windows operating system. If this option is not available, you might need to navigate to the installation directory to change the file. For Windows Vista or later, you might need to right-click on the directory to add edit permissions for your user from the Security tab, Edit button and remove the Read-only attribute from the General tab.

Launching IP/MPLSView Client Using Web Start (Linux and Windows)

1. Launch your Web browser and log in to the IP/MPLSView website (http://serveripaddress:8091 or https://serveripaddress:8443). Click Run IP/MPLSView.

   Figure 2: IP/MPLSView Web Interface with Web Client Access

   

   In the following window, you can configure several run-time parameters. An important option is how much memory the client uses.

   Figure 3: Server and WebServer Selection and Client Memory Allocation

   
2. Click Run IP/MPLSView and the application files are downloaded.

   Figure 4: Application Files Downloading Window

   
3. If you see the warning shown in Figure 5, you can ignore it. Click Start and the IP/MPLSView application launches. In case of problems, see General Procedures for Troubleshooting the IP/MPLSView Installation.

   Figure 5: Web Start Warning Message

   
4. The default language of the client software is English. To change languages, create a file named locale.txt in the local user’s directory, that is, C:\Users\username\.java\com\wandl. Then edit the locale.txt file and add the corresponding code for the desired language. Changes take effect when the client software is launched.

   Table 1: Language Codes

   Code	Language
   en_EN	English
   zh_CN	Simplified Chinese
   ch_TW	Traditional Chinese
   ru_RU	Russian

5. If there are still problems connecting, use the ping command to test the server to make sure you have connectivity. If you do not have connectivity, verify if your client machine is on the same subnet as your server machine.

   If you have connectivity, but still cannot log in, check to make sure that you have started up IP/MPLSView properly using the status_mplsview command on the server. If not, try running the startup_mplsview command again.

   For logins other than the administrative user, check that appropriate privileges are given through the User Admin window, or using the /u/wandl/bin/addWandlUser.sh script. For more information, see Creating Users and Groups Using the User Administration Tool and Performing User Administration from Text Mode.

6. When you launch the IP/MPLSView JAVA client, the login window is displayed. You can enter your login and password (the same login and password as the account on the server from which IP/MPLSView was installed). Then press Enter or click Login.
7. Select one of the two access privileges (that is, Full-control, View Only). Users with View Only privilege can view the reports and monitor the network (for online module), but have restricted ability for modification, simulation, and design.

   The IP/MPLSView GUI starts up with the Start Page.

8. To close the client, select File > Exit. Then select Yes.
9. A Client Notice pop-up window can be enabled when launching the client to display a custom message to the software end user. This can be used to display Terms of Use or Legal Notices. To enable this feature, add the notice.txt file to the /u/wandl/data/custom directory. An optional title message can be given to this pop-up window by adding a title=title of notice entry in the notice.txt file.