Installing the Junos Scope Software

To install the Junos Scope software, follow these steps:

  1. To accept the Junos Scope Software License Agreement, type Yes. If you do not accept the terms of the agreement, you cannot install the Junos Scope software.

    The Junos Scope installation informs you that if problems are encountered with the Java Runtime, you must install or update the required patch cluster. The installation recommends the required patch cluster; for example for Solaris 5.8, J2SE_Solaris_8_Recommended Patch Cluster is required. Patch clusters are available from http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access. We recommend that you install the latest patch cluster before reporting problems with the Java Runtime.

    On a Linux server, the Junos Scope installation checks to ensure that the required linux packages are installed. If any of the packages (see Red Hat Enterprise Linux ES File Package Requirements) are missing the installation lists the missing packages and waits for you to press any key to continue with the Junos Scope installation. We recommend that you install all the linux packages for proper functioning of Junos Scope features.

  2. To confirm whether you want to continue the Junos Scope installation or quit, type C.

    The Junos Scope installation checks the installation file data integrity, then extracts the installation files. This process takes a few minutes.

  3. Specify how you want to protect Junos Scope data files. The available options for protecting data files associated with Junos Scope include:
    • user—Only the user installing Junos Scope can read.
    • group—Any user in the Junos Scope installer's group can read but not write.
    • all—Any Junos Scope user can read but not write.
  4. Indicate the HTTPS port on which the Junos Scope Web server should listen for HTTPS requests. The default port is 8443.

    Note: If you specify a port number less than 1024, the server must run as root.

    It is recommended that you use the HTTPS port for communication between the Junos Scope Web browsers and the Junos Scope server.

  5. Indicate the HTTP port on which to listen for HTTP requests. The default port is 8080.

    Note: If you specify a port number less than 1024, the server must run as root.

  6. Indicate the port on which the Junos Scope server should listen for control messages. The recommended port is 8005. The server listens on local port 8005 for control. Connections can only be made from the local host.
  7. Indicate the HTTP port on which the Junos Scope report server should listen. The default is 8888.
  8. Indicate the JDBC URLs for accessing the Junos Scope database. The default URL is jdbc:mysql://localhost/jtk.
  9. Indicate the JDBC URLs for the demo database. The default URL is jdbc:mysql://localhost/demo.
  10. Type the key used to encrypt and decrypt the import and export of sensitive data. This key can be up to 16 characters long. Retype the password to confirm it. The key is concealed and stored in the Junos Scope software.
  11. Confirm whether you want the Junos Scope installation to install MySQL in <install-directory>/mysql. The default is yes. If MySQL is already installed on the workstation, indicate no to use that database.
  12. (Prompted only if install is done as root.) Type the username of the person installing the Junos Scope software, not root. If the Junos Scope installation is run by root, MySQL will change its UID identifier to a less privileged user. Unless using privileged ports, the Junos Scope server is also run as this user.

    A Junos Scope software password should meet the following restrictions:

    • Allow the full range of ASCII characters (except control characters).
    • Enforce a minimum of 6 characters.
    • Require a change in the character set, including uppercase, lowercase, numeric, and punctuation.
  13. (Prompted only if install is done as root.) Type the name of the group that owns the Junos Scope installation. The default is the primary group of the user you specified in Step 12.
  14. Type the password for the database (internal) administrative user, then retype the password to confirm it. The password should contain numbers and/or punctuation.
  15. Type the database user for JDBC access. The default is jtk. All access to the Junos Scope database is done as this user.
  16. Type the password for the database user, then retype the password to confirm it. The password should contain numbers and/or punctuation.
  17. Confirm whether you want to enable access to the Inventory Management System SQL interface. The default is no. If you select no, the database username and password (see Steps 18 and 19) will not be displayed because the SQL interface is not enabled.

    Warning: If you select no, the SQL interface cannot be accessed by any other application or host except Junos Scope clients. If you select yes, the MySQL database can be accessed by any application with Inventory Management System user credentials.

  18. (If you enabled the Inventory Management System SQL interface) Type the username for the SQL interface to the Inventory Management System database. The default is ims.
  19. (If you enabled the Inventory Management System SQL interface) Type a password for the SQL interface to the Inventory Management System, then retype the password to confirm it. The password should contain numbers and/or punctuation.
  20. Type the Junos Scope administrative user account name. The default account name is admin. The Junos Scope installation creates this initial Junos Scope administrative user account so the administrator can use it to add other users.
  21. Type the password for the Junos Scope administrator, then retype the password to confirm it. The password for the administrator should not match the username, and should not be a word that can be easily guessed.
  22. Confirm whether you want to enable debug logging for technical support purposes. The default is no.
  23. Type the idle session timeout in minutes. The default is 60 minutes.
  24. Type the syslog facility or pipe where you want the syslog daemon (syslogd) to sent Junos Scope software system log messages it receives. The available eight logging facilities include local0 to local7. The default is local2.
  25. Type the Java Virtual Machine (JVM) heap size in Mega Bytes. The default and minimum recommended JVM heap size is 675 MB. You need to enter at least the minimum recommended value of the JVM heap size to proceed with the installation. You can specify a higher JVM heap size value for better performance but it may affect the server startup process.
  26. Provide the following information to generate an X.509 certificate for the Junos Scope HTTPS server (Web browsers will not accept a certificate that appears to belong to a different host):
    • The common name for the Junos Scope software server. For example, specify the Common Name field of an X.509 certificate. A wildcard entry such as *.juniper.net will work. The default name is the hostname.
    • The organization unit that runs the server (optional). For example, specify Network Management.
    • The organization that runs the server. For example, specify Juniper Networks Inc.
    • The locality name or location of this server (optional). For example, specify Sunnyvale.
    • The state or province where the server is located. For example, specify California.
    • The country code where this server is located. For example, type a two-letter code such as US or AU.
  27. Enter the Junos Scope software serial number available in the Software Serial Number Certificate email, or printed on the Junos Scope CD label and then re-enter the serial number to confirm.
  28. Select the Junos Scope software features that you are licensed to operate: Looking Glass, Configuration Manager (Configuration menu), Inventory Manager, Software Manager, or IP Backhaul Manager. If you do not have a license to install a feature, select no (the default). If you have a license to install a feature, select yes. Any feature that you select not to install will be disabled (unavailable) in the Junos Scope main window.
  29. Confirm whether you want to continue the Junos Scope installation, start over, reset the selections to their default, or quit.

    The Junos Scope installation program extracts the database files and generates a certificate for the settings that you indicated. For example, CN=sunmaker.juniper.net, OU=Engineering, O=Juniper Networks Inc., S=California, C=US.

    The Junos Scope installation takes a few minutes to prepare and install the database tables. The installation then shuts down the database, then restarts and checks it.

    The installation starts Tomcat, an application server from the Apache Software Foundation that executes Java servlets and renders Web pages. When this is done, the Junos Scope installation is complete.