CANOGA PERKINS CanogaView EMS User Manual

COVER

CanogaView EMS

Installation Guide

CanogaView EMS

Notice

Canoga Perkins has prepared this users manual for use by customers and Canoga Perkins personnel as a guide for the proper installation, operation and/or maintenance of Canoga Perkins equipment. The drawings, specifications and information contained in this document are the property of Canoga Perkins and any unauthorized use or disclosure of such drawings, specifications and information is prohibited.

Canoga Perkins reserves the right to change or update the contents of this manual and to change the specifications of its products at any time without prior notification. Every effort has been made to keep the information in this document current and accurate as of the date of publication or revision. However, no guarantee is given or implied that the document is error free or that it is accurate with regard to any specification.

Sun, Sun Microsystems, and Solaris are all trademarks of Sun Microsystems, Inc. in the United States and in other countries. Microsoft, Windows, Windows 2000, and Windows XP are all trademarks of Microsoft Corporation in the United States and in other countries. All other trademarks mentioned in this document are the trademarks of their respective owners.

CANOGA PERKINS CORPORATION

20600 Prairie Street

Chatsworth, California 91311-6008

Business Phone: (818) 718-6300

(Monday through Friday 7 a.m. - 5 p.m. Pacific Time)

FAX: (818) 718-6312 (24 hrs.)

Web Site: www.canoga.com

E-mail: fiber@canoga.com

Installation Version 2.00

Product Number 6916000

Preliminary Rev. 1 09/2008

KH

INSTALLING CANOGAVIEW EMS

INTRODUCTION

CanogaView EMS

CanogaView EMS denotes a web-based, comprehensive Element Management System used to monitor and provision Canoga Perkins’ managed devices. CanogaView EMS is a structure of products designed to provide the upmost standards for managing these devices. Developed using open source technology, managing services include a core component followed by the installation of additional, optional applications. These optional application packages are dependent on the common set of services provided by the core.

Based on the server-side, client-side paradigm, the CanogaView EMS server is responsible for deploying CanogaView’s applications for use by the client, which is any web browser with Ethernet accessibility to the CanogaView EMS server.

The separate device packages are available according to the customer’s needs in terms of the Canoga Perkins’ devices deployed in their networks. Each device package is independent of any other device package and can be installed or removed at any time.

CanogaView EMS requires the installation of its core services prior to the installation of any optional packages. Optional packages may be installed as required afterwards. Each optional package follows a very similar installation and uninstall procedure.

Installation Overview

This document describes step-by-step procedures for the installation of both CanogaView EMS Core and Report Server on your Windows or Sun Server. It also includes uninstall procedures for these packages.

The major components of the CanogaView EMS Core and Report Server include:

• GlassFish project application server platform available under the Common Development and Distribution License (CDDL) V 1.0

• Apache Derby relational database available under the Apache License, Version 2.0

• JasperServer report server under the GNU General Public License (GPL) Open Source License

• Alarm Monitoring (Active and Historical alarm monitoring)

• Security (User accounts based on role and group assignments)

• Online Help System

• Utilities (Alarm setup, alarm purge and server Admin console)

Ca nogaView EMS In sta llation G uide

This document describes step-by-step procedures for the installation of both CanogaView EMS Core Services and Report Server on your Windows or Sun Server. It also includes uninstall procedures for these packages.

The following files will be used on the installation CD to install the system: (Windows) csem-core-

install-win32 and csem-rptsvr-install-win32 or (Solaris) csem-core-install-solaris and csemrptsvr-install-solaris.

• csem-core-install installs the CanogaView EMS Core and includes both the Java Runtime Environment (JRE) and Java Development Kit (JDK). If you already have these Java packages on your system, you may be able to use them provided they are the proper versions. For the Java Runtime Environment package, version 5 (1.5.x) or greater is required. For the Java Development Kit, version 6 (1.6.x) or greater is required.

• csem-rptsvr-install installs the CanogaView 2.0 Report Server.

CanogaView EMS Core must be installed before the Report Server.

Do not attempt to install CanogaView EMS over a previous CanogaView EMS installation.

• To reinstall CanogaView EMS Core, first uninstall Report Server then CanogaView EMS Core. Next, reinstall the Core followed by the Report Server.

• To reinstall just the Report Server, uninstall and then reinstall it.

(2)

CanogaView EMS In stallation Guide PLATFORM REQUIREMENTS

PLATFORM REQUIREMENTS

Windows Operating Systems

Minimum Hardware Requirements:

• Intel Pentium 1GHz Processor Dual Core (2GHz or higher recommended)

• 1GB RAM (2GB or higher recommended)

• 1GB free disk space for application space (2GB or higher recommended)

• 500MB free disk space of tmp space during the installation process

• SVGA Monitor with 256 colors and 1024x768 resolution will display but the quality will be extremely poor. It is strongly recommended that 65536 colors (16 bit) or higher be used.

• Network Adapter Card is required for Ethernet LAN support

Minimum Software Requirements:

