Installing the Viewserver

Requirements

• The application server and Viewserver must use the same system platform.
• The npatpw password file in the /u/wandl/db/sys/ directory is required for each Viewserver machine.
• Create the remote data directory as the wandl user before installing. The remote data directory must use the same name as the application data directory.

• Configuration settings:

  • IP address
  • LDAP Server IP address = Application server IP address
  • Distributed Database = Yes
  • Local Database IP address = Viewserver IP address
  • Distributed Database IP address = Application or database server IP address
• The Viewserver user accounts must be created on both the application server and the Viewserver.

• Verify that existing servers for application, database, and traffic data collectors are running properly.
• Copy the Viewserver package installation files to the machine hosting the Viewserver.
• Contact your Juniper representative to obtain the Viewserver installation package license.

Overview

This section guides you through installation of the Viewserver. We recommend that you write down the IP address and directories of your distributed server environment. Table 1 is used as the example in this guide.

Note: The remote data directory requires the same name as the application data directory.

Viewserver Installation

This procedure describes the following tasks:

• Installing the Viewserver
• Configuring the Viewserver
• Viewserver User Account Setup
• Starting and Stopping the Viewserver
• Launching the Viewserver Client
• Viewserver and Application Server Commands, Paths, and Variables

Installing the Viewserver

Step-by-Step Procedure

1. Copy and extract the Viewserver installation packages to a temporary installation directory on the Viewserver.
2. As the wandl user, create the remote data directory. It must have the same name as the application data directory.
   mkdir /home/wandl/wandldata
3. As the root user, run the installation script from the temporary installation directory.

   ./inst_viewerserver.sh

4. At the prompt, input the View Server user ID. We recommend using the default wandl ID.
5. At the prompt, input the group ID. We recommend using the default staff ID.
6. The install script prompts you to shut down the servers. Enter Yes.
7. At the prompt, enter the directory where you want this software installed. We recommend using the /home/wandl/viewserver directory.
8. At the prompt, enter the directory where you want the data stored. We recommend using the /home/wandl/viewdata directory.
9. At the main Mmenu, select IP Address.
   • Set the LDAP Server IP address to be the same as the Application server IP address.
   • Set the Distributed Database to YES.
   • Set the Distributed Database IP address to be the same as the Application server IP address. If the application and database are on distributed servers, then set these to the database server IP address.

     (B) IP Address
     IP/MPLSView Server IP Address Settings:
     1.) View Server IP.....................: 172.26.2.2
     2.) Webserver IP.......................: 172.26.2.2
     3.) LDAP Server IP.....................: 172.16.1.1
     4.) External Webserver IP (for NAT)....:
     5.) Local Database IP..................: 172.26.2.2
     6.) Distributed Database...............: YES
     ....Distributed Database IP............: 172.16.1.1
     ....Database Port......................: 3333
     9.) MongoDB IP.........................:
     99.) Change All IP Addresses for 1, 2, 3, 5

10. Only the IP Address settings need to be changed for the Viewserver setup. You can review the other options in the main menu. Accept these values when you are ready.
11. The following are optional prompts if the installation packages are detected:
    • At the Install Client prompt, if you want to use the Linux Client, enter y to install it; otherwise, enter n.
    • At the prompt to install the Traffic Data Collector, if you want to use the Traffic Data Collector on the Viewserver, enter y to install it; otherwise, enter n.
    • At the prompt to Install Rsync & Replication, if you want to use the Rsync and Replication features, enter y to install these; otherwise, enter n.
12. At the prompt to copy files from the old installation to the new installation, select the options you want to copy over.
13. At the prompt to enter the mount point of the remote data directory, use the /home/wandl/wandldata remote data directory.

    Note: The remote data directory must be created before running the installation script.

14. At the prompt to enter the IP address of the application server, use the application server IP address.
15. At the prompt to give the Java applets write permission, enter y to allow saving Java charts and trending reports from the Web, or enter n to skip this.
16. At the prompt to start up the Viewserver, enter y to start, or enter n to skip and start at a later time.

    Before launching a client session, read the Configuring the Viewserver and Viewserver User Account Setup sections of this topic.

Configuring the Viewserver

Step-by-Step Procedure

1. Log in to the application server.
2. Locate the absolute data directory path.
   ls -l /u/wandl/data

   lrwxrwxrwx 1 wandl staff 31 Jun 23 10:46 /u/wandl/data -> /home/wandl/wandldata

