Installing the JUNOScope Software

To install the JUNOScope software, follow these steps:

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

   The JUNOScope 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 JUNOScope 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 JUNOScope installation. We recommend that you install all the linux packages for proper functioning of JUNOScope features.

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

   The JUNOScope 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 JUNOScope data files. The available options for protecting data files associated with JUNOScope include:
   • user—Only the user installing JUNOScope can read.
   • group—Any user in the JUNOScope installer's group can read but not write.
   • all—Any JUNOScope user can read but not write.
4. Indicate the HTTPS port on which the JUNOScope 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 JUNOScope Web browsers and the JUNOScope 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 JUNOScope 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 JUNOScope report server should listen. The default is 8888.
8. Indicate the JDBC URLs for accessing the JUNOScope 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 JUNOScope software.
11. Confirm whether you want the JUNOScope 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 JUNOScope software, not root. If the JUNOScope installation is run by root, MySQL will change its UID identifier to a less privileged user. Unless using privileged ports, the JUNOScope server is also run as this user.

    A JUNOScope 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 JUNOScope installation. The default is the primary group of the user you specified in Step item.
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 JUNOScope 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 item and item) 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 JUNOScope 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 JUNOScope administrative user account name. The default account name is admin. The JUNOScope installation creates this initial JUNOScope administrative user account so the administrator can use it to add other users.
21. Type the password for the JUNOScope 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 JUNOScope 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 JUNOScope HTTPS server (Web browsers will not accept a certificate that appears to belong to a different host):
    • The common name for the JUNOScope 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 JUNOScope software serial number available in the Software Serial Number Certificate email, or printed on the JUNOScope CD label and then re-enter the serial number to confirm.
28. Select the JUNOScope 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 JUNOScope main window.
    • For more information about the Looking Glass feature, see Using Looking Glass.
    • For more information about the Configuration Manager features, see Using the Configuration Browser and Using the Configuration Editor.
    • For more information about the Inventory Management feature, see Using Inventory Reports.
    • For more information about the Software Manager feature, see Using the Software Manager.
    • For more information about the IP Backhaul Manager feature, see Provisioning Pseudowires.
29. Confirm whether you want to continue the JUNOScope installation, start over, reset the selections to their default, or quit.

    The JUNOScope 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 JUNOScope 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 JUNOScope installation is complete.

Copyright © 2009, Juniper Networks, Inc. All rights reserved. Trademark Notice.