Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

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

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

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

    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.

    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

    Modified: 2016-09-28