• Microsoft Windows OS with TCP/IP Services, all with the latest Service Pack updates:

Windows 2000 -or- Windows XP -or- Vista

•Web Browser

Mozilla Firefox (recommended) version 2.0 or greater -or- Internet Explorer version 7 or greater

• Java Runtime Environment (JRE) version 5 (1.5.x) or greater

• Java Development Kit (JDK) version 6 (1.6.x) or greater

Solaris Operating Systems

Minimum Hardware Requirements:

• Sun SparcStation

• 1GB RAM (2GB or higher recommended)

• 1GB free disk space for application space (2GB or higher recommended)

• 500MB free disk space of tmp space during the installation procedure

•CD-ROM Drive

Minimum Software Requirements:

• Sun Solaris OS Version 8 with the latest patches from Sun Microsystems

• Sun Solaris OS Version 10 with the latest patches Sun Microsystems

•Web Browser

Mozilla Firefox (recommended) version 2.0 or greater

• Java Runtime Environment (JRE) version 5 (1.5.x) or greater

• Java Development Kit (JDK) version 6 (1.6.x) or greater

(3)

CanogaView EMS In stallation Guide PLATFORM REQUIREMENTS

(4)

CanogaView EMS Installation Guide INSTALLATION

INSTALLATION

Windows Operating Systems

Installing CanogaView EMS for Windows is a two-part process. The Core Services must be installed first, followed by the Report Server.

PART 1: INSTALLING THE CORE SERVICES

Installation for the Core Services is comprised of a 13 step procedure that is controlled by the installation program. Each step must be completed thoroughly and consecutively in order for proper installation.

STEP 1 BEGIN INSTALLATION

Locate the folder csem-core-2.0 on the installation CD and execute the file core-installwin32.exe.

When the Information window appears, click Next.

If the installation procedure does not detect the proper version 5 (1.5.x) or greater of the Java Runtime Environment (JRE), a window will appear indicating that a Java Runtime Environment could not be found. Select one of the following options, then click OK.

• manually specify the location of an existing Java Runtime Environment.

• automatically install the Java Runtime Environment provided with this software (recom- mended).

• download the latest version of the Sun Java Runtime Environment from the Internet.

•If the Welcome to Java window appears, click Accept to install the JRE. When the Thank

You! window appears, click Finish.

STEP 2 LICENSING AGREEMENTS

Review the licensing agreements. You must accept the licensing terms to continue, then click

Next.

STEP 3 EXISTING INSTALLATION CHECK

This is an internal procedure that checks to verify that an existing CanogaView EMS Core is not already installed.

STEP 4 TARGET PATH

The Target Path window appears displaying the default location where CanogaView EMS Core will be installed. Should you require a different location, use the Browse button.

When finished, click Next.

If the directory in which you will install the CanogaView EMS Core files does not already exist, a popup appears indicating that the directory will be created. Note the location where you install this package, as you will require this information should there be need to uninstall it at a later time.

Click OK to continue.

STEP 5 JDK PATH (UNIX ONLY)

This step will be skipped during the Windows installation.

(5)

CanogaView EMS Installation Guide INSTALLATION

STEP 6 JDK PATH (WINDOWS ONLY)

If the installation procedure detects the proper version 6 (1.6.x) or greater of Java Development Kit on your system, its path will appear.

To ac c e p t t h i s , c l i c k Next.

If the installation procedure does not detect the proper version of JDK version 6 (1.6.x) or greater, use the Browse button to find it.

If a proper version is found, click Next to accept it.

If you find a version earlier than 1.6.0, the path will appear in the JDK Path window BUT you will not be able to proceed to the next window.

<OR>

You can let the installation procedure install the JDK:

•Click the Install button to initiate JDK installation. A popup indicates that files are being extracted.

• When the Java Development Kit License window appears, click Accept.

• When the Custom Setup window appears, click Next to install program features.

• If a popup appears indicating there is a Public JRE installed and asks if you want to reinstall it, click No.

• When the Wizard Completed window appears, click Finish. (If the Show the readme file field is checked, the README window appears.) A popup should indicate that the JDK has completed successfully.

•The JDK Path window now displays the installation path of the JDK. Click Next.

STEP 7 GLASSFISH INSTALLATION OPTIONS

The Glassfish Installation Options window appears displaying Domain and network ports information. You may change any of the information in this window exercising a few cautions:

• Administrator user name and Administrator password fields hold system defaults. The user name and password allow you to log into the Server Admin Console which is a feature located in the CanogaView EMS menu under Utilities. Make note of the default username and password. Should you decide to change them, make note of the new ones.

• The default ports can be used provided they are not already in use. If in use, you can define new ports.

If you try to use a port that is already in use, you will see a notice later in the installation indicating that an installation failure has occurred.

If you change the top port number (8080 default) listed in the Glassfish Installation Options window, be sure to write it down as it is required for the final step in this procedure.

When finished, click Next.