3. As the root user, share the application data directory as read-only to the Viewserver (client machine).
   [root@nfsserver ~]# vi /etc/exports

   /home/wandl/wandldata 192.168.0.101 (ro,sync,no_root_squash)
   #service nfs restart

4. Log in to the Viewserver.
5. As as the root user, mount the remote data directory using the shared path. In the Requirements section, the remote data directory is created as the wandl user and uses the same name as the application data directory.
   mount 172.16.1.1:/home/wandl/wandldata /home/wandl/wandldata
6. As the wandl user, create symbolic links from the local data directory to the remote data directory for the Task Manager profile directory and .diag file to support proper SNMP, Diagnostics, Run CLI, and RCA functionality.
   cd /home/wandl/viewdata/.TaskManager

   ln -s /home/wandl/wandldata/.TaskManager/profile profile
   ln -s /home/wandl/wandldata/.TaskManager/tmp/.diag tmp/.diag

Viewserver User Account Setup

Step-by-Step Procedure

1. As the root user, add user accounts on both the application server and Viewserver. Then set the password. The user password does not have to be the same on both servers. When logging in to the Viewserver Web or Viewserver Client, the password prompt uses the password set on the Viewserver. The following command creates a new user named viewuser in the staff group, creates and sets the user’s home directory to /home/viewuser, and sets the profile to use a bash shell.
   useradd -g staff -d /home/viewuser -m -s /bin/bash viewuser

   passwd viewuser
2. Repeat Step 1 for each additional user.
3. As the wandl user, log in to the Application Client.
4. Select Admin > User Administration to manage the permissions and regions of the Viewserver users.

Starting and Stopping the Viewserver

Step-by-Step Procedure

1. Create the remote data directory, as the wandl user, before starting the installation. The remote data directory must have the same name as the application data directory.
2. As the root user, run the installation script from the temporary installation directory.
3. During installation, at the main menu prompt, enter the IP address settings and change the LDAP IP address, set the distributed database to YES, and enter the distributed database IP address.
4. Share the application server application data directory.
5. Mount the Viewserver remote data directory.
6. Create symbolic links from the Viewserver local data directory to the remote data directory in the TaskManager path.
7. Create the Viewserver user accounts on both the application server and Viewserver.
8. Manage the Viewserver user permissions through the application client.
9. As the wandl user, start up the Viewserver using the following command:
   /u/wandl/bin/startup_viewerserver
10. To stop the Viewserver and send a warning message to all clients stating the server is shutting down in 1 minute, log in as the wandl user and stop the Viewserver using the following command:
    /u/wandl/bin/stop_viewerserver

Launching the Viewserver Client

Step-by-Step Procedure

1. To start the client using Webclient:
   1. Open a Web browser and enter the Viewserver IP address on port 8091.
      viewserver_ip:8091
   2. Log in to the Web using the user credentials set up on the Viewserver.
   3. Click Webclient.
   4. Click IP/MPLSView.
   5. Log in to the client using the user credentials set up on the Viewserver.
2. To start the client using a desktop client:
   1. Install the client using the appropriate settings for each of the following:
      • SERVER—Set the IP/MPLSView application server IP address to be the same as the Viewserver IP address.
      • WEBSERVER—Set the Web server IP address to be the same as the Viewserver IP address.
      • LDAPSERVER—Set the LDAP server IP address to be the same as the application server IPaddress.
   2. If the client is already installed, right-click the IP/MPLSView Client icon and select edit, or edit the ipmplsview.bat file to change the following settings:

      SET SERVER=172.26.2.2
      SET SERVERPORT=7000
      SET WEBSERVER=172.26.2.2
      SET WEBSERVERPORT=8091
      SET LDAPSERVER=172.16.1.1
      SET LDAPPORT=3389
      SET MEMORY=256MB

   3. Double-click the IP/MPLSView Client icon or the ipmplsview.bat file.
   4. Log in to the client using the user credentials set up on the Viewserver.

Viewserver and Application Server Commands, Paths, and Variables

Step-by-Step Procedure

VIEW_ONLY=0; export VIEW_ONLY
LOCAL_DATA_DIR=/home/wandl/viewdata ; export LOCAL_DATA_DIR
VIEW_SERVER_APPIP=172.16.1.1; export VIEW_SERVER_APPIP
REMOTE_DATA_DIR=/home/wandl/wandldata ; export REMOTE_DATA_DIR