Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Installing the Viewserver

 

Requirements

The following are requirements for the Viewserver installation and usage:

  • 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.

Before installing the Viewserver package:

  • 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.

Table 1: Distributed Server Address Example

Server

IP Address

Description

Directory

Environmental Variable

Application server

172.16.1.1

Application install directory

/home/wandl/ipmplsview

-

Application server

172.16.1.1

Application data directory

/home/wandl/wandldata

-

Viewserver

172.26.2.2

Viewserver install directory

/home/wandl/viewserver

-

Viewserver

172.26.2.2

Viewserver data directory

/home/wandl/viewdata

LOCAL_DATA_DIR

Viewserver

172.26.2.2

Remote data directory

/home/wandl/wandldata

REMOTE_DATA_DIR

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

Step-by-Step Procedure

To install the Viewserver:

  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 menu, 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.

  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 on this topic.

Configuring the Viewserver

Step-by-Step Procedure

The shared user data directory on the application server should be shared as read-only to the Viewserver. Also, symbolic links should be created for the Task Manager profile directory and .diag file. This configuration is required to view the Live Network and be in sync with shared user data.

  1. Log in to the application server.
  2. Locate the absolute data directory path.
    ls -l /u/wandl/data
  3. As the root user, share the application data directory as read-only to the Viewserver (client machine).
    [root@nfsserver ~]# vi /etc/exports
  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

Viewserver User Account Setup

Step-by-Step Procedure

Viewserver users need accounts created on both the Application server and Viewserver. The administrator on the application server can then set user permissions from the User Admin module. The user account on the application server is used to manage permissions and regional views. The user account on the Viewserver is for Web and Client access and user data storage.

To set up a Viewserver user account:

  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

To start, use, and stop the Viewserver:

  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

Once the Viewserver is running, you can launch the Viewserver client using Webclient or a desktop client.

  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 IP address.

    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:
    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

The following are the Viewserver commands and paths:

  • Directory: /u/wandl/bin

  • Start server command: /u/wandl/bin/startup_viewerserver

  • Stop server command: /u/wandl/bin/stop_viewerserver

  • Server status command: /u/wandl/bin/status_viewerserver

  • Install directory: /home/wandl/viewserver

  • Local data directory: /home/wandl/viewdata

  • Remote data directory: /home/wandl/wandldata

  • Mount command: mount application_server_IP:/app_data_dir /remote_data_dir

  • Link profile command: ln -s remote_data_dir/.TaskManager/profile local_data_dir/.TaskManager/profile

  • Link .diag command: ln -s remote_date_dir/.TaskManager/tmp/.diag local_data_dir/.TaskManager/tmp/.diag

The following are the application server commands and paths:

  • Directory: /u/wandl/bin

  • Application data directory: /home/wandl/wandldata

The following variables are used for Viewserver implementation. These values are set in the /u/wandl/bin/mplsenvsetup.sh script during installation or by running the /u/wandl/bin/changeconfig.sh command. Do not manually edit these values. The following information is provided for reference only.