The Administrator user name and Administrator password are not the username and password for logging into the CanogaView EMS Core features. The default username and password for logging into the CanogaView EMS Core features is admin for both, i.e., admin is the default username and also the default password. You can change these after you log into CanogaView EMS.

STEP 8 USER DATA

The User Data window appears and shows the SNMP Notification Port number. The default port number is 162. If this port is already in use by another application, you can change the number to a different port number (e.g. 164).

Make necessary changes, then click Next to continue.

STEP 9 SUMMARY CONFIGURATION DATA

The Summary Configuration Data window appears and displays JDK information. Review the data. then click Next to continue.

(6)

CanogaView EMS Installation Guide INSTALLATION

STEP 10 INSTALLATION

The Installation window copies files from the installation CD to disk. When the installation procedure is finished, click Next.

STEP 11 PERFORM EXTERNAL PROCESSES

The Perform External Processes window performs the following:

• Registers CanogaView Application Server Service

• Starts the CanogaView Application Server Service

• Configures the Application Server

• Customizes the CanogaView Application

• Deploys CanogaView Application

• Restarts the CanogaView Application Server Service

When the Perform External Processes procedure is finished, click Next.

STEP 12

SETUP SHORTCUTS

The Setup Shortcuts window appears. To create shortcuts, be sure the Create shortcuts in the Start-Menu is checked and then select a location (folder) for the shortcuts in the Select a Program Group for the Shortcuts window, (e.g. Startup) then click Next. If you accept the default location,

the shortcuts will install in the Start Menu under Programs or All Programs. When finished, click Next.

STEP 13 INSTALLATION FINISHED

When the Installation Finished window appears it indicates that the installation was successful and displays the location of the uninstall program for CanogaView EMS.

Note the location where you installed this package, as you will require this information should there be need to uninstall it at a later time.

Click Done.

PART 2: INSTALLING REPORT SERVER

Installation for the Report Server is comprised of an 11 step procedure that is controlled by the installation program. Each step must be completed thoroughly and consecutively in order for proper installation.

STEP 1 BEGIN INSTALLATION

Locate the folder csem-rptsvr-1.0 on the installation CD and execute the file rptsvr-installwin32.exe.

When the Information window appears, click Next.

If you are installing the Reports Server with out previously installing the Core, an error message will appear stating the core installation was not found. You can click Browse to search for the core. If it’s still not found, click Quit to close the window and then install the Core as the installation procedure directs.

STEP 2 LICENSING AGREEMENTS

Review the licensing agreements. You must accept the licensing terms to continue, then click

Next.

STEP 3 INTERNAL PROCESS

Checks for required fields

STEP 4 INTERNAL PROCESS

Checks for required fields

(7)

CanogaView EMS Installation Guide INSTALLATION

STEP 5 TARGET PATH

The Target Path window appears indicating the default installation location for the Report package. Should you prefer a different location, you can choose it using the Browse button. When finished, click Next.

If the directory in which you will install the Report Server does not already exist, a popup appears indicating that the directory will be created. Note the location where you install this package, as you will require this information should there be need to uninstall it at a later time.

Click OK to continue.

STEP 6 SELECT INSTALLATION PACKAGES

When the Select Installation Packages window appears, you can select only the Source package to be installed. The grayed packages are required by the installation. If you do not expect to modify Report Server software, it is not necessary to install the Source package.

When finished, click Next.

STEP 7 SUMMARY CONFIGURATION DATA

The Summary Configuration Data window appears and displays installation path information. Review the data, then click Next to continue.

STEP 8 INSTALLATION

The Installation window copies files from the installation CD to disk. When the installation procedure is finished, click Next.

STEP 9 PERFORM EXTERNAL PROCESSES

The Perform External Processes window performs the following:

• Creates Report Server Database

• Installs individual reports

• Deploys Report Server applications

When the Perform External Processes procedure is finished, click Next.

STEP 10 SETUP SHORTCUTS

The Setup Shortcuts window appears. To create shortcuts, be sure the Create shortcuts in the Start-Menu field is checked and then select a location (folder) for the shortcuts in the Select a Program Group for the Shortcuts window, (e.g., Startup) then click Next. If you accept the

default location, the shortcuts will install in the Start Menu under Programs. When finished, click Next.

STEP 11 INSTALLATION FINISHED

When the Installation Finished window appears, it indicates that installation was successful and displays the location of the uninstall program for the Report Server. Note the locations where you installed this package, as you will require this information should there be need to uninstall it at a later time. Click Done.

Optional Packages Installation

Installation for optional packages PCS, PCS 9145 Plug-in, PCS 9145E Plug-in, Device Package 9145 and Device Package 9145E follows a very similar procedure to that of the Core and Report Server.

Follow the installation.txt file included on the installation cd for the appropriate optional package you wish to install. Each installation.txt file provides a step-by-step guide for the installation.

Solaris Operating Systems

(8)

CanogaView EMS Installation Guide INSTALLATION

Installing CanogaView EMS for Solaris is a two-step process. The Core Services must be installed first, followed by the Report Server.