ca spectrum user manual

CA SPECTRUM USER MANUAL v 1.0 CA SPECTRUM v 9.0

Page 1

CA SPECTRUM User Manual

I.CA SPECTRUM OVERVIEW 4

II. ABOUT SPECTROSERVER 5

(A) Client applications overview 5

III. ABOUT SPECTRUM CONTROL PANEL 6

(A) File menu 6

(B) Control menu 7

(C) Configure menu 8

(D) Control panel function buttons 9

(E) Message window 11

IV. PREREQUISITES FOR INSTALLING SPECTRUM 11

(A) System configurations for spectrum 11

(B) Virtualization environments: 13

(C) Disk striping and raid 13

(D) Symantec pcanywhere 13

(E) Recommendation for dual network interface cards (nics) 13

(F) Oneclick recommendations 13

(G) Prerequisites for windows 14


Page 2

V. INSTALLATION OF SPECTRUM 16

(A) Install spectrum remotely 16

(B) Oneclick web server and spectroservers on separate systems 16

(C) Start the installation on windows 16

(D) Files created during spectrum installation 19

(E) Spectrum services for windows 19

(F) How to install new components 19

(G) Patch installations 20

(H) Reinstall spectrum 20

(I) Starting spectrum and oneclick 23

VI. POST-INSTALLATION CONFIGURATIONS 25

(A) Set oneclick client restrictions 25

(B) Change the oneclick web server port 26

VII. UPGRADING SPECTRUM 27

(A) Pre-upgrade and post-upgrade tasks 27

(B) Upgrading from earlier versions 27

VIII. MODELING YOUR IT INFRASTUCTURE 30

(A) Spectrum oneclick topologies 30

(B) Oneclick theme icons and symbols 34

(C) Icon condition colors 35

(D) Spectrum oneclick discovery 35

(E) Modeling recommendations 35

(F) Discovering and modeling your network 36


Page 3

(G) Discovery console 37

(H) Open the discovery console 42

(I) After discovering and modeling 45

(J) Modeling your network manually 46

(K) How to model manually in the universe topology 46

(L) Change device polling intervals 48

(M) Create connections (pipes) between modeled devices 50

(N) Define a global collection 53

(O) Create a dynamic collection 54

(P) Recommended process for modeling locations 57

(Q) Configuring modeled devices and interfaces 57

(R) Modify topology views 62

(S) Model and maintain snmpv3 devices 66

(T) Managing mibs and traps 67

(U) Spectrum intelligence 69

IX. INTEGRATION MODULES 70

(A) Ca ehealth and ca spectrum 70

(B) Spectrum and ca unicenter nsm 76

X. TROUBLESHOOTING 80


Page 4

CA SPECTRUM Overview:

SPECTRUM is a services and infrastructure management system that monitors the state of managed

elements including devices, applications, host systems, and connections. Status information such as fault

and performance data from these elements is collected and stored. SPECTRUM constantly analyzes this

information to track conditions within the computing infrastructure. If an abnormal condition is detected, it

is isolated and you are alerted. SPECTRUM also presents you with possible causes and solutions to the

problem.

The SPECTRUM design is based on the client/server model. Its primary server, SpectroSERVER, is responsible for collecting, storing, and processing data. The SpectroSERVER uses Inductive Modeling Technology (IMT) to perform these functions. IMT combines an object-oriented database with the intelligence of inference handlers. The object-oriented database contains model types that define how a managed element is represented, and models that represent specific managed elements. It also contains relations that define possible associations between model types. Inference handlers provide additional

functionality to this system by reacting to events produced by SPECTRUM or managed elements. The SpectroSERVER stores data in the knowledge base where model types, models, and relations are defined. The SpectroSERVER also polls managed elements and receives alert information from the computing infrastructure. It analyzes and stores this information in the knowledge base, and gives client applications access to this information.

SPECTRUM includes a number of client applications. Its main client application, OneClick, provides the

graphical user interface that is used to monitor the network and launch other client applications. The

views provided in the OneClick Console contain icons, tables, and graphs that represent the different

elements of the network. These graphical components present status information and provide access to

management facilities specific to the managed element they represent. All information presented by client

applications is retrieved from the SpectroSERVER.


Page 5

About SpectroSERVER:

SpectroSERVER is the primary server for the SPECTRUM product. It functions as a database server,

modeling engine, and device manager. SpectroSERVER processes events, generates alarms, and tracks

statistics concerning managed elements. All of this information is available to client applications, and can

be requested through the SpectroSERVER application programming interface (SSAPI) and the SPECTRUM

CORBA interface.

The following illustration shows a simplified view of the various components of SpectroSERVER:

Note: SpectroSERVER is also referred to as the VNM or Virtual Network Machine. Specifically, the term

VNM refers to the portion of SpectroSERVER that is responsible for modeling managed elements.

Client Applications Overview: The main SPECTRUM client application is OneClick but there are also a few other client applications that let you interact with the information stored and processed on the SpectroSERVER. Client applications that may be needed when customizing SPECTRUM or integrating with SPECTRUM include the following:

AlarmNotifier: This application is used to forward alarm data to user-defined scripts or third-party applications.

Process daemon: The process daemon is a process launching and tracking daemon that lets SPECTRUM control various processes running on a workstation. It starts processes when requested by an application, such as the Control Panel. It can also start processes on system boot if configured to do so. It automatically restarts critical processes if they stop unexpectedly. The SPECTRUM Control Panel is the only executable actually launched by you, the SPECTRUM user. All other applications are launched by the process daemon following a request by the user or another application. The process daemon operates in


Page 6

the background and is transparent to you. It automatically starts during SPECTRUM installation and whenever the system is started.

Model Type Editor: This application is used to derive new model types that support the

development of new management modules.

About SPECTRUM Control Panel: The SPECTRUM Control Panel allows you to configure SPECTRUM resources, start and stop the SpectroSERVER, perform database administration, and maintain the SPECTRUM installation.

You can access the SPECTRUM Control Panel on the SpectroSERVER machine in the: Windows environment by choosing Start, Programs, CA, SPECTRUM Control Panel. Solaris environment by choosing the Control Panel selection from the list of items on the

SPECTRUM menu. Linux environment by running the SCP command located in /bin/

Note: You must be logged in as the install user or someone in the install users group to launch

applications using the Control Panel.

The following image shows an example of the Control Panel:

File Menu: The File menu provides Database Administration functions and an Exit function to exit from the SPECTRUM

Control Panel


Page 7

Select Host Machine This option allows you to select the SpectroSERVER that you want to manage using the Control Panel.

Save Database Depending on the configuration of the host machine, this selection either allows you to create an on-line

backup or perform a complete save of the SpectroSERVER database. The Save Database selection serves

the same function as the control panel Database Administration Save Database button.

Restore Database This selection lets you load a previously saved database. The Restore Database selection serves the same

function as the control panel Database Administration Restore Database button.

To restore the database 1. Click Restore Database. A dialog appears asking whether you wish to initialize your database. 2. Click Yes if you want to initialize the database or click No to perform a models-only load. In either case, the Restore Database dialog appears. 3. Locate and select a previously-saved database backup and click Open for the Windows environment or

Ok Solaris environment. If SpectroSERVER is running, SpectroSERVER restarts after the database loads. 4. Click OK to begin the restore.

Initialize to Legacy Database Initialize to Legacy Database initializes your database to the state that existed following your last

installation. All models specific to your network are removed, leaving a database structure consisting of

the modeling catalog and a limited number of internal models.

Important! Do not use this feature without first making a backup copy of your database. To initialize your SpectroSERVER database 1.Select File, Initialize to Legacy Database from the menu. An information dialog appears warning you of the consequences of initializing. 2.If you understand the consequences and still want to initialize your database, click Yes. If SpectroSERVER is running when you start to initialize your database, a second dialog appears indicating that the SpectroSERVER will be shut down during this process. 3.Click Yes to start the initialization. 4.Restart your OneClick web server and restart any open OneClick consoles.

SPECTRUM refreshes the OC Explorer hierarchy and topology view and the SpectroSERVER database is

initialized.

Control Menu: The Control menu provides access to the following selections: Start/Stop SpectroSERVER This selection controls the operation of the SpectroSERVER. When the SpectroSERVER is running, the menu selection reads Stop SpectroSERVER. If the SpectroSERVER is inactive, the menu selection reads Start SpectroSERVER. Auto Start/Stop Archive Manager This selection lets you configure the Archive Manager to start or stop with the SpectroSERVER on the workstation you are managing. If you disable the Archive Manager, the Auto Stop/Start Archive Manager option becomes unavailable. Start/Stop Archive Manager This selection starts or stops the Archive Manager. Note: The Archive Manager Control buttons will be disabled when any other running process has locked

the database. Do not attempt to change the state of the Archive Manager when running an online backup.


Page 8

OneClick Administration The OneClick Administration Control menu selection serves as a quick way to access the OneClick Administration Pages. Clicking OneClick Administration prompts for the Host and Port of the OneClick web server and opens a browser to the OneClick Administration page. Host and Port settings are remembered the next time you open the dialog. Note: To determine the browser location on Windows, SPECTRUM opens the default web browser for the

current user of the system. To determine the browser location on Unix and Linux, SPECTRUM uses the

PATH variable to first locate Firefox, Mozilla, and then Netscape. If you would like to specify a specific

browser, you can set the SPECTRUM_BROWSER environment variable.

SpectroSERVER Performance The SpectroSERVER Performance Control menu selection opens the Performance View application.

Users By selecting the Users Control menu selection, you can view user details, set a new password for an existing user, and create an Administrative super user account.

Configure Menu:

The Configure menu allows you to configure SpectroSERVER, location server, host security and start the Model Type Editor. SpectroSERVER

The SpectroSERVER Configuration window lets you control certain aspects of the SpectroSERVER configuration. When you make changes in this window, you are editing the .vnmrc resource file, which controls SpectroSERVER operation and performance

License Your SPECTRUM license conveys the right to use SpectroSERVER for a set period of time as controlled by a

SPECTRUM key and associated expiration date. The key and date are printed on a certificate shipped with the installation media. The SPECTRUM key is entered in the License area of the SpectroSERVER Configuration window. If a new SPECTRUM key is needed, enter the new key in the License field.

Performance Tuning SpectroSERVER is a multi-threaded process. During normal operation, each subsystem allocates numerous

work threads. Since each thread consumes memory and computing capacity, it is important to understand

how they can affect performance. Max Number of Poll Threads and Work Thread Age are two of the

parameters used to control the allocation of work threads.

Max. Number of Poll Threads

This parameter sets the maximum number of work threads dedicated to polling.

Work Thread Age

Work threads that are no longer needed by a subsystem are returned to a work thread pool. This

resource specifies how long (in seconds) a work thread can remain in the pool without being used.

File Paths

The SpectroSERVER Configuration window provides easy access to the file paths defined within the

.vnmrc file.

VNM File Path

This parameter specifies the root subdirectory that contains SpectroSERVER external files, such as

specific device alert mapping.


Page 9

Communications

Communications Port This parameter specifies a TCP port number indicating the port through

which the clients user interface communicates with the SpectroSERVER. This parameter can be any valid,

unreserved TCP port greater than the port number assigned to the IPPoPORT_USERRESERVED and below

64,000. The default is OxBEEF. SNMP Comm. Port This parameter specifies a value that can be used to

select a port from which SNMP requests can be sent via the SpectroSERVER. It can be set to any unsigned

16-bit integer in the range 0x400 (1,024) to 0xFFFF (65,535). Some implementations (e.g., IBM

Mainframe MVS system) of SNMP agents treat the port as a signed number. In these cases, this resource

must be set to a value between 0x400 (1,024) to 0x7FFF (32,768).

Event Log Under normal conditions, events are recorded in SPECTRUMs Distributed Data Management (DDM) database. However, if communication between the SpectroSERVER and the Archive Manager is lost, event information is stored temporarily in the SpectroSERVERs database until communication is re-established.

The growth of this temporary event data in the SpectroSERVER database is regulated by entries in

the SpectroSERVER .vnmrc resource file. The Event Log fields enable you to easily edit these settings.

Max Event Recs to Save

Maximum number of records that can be stored in the database. The default is 20,000 records.

Event Record Increment

The number of records to be deleted from the database when the number of records exceeds the

Max Event Recs to Save value. The default is 100 records. If you remove the

event_record_increment entry from the .vnmrc file, the default is 250 records

Statistics Log Under normal conditions, statistics are recorded in SPECTRUMs Distributed Data Management (DDM) database. If communication between the SpectroSERVER and the Archive Manager is lost, however, statistics information is stored temporarily in the SpectroSERVERs database until communication is re-established. The growth of this temporary statistics data in the SpectroSERVER database is controlled by entries in the SpectroSERVER .vnmrc resource file. Use the Event Log fields to edit these settings. Max Statistics Recs to Save

The maximum number of records that can be stored in the database. The default is 5,000 records.

Statistics Record Increment

The number of records to be deleted from the Statistics Log database when the number of records

exceeds the Max Statistics Recs to Save value. The default is 500 records.

Location Server

The Location Server is used to locate other SPECTRUM services on the network. The Location Server

Configuration window lets you define the location server characteristics and your client applications.

Control Panel Function Buttons: Process Control This section discusses the functions of the buttons in the Process Control section of the Control Panel


Page 10

Start/Stop SpectroSERVER The Start/Stop SpectroSERVER button controls operation of SpectroSERVER (and the Archive Manager which can automatically start stop with the SpectroSERVER). This button is labeled Start SpectroSERVER when the server is INACTIVE or STOPPED. When the legend on the button reads Start SpectroSERVER, click this button to launch the SpectroSERVER. Conversely, this button is labeled Stop SpectroSERVER whenever the server is RUNNING or STARTING.

When the legend reads Stop SpectroSERVER, click this button to stop the active SpectroSERVER. This

button is disabled when the state is STOPPING, SAVING, RESTORING, and EDITING. You can also start

and stop SpectroSERVER from the Control menu.

OneClick Administration The OneClick Administration button serves as a quick way to access the OneClick Administration Pages.

Clicking OneClick Administration prompts for the Host and Port of the OneClick web server and opens a

browser to the OneClick Administration page. Host and Port settings are remembered the next time you

open the dialog.

Database Administration

The Database Administration buttons allow you to save and restore a SPECTRUM database.

Save Database The way the Save function works depends on the state of your local host. You can either generate an on-line backup or you can perform a complete save of the database. On-Line Backup

If the SpectroSERVER is running, Save initiates a SPECTRUM On-Line Backup

Save If the SpectroSERVER is not running Save initiates a complete save of the SpectroSERVER database using SSdbsave (with the -c and -m switches). To complete the save operation 1.Click Save Database.

The Save as dialog opens. 2.Navigate to the directory you want to save your database and click OK to begin the save.

Restore Database This selection lets you load a previously saved database.

Configure The Configure section of the control panel has two buttons, Host Security and Location Server. Host Security The Host Security window lets you enter a list of servers and users allowed to connect to the host. This is

implemented by editing the .hostrc file in the SPECTRUM directory.

Location Server The Location Server is used to locate other SPECTRUM services on the network. The Location Server

Configuration window lets you define the location server characteristics and you client applications

Exit Click the Exit button at the lower right corner of the SPECTRUM Control Panel main window to close the

Control Panel. This action has no effect on processes that were started from the SPECTRUM Control Panel.

You can restart the SPECTRUM Control Panel at any time. The panel automatically synchronizes with the

executing process and displays the current status.


Page 11

Message Window:

This text window in the lower half of the SPECTRUM Control Panel displays output messages and errors related to the SpectroSERVER process. Scroll bars let you move your field of view up and down, and left and right. You can stop messages from

scrolling by selecting the Freeze option or scrolling up. Select the Scroll option to resume message scrolling, or scroll to the bottom of the message window. All queued-up messages are displayed immediately when the window is unfrozen. No messages are lost. Some examples of common status messages displayed in the message window follow:

The server has not been started The server is starting

Clients cannot attach to the server yet..

The server is up and running

Clients can now attach to the server.

The server is being administratively shut down

The server has abnormally terminated. (This should not occur during normal operation.)

The server database is being backed-up

The server is in an inactive state at this time.

The server database is being restored from a backup


The database modeling catalog is being edited via the Model Type Editor (MTE)


The database is locked by an unknown process

A process other than SpectroSERVER, Save, Restore, or the Model Type Editor has locked the

database.

SpectroSERVER Status

The Status field on the SPECTRUM Control Panel indicates the status of the SpectroSERVER with text and

color. Starting: yellow

This field changes to Running (green) after the startup period expires.

Stopping: yellow

This field changes to Inactive (blue) after the server has shutdown.

Running: green

This field indicates a normal running state.

Terminated: red

This condition is abnormal and indicates an error.

Inactive: blue

This field indicates that server shutdown is complete.

Prerequisites for installing SPECTRUM

System Configurations for SPECTRUM:

The following table lists the system configurations necessary for installing SpectroSERVER and OneClick. Note: The following table assumes each workstation manages fewer than 1000 devices with an average of

24 ports on each device.


Page 12

* Or any comparable x86 1.5 GHz or better processor. ^ Disk Drives: For optimum performance, SPECTRUM should run on systems with at least two separate ultra-wide, 10k revolutions-per-minute (RPM), SCSI disk drives. Disk1 = OS + swap space/virtual

memory. Disk2 = all SS/OC components. Swap/Virtual Memory: Set the amount of swap space/virtual memory to twice the amount of physical memory and no greater than 4 GB. The following table lists the system configuration for SpectroSERVER and OneClick. Note: The following table assumes that each workstation manages fewer than 1000 devices with an

average of 24 ports on each device.

* It is highly recommended to have a separate dedicated system for OC/SRM.


Page 13

Assumes the SpectroSERVER is being monitored by SRM (polling for event data and asset change data). Otherwise, 1536 MB is acceptable. ^ Or any comparable Intel x86 1.5 GHz or better processor.

Disk Drives: For optimum performance, SPECTRUM should run on systems with at least two separate ultra-wide, 10k rpm, SCSI disk drives. Disk1 = OS + swap space/virtual memory. Disk2 = all SS and OC/SRM components.

Swap/Virtual Memory: Set the amount of swap space/virtual memory to twice the amount of physical

memory and no greater than 4 GB.

Virtualization Environments:

SPECTRUM supports the following virtualization environments: Solaris Zones for Solaris 10

VMWare for Windows and Linux

Disk Striping and RAID:

For optimum performance, you can run SPECTRUM on systems with multiple, ultrawide, 10k rpm, SCSI disk drives that use disk striping or RAID (redundant array of independent disks) technologies.

Disk striping is a technique of spreading data over multiple disk drives. RAID is a disk drive system that uses two or more drives in combination for fault tolerance and performance improvement.

Symantec pcAnywhere:

Symantec pcAnywhere can cause Java to lock and prevent SPECTRUM's Java applications such as OneClick Console, Control Panel, Model Type Editor, and Performance View from launching. The processes start, but the GUIs do not launch. If you stop pcAnywhere, SPECTRUM's Java-based applications launch, and the GUIs display correctly. To resolve this issue, install or upgrade to DirectX version 9.0B, which is available at http://support.microsoft.com. Alternatively, you can stop the pcAnywhere Host Service prior to installation. After installing SPECTRUM

and OneClick, you can re-enable the pcAnywhere Host Service.

Recommendation for Dual Network Interface Cards (NICs):

You can run SPECTRUM on a machine that is using dual Network Interface Cards (NICs). The operating

system must be configured to route traffic to the primary interface. If routing at the operating system

level is set up so that incoming traffic on other interfaces routes to the primary interface, SPECTRUM can

manage the inbound SNMP/ICMP traffic.

OneClick Recommendations:

OneClick consists of a web server-based component and a client-based component, each of which requires different software. The OneClick web server includes the following: Apache Tomcat servlet engine MySQL database management system Java 2 Software Development Kit (SDK) Note: SPECTRUM supports only that version of JDK that ships with OneClick


Page 14

The OneClick client includes the following: Java Runtime Environment (JRE) with Java Web Start

Prerequisites for Windows:

Ensure you meet the following prerequisites before you install SPECTRUM on a Windows system. Administrator Privileges Ensure you log in as Administrator or as a user with administrator privileges. The installation software needs administrative privileges to evaluate available resources and run custom installation scripts. An initial installation generates residual files with administrator ownership. Subsequent upgrade installations also require administrative privileges. Fixed IP Address on Windows Ensure that the system on which you want to install SPECTRUM has a fixed IP address. If the Dynamic Host Control Protocol (DHCP) server issues a static address that never changes, you can enable DHCP on the system. Windows 2003 Server Hotfix If you are using SPECTRUM on a Windows 2003 server that has multiple IP addresses, a bug in the Windows 2003 Server operating system can cause problems with starting SPECTRUM. The Microsoft Knowledge Base Article 822713 states that on a Windows Server 2003-based computer with multiple IP addresses, the WindowsGetHostByName function does not return IP addresses in the correct order. The first IP address that is returned is the one with the lowest number instead of the primary IP

address. This issue causes SPECTRUM to associate the landscape handle you define during installation with an incorrect server IP address. When you attempt to start SPECTRUM, an error similar to the following occurs: Initializing SpectroSERVER database Setting landscape handle Error: CsDbLandscapeRep::put_loaded_landscape_map() - map does not contain a local entry.Error writing landscape map into DB Unable to set SS landscape handle. **_ Error during setting of landscape handle To fix this problem, download and install the hotfix associated with Microsoft Knowledge Base Article 822713 available at www.microsoft.com. Install this hotfix before you install SPECTRUM. Emergency Repair Disks You should create an emergency repair disk (ERD) before installing SPECTRUM, because the SPECTRUM installation may corrupt files. You can use the ERD to restore Windows configuration files. You should also create another ERD after a successful installation of SPECTRUM. Note: Windows Help files contain detailed instructions on creating an ERD. Set Display Properties for Microsoft Windows Server 2003 You can set display properties for Microsoft Windows Server 2003 to view SPECTRUM more effectively. To set display properties for Microsoft Windows Server 2003

1. Right-click an open area of the desktop and select Properties. The Display Properties dialog appears. 2. Click Appearance and click Effects. The Effects dialog appears.

3. Disable the option Show window contents while dragging and click OK. The Display Properties dialog re-appears. 4. Click the Settings tab and select True Color (32-bit) from the Color quality drop-down menu.


Page 15

5. On the Screen resolution bar, slide to the minimum, 1024 by 768 pixels and click OK to let SPECTRUM fit the screen. The display properties are set. Set Display Properties for Microsoft Windows Server 2008 You can set display properties for Microsoft Windows Server 2008 to view SPECTRUM more effectively.

To set display properties for Microsoft Windows Server 2008 1. Right-click an open area of the desktop and select Personalize. 2. Click Window Color and Appearance.

3. Click Effects. 4. Clear the option Show window contents while dragging and click OK. Select OK on the Appearance Settings window to exit. 5. Select Desktop Background in the Personalization window. 6. Select True Color (32-bit) from the Color quality drop-down menu on the Monitor tab. 7. On the Screen resolution bar, slide to the minimum, 1024 by 768 pixels, and click OK to let SPECTRUM fit the screen. 8. Exit the Personalization window.

The display properties are set.

Network and Security Settings If you want to use email for applications such as SPECTRUM Enterprise Alarm Manager, ensure that the user profile of the user logged in and running SPECTRUM is configured to send email using the supported service provider. Set security as required for the directory where you install SPECTRUM. Changes to the directory hierarchy security are preserved by SPECTRUM if the settings are made before installation. Note: Restart your system after making any changes

User Audit If user auditing is enabled on Windows, every action is audited, resulting in many entries in the Windows

Event Log. We recommend that you disable Windows user auditing because it retards SPECTRUM system

performance.

Convert the File System to NTFS You should install SPECTRUM in an NTFS file system partition. If your disk drive is formatted as a FAT

partition, convert the Windows file system to NTFS. To convert the Windows file system to NTFS 1. Execute cd Windows\system32 from the command line. 2. Run the CONVERT utility as follows:

CONVERT C: /FS:NTFS Note: You can run the conversion utility without damaging or deleting existing data. If the hard drive is already converted, a message appears. 3. Restart your system for the reformatting to take effect. The file system is converted.


Page 16

Installation of SPECTRUM:

Install SPECTRUM Remotely:

You can use Telnet to remotely install SPECTRUM over your network. You can also use the GUI or distributed installation to remotely install SPECTRUM. For example, from a Windows system, you can use the GUI installation to install SPECTRUM to a Solaris or Linux system using the installation media for that platform. You can only perform one system installation at a time. You must know the host name of the remote

system and the administrator ID and password. To install SPECTRUM remotely 1. If the remote system does not have SPECTRUM already installed, insert the SPECTRUM installation media into the appropriate drive on the computer you want to remotely install SPECTRUM on.

2. Install the SPECTRUM Remote Administration Daemon (SRAdmin) on the computer you want to remotely install SPECTRUM on 3. Insert the SPECTRUM installation media for the computer you want to remotely install SPECTRUM on into the appropriate drive of the local computer.

4. Install SPECTRUM as mentioned from page no: SPECTRUM is installed remotely.

OneClick Web Server and SpectroSERVERs on Separate Systems:

To install the OneClick web server and a SpectroSERVER on separate systems, repeat the installation process for each system installation. Be sure to select the appropriate features on the Select Features dialog during installation. You can also use the distributed installation to install different components to separate systems at the same time. Note: Older OneClick clients (for example, version 7.1 SP3 of JMibTools or the legacy Autodiscovery) and

OneClick web servers must be upgraded to SPECTRUM r9.0.

Start the Installation on Windows:

Note: You cannot install a released version of SPECTRUM on top of a beta or evaluation version of the product. You must uninstall the beta or evaluation version first.

To start the installation 1. Stop all running applications. 2. Ensure you have met the system requirements and prerequisites Important! Disable your antivirus software's realtime protection prior to installing SPECTRUM to avoid potential problems with files that may be in use by the realtime protection software. 3. Log in as a user with administrator rights. 4. Insert the SPECTRUM installation media into the appropriate drive. If autorun is disabled, you can double-click on setupnt.exe from the Explorer view to start the installation. The installation starts.


Page 17

5. Select the Install CA SPECTRUM Network Fault Manager option. The Introduction dialog appears. 3. Click Next to proceed. The License Agreement dialog appears.

4. Accept the license agreement and click Next. The Destination Host dialog appears. 5. Enter the name of the host system where you are installing SPECTRUM and click Next.

Note: If you are installing SPECTRUM and OneClick on remote platforms on your network, you must follow the steps in Remote Installations. The SRAdmin Authentication dialog appears. Note: If the dialog, Unable to connect to SPECTRUM Remote Administration Daemon (sradmin) appears, you must install SRAdmin before continuing with the installation. Click Install on this dialog to install SRAdmin. 6. Enter a user name and password as follows, and click Next: For a Solaris or Linux installation, enter a user name with root access, or you can use a super user doers (sudoers) file for root permissions. If you have root access when starting this installation, you will not be prompted.

For a Windows installation, enter a user name that has Administrator rights, and verify the domain name (if applicable). The Destination Location dialog appears. 7. Click Next to install SPECTRUM in the default directory. The default directory is C:\win32app\SPECTRUM

on Windows and /usr/SPECTRUM on Solaris and Linux. If you are performing an in-place upgrade, the installation program detects the previous installation directory. Important! Do not change the default destination to a location other than the directory that contains the SPECTRUM database you are upgrading. On Solaris and Linux, do not use /opt/SPECTRUM as an installation directory. This location and name are reserved for a directory that is created automatically

during the installation. To install SPECTRUM in a location other than the default folder, click Choose, select a folder, and click Next. Note: The Choose button only appears for a local installation (not for a non-local, remote installation). You cannot install SPECTRUM into a directory that contains a space in the name. The SPECTRUM Key dialog appears.

8. Enter the SPECTRUM key and click Next. Note: Ensure the SPECTRUM key that you enter is for the same version listed on the dialog. The Select Features dialog appears. Features are displayed based on the SPECTRUM key you entered. 9. Select the items you want to install from the Features list and click Next.

Important! Installing OneClick on a single-CPU SpectroSERVER host system can degrade the performance of both SpectroSERVER and OneClick. We recommend installing OneClick on a separate dedicated system. The Host Evaluation dialog appears.


Page 18

10. Scroll down the information to ensure there are no warnings and click Next to proceed. The SPECTRUM Installation Owner dialog appears. 11. Enter the user name and password as follows, and click Next. This user name will be used to create the initial SPECTRUM user (if installing SpectroSERVER) and becomes the installation owner. For a OneClick installation, the user name also determines the SpectroSERVERs to which the OneClick web

server connects: For a Solaris or Linux installation, enter the user name for the host system. The installation owner must be a non-root user. For a Windows installation, enter a domain name (if applicable), user name, and password. The domain name and password will also be used to configure the SPECTRUM Process Daemon service. The domain and password will not be used or stored in SPECTRUM.

Note: If the installation owner is a non-administrator, you will not be able to restart the processd service as the installation owner. However, because you should not have to restart the service on a normal day-to-day basis, we recommend that the installation owner be a non-administrator to increase security and simplify password maintenance. Note: For first-time installations, the default SPECTRUM password for the installation owner is spectrum. Important! If you are installing OneClick, be sure to specify a SPECTRUM username that has the administrative license associated with it. This user should have access to all models in SPECTRUM (ADMIN access). It is recommended that you specify the installation owner that you specified during the SpectroSERVER installations. This user should also exist on the installation host and does not need to be a Windows administrative user.

The Main Location Server dialog appears. When you install SPECTRUM components, you also automatically install a location server. However, if you are installing OneClick only, you will not automatically install a location server. Note: In a distributed environment, SPECTRUM uses location servers to maintain the VNM landscape map and provide connection services to client applications.

12. Enter a hostname to be the main location server and click Next. Note: SPECTRUM must be able to resolve the hostname, whether or not you provide a fully qualified hostname. The OneClick Port Number dialog appears, with the default value automatically populated.

13. Enter a number (as suggested on the dialog) if you want a port number other than the default, and click Next. Note: The default port is 80 for Windows and 8080 for Solaris and Linux. 15. Click Next. The Review Settings dialog appears.

16. Scroll down to ensure all the settings are what you selected and click Next. The Installing SPECTRUM dialog appears. After SPECTRUM is installed, the status changes to Installation successful and the Next button is enabled. 17. Click Next. The Installation Complete dialog appears.

18. Click Done. The configuration dialog appears for a brief moment and closes. SPECTRUM is configured for your system. 19. Click Close on the initial Install dialog, and log out and log back in.


Page 19

SPECTRUM is installed.

Files Created During SPECTRUM Installation:

The SPECTRUM installation adds the following file types:

SPECTRUM Process Daemon (processd) Files (Linux and Solaris) SPECTRUM Remote Administration Daemon Files (Linux and Solaris) Installation Database Savefiles SPECTRUM Services (Windows)

Installation Database Savefiles The SPECTRUM installation automatically creates two savefiles in the /SS directory, each containing a copy of the database modeling catalog that was installed. The first file is date-stamped, with the extension .after. A copy of the .after file is created and named legacy.SSdb (overwriting any previous legacy.SSdb file). The legacy.SSdb file is used with the SSdbload utility to re-initialize the database with the most recently installed modeling catalog, while the .after files let you restore the catalog associated with any particular installation. A sequential counter following the date portion of the file name lets you distinguish between multiple .after files generated on the same day. For example, if three of these files were generated on May 4, 2006, they would be labeled as follows: db_20060504,1.after.SSdb db_20060504,2.after.SSdb db_20060504,3.after.SSdb

SPECTRUM Services for Windows:

The SPECTRUM installation adds the following services to Windows Services: SPECTRUM Process Daemon SPECTRUM Remote Admin

SPECTRUM MYSQL Database Server SpectrumTomcat

How to Install New Components: If you purchase new SPECTRUM components, you receive a new SPECTRUM key for installing them. You can also install new components using your current SPECTRUM key if you have a license for the components and did not install them yet. To install new components, do the following: 1. Stop SpectroSERVER and all SPECTRUM applications.

2. Run the installation for the version of SPECTRUM you currently have installed. 3. Enter a new SPECTRUM key (if applicable) or use the existing key from your original installation. 4. Retain the default directory on the Destination Location dialog because all components must be installed in the same directory. You cannot install OneClick and SpectroSERVER in different directories. 5. If the component you are adding is listed on the Select Features dialog, select it. If it does not appear, you can verify if the component is installed in the Review Settings dialog. Note: When adding new components using a new SPECTRUM key, all components may not appear on the Select Features dialog. The Review Settings dialog displays all components that are installed. Scroll down this dialog to ensure that the new components you want to install are listed.


Page 20

SPECTRUM installation only installs new components. It does not re-install components of the same version that you have already installed. Components that are already installed appear selected and disabled on the Select Features dialog. 6. After you have all the components installed, re-install SPECTRUM

Patch Installations:

Updates or patches for existing versions of SPECTRUM are available for download at http://support.concord.com. Contact a SPECTRUM technical support representative for hotfix patches and debug patches. Each patch includes a software release notice that provides step-by-step installation instructions. Advanced and Value-Added Applications If you purchase any advanced and value-added applications, follow the installation instructions included with each application.

Reinstall SPECTRUM:

You can reinstall SPECTRUM if there is a problem with the installation. You cannot install new components and reinstall at the same time. Reinstall SPECTRUM first and then install the new components. If you want to reinstall SPECTRUM on top of an existing installation to change the installation owner, run the following program from a bash shell, on Windows, prior to reinstalling SPECTRUM. This program

removes the processd service so that the service is recreated during the reinstallation with the new installation owner: /lib/SDPM/processd.exe remove To reinstall SPECTRUM to change the installation owner, you must be reinstalling a full, major release; it cannot be a service pack or hotfix. For example, if you have SPECTRUM 8.1 SP1 installed, you must reinstall SPECTRUM 8.1 first, and then install SPECTRUM 8.1 SP1 again.

Note: The following procedure is for the GUI-based installation. If you are using the distributed installation, set same=yes in the host installation information file before reinstalling SPECTRUM. To reinstall SPECTRUM 1. Stop SpectroSERVER and all SPECTRUM applications.

2. Run the installation for the version of SPECTRUM you currently have installed. 3. Enter your existing SPECTRUM key from your original installation. 4. Retain the default path on the Destination Location dialog because all components must be installed in the same directory.

Note: In the Select Features dialog, no new selections can be made. Components that can be re-installed are selected and disabled. In the Host Evaluation dialog, you see a message that nothing was selected for installation. 5. Click Next on the Host Evaluation dialog. 6. Click Reinstall on the Reinstall Option dialog. 7. Click Preserve on the Preserve Files dialog to preserve existing user-modified files. The Host Evaluation re-runs to evaluate the new settings. 8. Click Next to continue and make any modifications necessary to the installation dialogs.


Page 21

9. Check the Review Settings dialog to ensure all components are re-installed and click Next to proceed with the reinstallation. The reinstallation is complete.

Prepare the SpectroSERVER to Communicate With the OneClick Web Server:

You must make sure that the SpectroSERVER and OneClick can communicate with one another. Note: Some SPECTRUM service packs require updates to the SpectroSERVER and the OneClick web server.

To prepare the SpectroSERVER to communicate with the OneClick Web Server

1. Verify if the SPECTRUM version installed on the SpectroSERVER host is the same as the SPECTRUM Version you are installing on the OneClick web server. To verify, navigate to /Install-Tools and view the .history file using a text editor. If the version is different, install the same version of SPECTRUM. Important! For each SpectroSERVER, there must be an entry in the .hostrc file for the computer hosting the OneClick web server. 2. Ensure that all associated SpectroSERVERs are running. 3. Ensure that the computer on which you are installing the OneClick web server has host access to all

associated SpectroSERVER computers. On each SpectroSERVER host: a. Launch the SPECTRUM Control Panel. b. Select Configure, Host Security. c. Ensure that the Server List contains either the host name of the designated OneClick host

(OneClick Web Server) or a plus (+) sign, which means unrestricted access. Note: See the Control Panel User Guide (5029) for more information.

4. Ping the designated SPECTRUM host using its host name to ensure you are connected. 5. Designate an existing user or create a new SPECTRUM user as the OneClick administrator. Verify that this user is a valid SPECTRUM administrator by doing the following:

a. Launch the SPECTRUM Control Panel.

b. Select Control, Users. c. Verify that the user model designated as the OneClick administrator exists. d. If the user does not exist, select Create. e. Enter the user name in the User Name field, enter a password in the New Password and

Confirm New Password fields, and click OK. The user is created and the community string value is set to ADMIN,0 by default. f. Click Close to exit the Users window.

Note: In a distributed environment, this administrative user must exist in all landscapes. 6. Ensure that the computer on which you are installing the OneClick web server has access to the SpectroSERVER. 7. On Windows 2003 and Windows 2008, ensure you can resolve the SpectroSERVER host name from the

OneClick web server by editing the local hosts file as follows: a. Navigate to the C:\Windows\system32\drivers\etc directory. b. Open the hosts file with a text editor. c. Add entries per the comments in the hosts file. d. Save the file.


Page 22

8. On Solaris and Linux, ensure you have host name resolution to the SpectroSERVER from the OneClick web server by editing the local hosts file. If you are not using a name service, edit your local hosts file as follows:

a. To test host name resolution, ping the SPECTRUM host using only the host part of its fully qualified domain name.

For example, to ping host.company.com, enter shell> ping host. If the ping fails, edit the file /etc/hosts to reflect the IP and name of the SPECTRUM host.

b. Add a host name to the Solaris hosts file as follows: Log in as root. Edit the /etc/hosts file. Add an entry as follows (host in this example):

# # Internet host table # 127.0.0.1 localhost 192.168.200.1 host loghost

9. Remove any prior installations of the JRE and SDK from the OneClick web server host machine. OneClick includes the required 1.6.0 JDK and 1.6.0 JRE while some older versions can cause conflicts. To do this, navigate to Start, Control Panel, Add/Remove Programs for Windows 2003 or Start, Control Panel, Programs and Features for Windows 2008. Select in turn each instance of the Java Runtime and Java SDK and remove them. The SpectroSERVER is prepared to communicate with OneClick.

Creating the Password File A password file contains accounts and passwords for remote computers. You can create a password file on Solaris, Linux, and Windows. You add one entry per host to this file. Each line contains the following: host name root/administrator account name

root/administrator account password You can use a pound (#) or a backslash (\) in the password file. Insert a backslash before the characters of the password or SPECTRUM interprets them as a comment line. For example, if your password is test#computer, enter it in the password file as test\#computer. If your password is test\computer, enter it in the password file as test\\computer.

Note: You can use a sudoers file to provide users with limited root permissions for remote clients. Root permissions apply only to the commands required to install SPECTRUM. This option is available for Solaris and Linux operating systems. Create a Password File You can omit a root/administrator password in the password file and only enter a host name and user name. If you omit the root/administrator password, you are prompted to enter a password at the

command line when you run the SPECTRUM distributed installation client. When you first enter the password, you are asked if you want to use this same password for all entries. If you answer No to this question, you are prompted to enter a password for each host in the password file that does not have a password entry. To create a password file

1. Create a password file using a text editor. 2. For each system in which you plan to install SPECTRUM, add an entry with the host name, account name, and password. You must enter this information in the following order:

On Solaris/Linux:


Page 23

On Windows:

Note: The and the are optional. 3. Save the file with a valid file name in a directory. The password file name is not important, provided

that it is valid. Note: Use this file name for running the SPECTRUM distributed installation client. 4. Exit the text editor. The password file is created

Starting SPECTRUM and OneClick: Start SPECTRUM on Windows After you install SPECTRUM, you can start the SPECTRUM on Windows. Click Start, Programs, CA, SPECTRUM, Administrator, Control Panel. SPECTRUM starts and the SPECTRUM Control Panel appears. Initiate a Remote Display of SPECTRUM You can set up a Windows system to remotely display SPECTRUM when SPECTRUM is running on a Solaris or Linux system. The Solaris or Linux system must be installed with the applications that you want to remotely display on Windows, and the Solaris or Linux system must be configured to support Telnet services. The Windows system must be configured to support a Telnet client.

Note: SPECTRUM supports one remote display session open at a time on a client system. To initiate a remote display of SPECTRUM 1. Ensure the SPECTRUM Control Panel and any applications that you want to remotely display are installed on the Solaris or Linux system and configured to support remote display. Note: On Solaris, OneClick does not need to be running to initiate remote display. 2. Click Run from the Windows Start menu. The Run window appears. 3. Run the following: Telnet The Solaris or Linux login dialog appears. 4. Log in to the Solaris or Linux system using your SPECTRUM user name and password. The system reports your last login, host name, and operating system version, followed by the Solaris prompt. 5. To set the remote display environment, run the following commands: In the K (default) shell, enter:

export DISPLAY=:0.0 In the C shell, enter: setenv DISPLAY :0.0 In the Bourne shell enter: DISPLAY=:0.0 export display

Note: If you use remote display frequently, you can add the DISPLAY environment to your profile so that you do not have repeated this task at each login. 6. Navigate to the /bin directory. 7. Enter the following command:


Page 24

./SCP The SPECTRUM Control Panel appears, providing you with access to all SPECTRUM Control Panel functions, including access to client SPECTRUM applications. Terminate a Remote Display of SPECTRUM You can terminate a remote display of SPECTRUM.

To terminate a remote display of SPECTRUM 1. Exit all remotely displayed SPECTRUM applications properly. 2. Enter exit at the prompt in the Telnet terminal window to end the Telnet session.

Install the JRE and Java Web Start on Windows You can install the JRE and Java Web Start on your Windows OneClick Console system. You must install JRE and Java Web Start to run the OneClick Console. Before you begin installing the JRE and Java Web Start, confirm the following: You have the correct URL for the OneClick web server system. You can access the OneClick web server system using HTTP on a web browser. Your account allows you to log in to the OneClick web server.

To install the JRE and Java Web Start on Windows 1. Log in to your Windows OneClick Console system. 2. Open the OneClick home page at the URL provided by your SPECTRUM administrator, using your web

browser. The URL has the following format: http://:/ Note: is the name of the OneClick web server. Use : only if the OneClick web server does not use the default of port 80. If you cannot access the OneClick web server, notify your SPECTRUM administrator. 3. Enter your OneClick login credentials, if prompted.

Note: You can save your login credentials to avoid reentering them the next time you launch the OneClick home page by selecting Remember my password. The OneClick home page opens. 4. Click Install JRE. The Installing the Java 2 Runtime Environment dialog opens.

5. Click Java Runtime Environment to download the JRE. 6. Click Run or Open (not Save) in the File Download dialog. 7. Click Run in the Internet Explorer Security Warning dialog. The J2Se Runtime Environment installation program runs.

8. Click Select Typical setup, and then click on Accept to accept the License Agreement. Note: If you do not accept the license agreement, you will not be able to download and install the JRE, and you will not be able to run the OneClick Console. 9. Click Finish when the installation completes.

The JRE and Java Web Start are installed. Note: By default, the Java runtime environment automatically checks for Java updates and notifies you if an update is available for download. Before downloading and updating Java using this method, shut down the OneClick web server and any connected OneClick clients. Automatic Java updates can be disabled in the Java Control Panel.


Page 25

If you upgrade the version of Java running on any OneClick client computer, you must update the Java version entered on the JNLP Configuration page. Start OneClick through a Web Browser You can start OneClick from a Web browser on your computer where the OneClick Console is installed.

To start OneClick from a Web browser where the OneClick Console is installed 1. Open the OneClick home page using the URL provided by your SPECTRUM administrator, using your Web browser. The URL has the following format: http://:/ Note: is the name of the OneClick server.Use : only if the OneClick server does not use the default of port 80 on Windows or 8080 on Solaris/Linux. If you cannot access the

OneClick server, notify your SPECTRUM administrator. 2. Enter your OneClick login credentials, if prompted. Note: You can save your login credentials to avoid reentering them the next time you launch the OneClick home page by selecting Remember my password. The OneClick home page opens. Note: Any date and time information shown in OneClick is localized to reflect the time zone where the OneClick client is installed and running. 3. Install JRE and Java Web Start if you have not done so already on Windows, Linux or Solaris, refer previous sections in this document. 4. Click Start Console.

5. Re-enter your OneClick user name and password, if prompted. Note: You can save your login credentials to avoid reentering them the next time you launch the OneClick home page by selecting Remember my password. OneClick starts and the OneClick Console opens.

Post-Installation Configurations:

Set OneClick Client Restrictions:

Client access to SPECTRUM includes access to OneClick web server installations. OneClick clients do not need to be added to Host Security when they use the OneClick web server for connections. Note: You can configure host security for the OneClick web server using Remote Address Filter and Remote Host Filter in Apache Tomcat. See http://tomcat.apache.org for details. To set OneClick client restrictions 1. Navigate to /tomcat/webapps/spectrum/META-INF. 2. Open the context.xml file in this directory, using an XML editor. 3. Locate the following line:

and enter the following lines under this line:


Page 26

4. Enter IP addresses as values for the deny parameter to specify users in which you want to restrict OneClick access. For example, you can allow all users for a given IP address range, but exclude one or more specific users. 5. Optionally, enter IP addresses as values for the allow parameter to specify specific IP addresses in which you want to give OneClick access. For example, you can enter 10.254.*.* to include all IP addresses

in your network that are in the 10.254 IP address range. 6. Save and exit the file. OneClick client restrictions are set.

Change the OneClick Web Server Port:

If your OneClick web server contains multiple instances of Apache Tomcat, and those instances of Apache Tomcat are using the default server shutdown port (8005), you must change the default server shutdown port for the OneClick web server. Apache Tomcat will not start on a system with another instance running on it. To change the default server port 1. Navigate to the following directory: /tomcat/conf 2. Open the server.xml file, using a text editor.

3. Navigate to the following line: - 4. Change the server port value to the new server shutdown port number. For example, port="8099" 5. Restart Apache Tomcat as follows: On Windows:

Select All Programs, Administrative Tools, Services from the Start menu. Select SpectrumTomcat from the list. Click Restart the service in the left pane.

On Solaris and Linux: Navigate to the following path: /tomcat/webapps/spectrum Enter the following command: restart.sh. The web server port is changed.


Page 27

Upgrading SPECTRUM:

Pre-Upgrade and Post-Upgrade Tasks:

Ensure you do the following before upgrading SPECTRUM: Stop all running applications. Remove any existing versions of MySQL from the SpectroSERVER. Do not install third-party software that uses MySQL because the results can be unpredictable. If you are upgrading from SPECTRUM 8.0 or earlier, you must manually copy the cacerts file from

the /jre/lib/security/cacerts directory (where is the directory where you have previously installed the JDK) to the /custom/keystore directory if you

want to preserve your stored SSL certificates. If, in a previous version of SPECTRUM, you had configured OneClick to launch from Report Manager using Secure Sockets Layer (SSL), you must perform this modification again, after you upgrade SPECTRUM.

Upgrading from Earlier Versions:

This release of SPECTRUM is for new installations and upgrades from SPECTRUM 8.1 and 7.1 SP3. If you are running a version that is earlier than 7.1 SP3, you must upgrade to 7.1 SP3 before installing this release of SPECTUM. If you are running SPECTRUM 8.0, you must upgrade to SPECTRUM 8.1 before installing this release of SPECTRUM. Contact your support or sales representative for more information about upgrading SPECTRUM. Note: SpectroGRAPH will no longer be installed when you upgrade from any previous version of

SPECTRUM and all SpectroGRAPH files will be removed. Preserve Customized Support Files If you have customized SPECTRUM support files (for example, AlertMap, EventDisp, Event Format, Probable Cause, or GIB files), they might be overwritten or deleted when installing a new version of SPECTRUM. For example, if you customized event files that exist in the /SG-Support/CsEvFormat

directory, move these files to /custom/CsEvFormat before upgrading the OneClick web server. To preserve the customized files, the SPECTRUM installation creates a backup copy of each file. After you complete a SPECTRUM installation, you can review your customized files and add them to the upgraded SPECTRUM version. To preserve customized support files 1. Navigate to the /Install-Tools/LOGS//SavedFiles directory after you complete a SPECTRUM installation. This directory contains subdirectories with backups of customized files. The original versions of these customized files are overwritten during an upgrade. There are two backup file formats: .sv - files that have been replaced by new files of the same name during an upgrade.

.obs - files that have been obsoleted and no longer exist with the upgraded version of SPECTRUM. The original path to a given backup file is preserved within the SavedFiles directory. This directory structure tells you where the customized file originally came from. For example, if you customized the Rtr_Cisco AlertMap file and then installed a new version of SPECTRUM, the following file is available: /Install-

Tools/LOGS/


Page 28

For example, to re-implement the customizations in the Rtr_Cisco AlertMap file: Open the following file in a text editor: /Install-Tools/LOGS//SavedFiles/SS/CsVendor/Cisco_Ro uter/Rtr_Cisco/AlertMap.sv Compare this file to the new Rtr_Cisco AlertMap file located at:

/SS/CsVendor/Cisco_Router/Rtr_Cisco/AlertMap Copy and paste any needed customizations from the backed up AlertMap file (AlertMap.sv) to the new AlertMap file. 4. For files that are obsolete, you need to recreate a file to re-implement customizations. You can choose to recreate customizations at the global level if you want to apply these customizations across model

types. You can also choose to recreate your customizations only for the specific model type for which they were originally implemented. For example, if you added event processing information to the EventDisp file that was located at /SS/CsVendor/Ctron_MMAC_Pls/9G426_02/EventDisp, and this file was obsolete when installing your SPECTRUM upgrade, you need to take the following steps to re-implement the customization: If you want to recreate the customizations at a model type level, create a blank text file called EventDisp and save it to the /SS/CsVendor/Ctron_MMAC_Pls/9G426_02 directory. If you want to recreate the customizations at a global level, create a blank text file called EventDisp and save it to the /SS/CsVendor/Ctron_MMAC_Pls directory. Open the backup copy of the EventDisp file that the SPECTRUM installation created during the installation process. This file is located in the /Install-

Tools/LOGS//SavedFiles/SS/CsVendor/Ctron_MM AC_Pls/9G426_02 directory. Locate each line of the EventDisp file that you customized. Copy each of these lines to the new, blank EventDisp file that you created.

Important! Copy only the lines in the EventDisp file that you customized. Do not copy the entire backed-up EventDisp file and paste it into the new EventDisp file. If the version of SPECTRUM you are installing has updated processing for some of the events that were previously in the Cabletron MMACPlus EventDisp

file and are now located in a global EventDisp file, you override this new event processing. Save and close the new EventDisp file. 5. Re-start the SpectroSERVER to apply the changes made to the SPECTRUM support files. The customized support files are preserved.

How to Perform In-Place Upgrades If you have SPECTRUM data that you want to preserve, perform an in-place upgrade. An in-place upgrade installs a new version of SPECTRUM on an earlier version in the same system and directory. To perform an in-place upgrade, do the following: 1. Preserve your existing SpectroSERVER database

2. Preserve the SPECTRUM events and statistics database 3. Install SPECTRUM 6on top of an earlier version of SPECTRUM. Note: Additional steps are required for preserving the SPECTRUM databases and upgradeable components that are part of the older version.

Preserve the Existing SpectroSERVER Database You can preserve an existing SpectroSERVER database before performing an in-place upgrade. To preserve the existing SpectroSERVER database


Page 29

1. Ensure that the SpectroSERVER is running and open the SPECTRUM Control Panel. 2. Make a copy of your current SpectroSERVER database by clicking Save Database in the SPECTRUM Control Panel. The Online Database Backup dialog appears.

3. Verify that the option, Use Backup Compression, is selected. 4. Accept the default or enter a directory path in the Backup Directory field. The default directory path is as follows: WindowsC:/win32app/SPECTRUM/SS-DB-Backup

Solaris, Linux/usr/SPECTRUM/SS-DB-Backup Note: If you change the default, ensure you select a directory other than the SPECTRUM installation directory. 5. Accept the default of 20 for the Minimum Required Disk Space or enter an appropriate value. 6. If you made any changes, select Save to save all changes. 7. Click Begin Backup Now. The Status displays the progress of the backup. SPECTRUM automatically assigns a name for the backup with a .SSdb extension in the format db_YYYYMMDD_HHMM. The YYYYMMDD represents the year, month and day and HHMM represents the

hour and minute when the backup started. For example, a backup that started at 10:42 on 10/06/06 is named db_20061006_1042.SSdb. Note: Because compression was enabled, this file is compressed into a file with a .gz extension. 8. Click Save and Close. The database is backed up.

9. Move the database to an area outside the SPECTRUM installation directory. Preserve the SPECTRUM Events and Statistics Database You can preserve the SPECTRUM events and statistics database before upgrading SPECTRUM.

To preserve the existing SPECTRUM events and statistics database 1. Stop the Archive Manager by clicking Stop SpectroSERVER on the Control Panel. 2. Execute cd \SS\DDM in the command prompt, where is the directory where SPECTRUM was installed.

3. Enter the following command: ddm_save dbsavefile The file dbsavefile.tgz is created. 4. Move the dbsavefile.tgz to an area other than the SPECTRUM installation directory. 5. Stop all other SPECTRUM applications.

6. Install SPECTRUM Note: We recommend that you back up the new, upgraded SpectroSERVER database using the SSdbsave utility with the -cm option before starting the SpectroSERVER. This utility is located in the SS-Tools


Page 30

directory. Backing up the new, upgraded SpectroSERVER database ensures the integrity of the database, in case the new SpectroSERVER fails before you access the Online Database Backup. The existing SPECTRUM events and statistics database is preserved.

Modeling Your IT Infrastucture:

Network modeling in SPECTRUM is the act of graphically representing network entities and their connections. Icons created, placed, and connected within the OneClick topology views represent various aspects of a modeled network.

Using the modeling features offered in the OneClick client you can easily create and maintain accurate software models of your network. These intelligent network models enable SPECTRUM to determine actual points of failure and suppress superfluous alarms.

SPECTRUMs network representation is based on logical relationships and rules and may not look exactly

like your network diagram. Discovery uses address tables and ICMP pings to identify subnet address

ranges and devices within those ranges. Once discovered, those devices and subnets are modeled by

SPECTRUM.

SPECTRUM OneClick Topologies:

In SPECTRUM there are four core topologies that you can use to model your IT infrastructure:

a. Universe Topology b. Global Collections Topology c. World Topology d. TopOrg Topology

All four of these topologies are available from the OneClick Navigation panel. Important! It is recommended that you begin modeling with the Universe topology. After you have established one or more modeled elements in the Universe topology, you can reuse these modeled elements to define the other topologies. To navigate through the model views of any topology, click the view control icons in the toolbar. In some

cases you can click an aggregate icon container to view its content.

a. Universe Topology

The Universe topology helps you organize an enterprise network view of your infrastructure. Most often it provides a top-level topology view of OSI Layer 3 devices and their connections, a drill-down topology

view of OSI Layer 2 devices and their connections, and a Component Detail view of attributes associated with a modeled entity. Top View of Universe Topology The top view in the Universe topology most often includes the SPECTRUM Virtual Network Machine (VNM), network groupings, network segments, and OSI Layer 3 devices and their connections, as shown in the following illustration:


Page 31

Drill-Down View of Universe Topology The following illustration shows a drill-down view of a LAN container selected from the top view. A drill-down view in the Universe topology most often includes all OSI Layer 2 devices and their connections, and off-page references to devices modeled in other views, as shown in the following illustration:

Component Detail Panel The Component Detail panel within the Universe topology identifies the attributes associated with a modeled network entity such as its interfaces, alarms and events, and other pertinent device information.

You can view the device attributes and possibly change their settings by clicking the Component Detail panel tabs. Depending on the context of the Contents panel, you can do the following in the Component Detail panel:

View current alarms in the Alarm Details tab. View and modify general device settings in the Information tab, such as granting or denying access

to a modeled device by providing or possibly removing a security string.


Page 32

View root cause analysis data in the Root Cause tab. View CPU and memory utilization information in the Performance tab. View device interface information in the Interfaces tab. View neighboring routers in the Neighbors tab. View historical events in the Events tab. View attribute information from the Attributes tab, which appears only after you select an entity

from the Explorer tab and only if you are in either the Topology, List, or Events tab in the Contents panel.

b. Global Collections Topology

Use Global Collections to organize entity-based network views that span one or more landscapes. Global collections enable you to monitor all aspects of your IT infrastructure from any perspective. As an administrator, you can use Global Collections to create and track collections of network entities, organizations, or services that make up your infrastructure. For example, you can create and maintain collections that identify and track:

Response teams within an organization responsible for maintaining equipment

Devices supporting various services in your organization Customers receiving services from your organization

View or Modify Modeled Devices

You can view and change modeled device attributes or settings in the Component Detail panel within a Global Collections topology. Click the tabs in this panel to access general information about a device, its interfaces, alarms, events, and other pertinent information.

c. World Topology

The World topology helps organize your network geographically in OneClick. In this topology, you can represent device models of network locations from a national or regional level all the way down to a wiring

closet. The following example illustrates a drill-down view of an equipment room located at a fictitious North Dallas location.

In the World topology, you can create several layers of views that represent locations of your network

devices. For example, Texas regional offices, Dallas office, Dallas Equipment room, and so on. Additionally, you can use the Component Detail panel to view, and possibly change, the attributes associated with a modeled device in any World topology view. For instance, by clicking the Component Detail tabs associated with a modeled device, you can view device information, interfaces, alarms, events, and other pertinent device information.


Page 33

Important! When populating the World topology views with modeled devices, it is highly recommended that you copy and paste modeled elements from Universe topology views. Universe topology views represent the true connectivity views of your infrastructure, thereby helping to ensure accurate fault isolation of your network within the SPECTRUM OneClick environment. Topology Toolbar

The following table describes some of the buttons available in the Topology tab toolbar for working with topologies.


Page 34

OneClick Theme Icons and Symbols:

Icon Color and Condition All icons change color to indicate the condition of the device or devices they represent. For instance, a device icon will change color when an alarm condition for that device occurs. A rollup triangle on a device icon or container icon will change color when an alarm condition occurs on one or more of its components (devices or interfaces). Rollup Condition Colors

The rollup triangle associated with the Network container icon represents that one or more components of the container has an alarm condition. In this example, a device within the Network container has a major alarm.

The rollup triangle associated with the device icon represents that a component of that device has an alarm condition. In this example, an interface on a Cisco router has a minor alarm.


Page 35

Icon Condition Colors

Logical links (or pipes) change color to indicate the condition of the connection, for instance, disabled or maintenance conditions are brown, good conditions are green, initial conditions are blue, suppressed or unknown conditions are silver, and poor conditions are red.

SPECTRUM OneClick Discovery:

By using the OneClick Discovery feature, you can model your network infrastructure in less time and with less effort than if you were to use the manual modeling process. When using Discovery to automate the modeling process you must know the IP address ranges of your

devices and the SNMPv1, v2c community strings, or SNMPv3 security credentials of your devices. Note: All discovery results are modeled to the Universe topology Manual Modeling When you manually model your network you must have knowledge of all the network devices you plan to model, including their:

IP addresses Device SNMPv1, v2c community strings or SNMPv3 security credentials

All four core topologies in OneClick (Universe, Global Collections, World, and TopOrg) support manual modeling operations. However, it is recommended that you always model new devices in the Universe topology and reuse these modeled devices to create other topology views.

Modeling Recommendations: When creating models in OneClick, consider following these steps: 1.Plan. 2.Use the OneClick Discovery feature to model. 3.Use the OneClick manual modeling features to define or edit models as needed.3 1.Plan Create a plan about the network entities you want to model by gathering all required network device information. For instance: Typical information needed for Discovery operations includes:

Range of IP addresses of all addressable devices SNMP community strings for devices (Optional) Router address

Typical information needed for manual modeling operations includes: Type of network (switched, routed, flat) Network masks Network technology (FDDI, Ethernet, WAN, and so on) List of all devices

IP addresses for all addressable devices SNMP community strings for all devices Physical and logical network diagrams

Use Discovery to Model In the Universe topology, create one or multiple Discovery configurations to locate and identify the devices you want to model. Use the filter mechanism to exclude any devices from the result list you do not want


Page 36

to model. After you are satisfied with the device list (or results list), you can use the Discovery modeling option to model these devices in the Universe topology. Use Manual Modeling As Needed There are a number of ways you can manually create or edit models in OneClick. For example:

In the Global Collections topology, you can create and name collections of devices previously

modeled in the Universe topology. In the Universe topology, you can add devices and annotations to existing models, change device

configuration information, or improve the readability of models by possibly keeping the layers within the Universe topology simple. You may want to consider placing routers near the top and grouping devices logically by IP domains.

Discovering and Modeling Your Network: Discovery

Discovery is a SPECTRUM utility that you can run to find devices in your network and to model them automatically in the Universe topology. Discovery uses a set of configuration parameters that you can modify to determine which network entities to Discover and model. You can reuse any set of previously saved configuration parameters and you also rename, duplicate, or delete configurations.

A configuration determines the focus and scope of a Discovery or modeling session. You define the configuration by selecting parameters on the Discovery Console Configuration tab. After creating a

configuration, you can choose when to activate it: You can activate the configuration immediately. You can schedule the activation, including scheduling it to recur. You can save the configuration and activate it at a later time.

Depending on your user privileges, you can use the automated Discovery and modeling features in conjunction with one another or you can use them separately. For example, here are some ways you can use Discovery:

To perform network inventories: If you have read/write privileges to the Discovery parameters, you can use Discovery to identify assets within your network and, as needed, export the results describing those assets to a desired file format for further review and distribution.

To model network entities you want to manage: If you have read/write privileges to both Discovery and modeling parameters, you can use Discovery to: 1.Determine which elements in your network you want to model. 2.Identify how you would like SPECTRUM to automatically model these elements for you.

By specifying modeling parameters in conjunction with the Discovery parameters, you can easily create accurate software models of your infrastructure in less time and effort than if you had to manually model them yourself. Separate Configurations Creating separate Discovery and modeling configurations offers you more flexibility for customizing the Discovery and modeling process. By providing separate configurations, you can:

Discover limited portions of your network by performing several smaller Discovery operations instead of performing one large Discovery operation.

Model the results of a Discovery operation using different modeling options. Filter and export the results of a Discovery session in different ways.

Filter and export the results of a modeling session in different ways.


Page 37

Discovery Console:

The Discovery Console consists of two panels: the Navigation panel on the left, and the Contents panel on the right. Discovery Navigation Panel

The Discovery Navigation panel contains the Landscape drop-down list, a toolbar, and a list of configurations and folders available on the selected landscape. From the toolbar you can create, copy, or delete configurations and create new folders for the configurations. In the Name column you can select a configuration to open it and view its details in the Contents panel.

Configuration Tab The Configuration tab lists all the required and optional parameters you can set to create a configuration. The following image shows the Discovery Console Configuration tab.

The Configuration tab contains the following settings: Seed Routers Specifies the IP addresses for any seed routers on your network that will act as an initial communication point to discover the network topology. If you start Discovery in the context of a network element, the Seed Router field is populated with the IP address of that device. For more information about device context


Page 38

IP Boundary List Specifies a range of IP addresses, one or more single IP addresses, or any combination of the two to define the boundaries for the configuration. If you start Discovery in the context of a container in the Topology tab or Explorer, the IP Boundary List is populated with an address range determined using the IP address and network mask of the selected device. You can specify additional IP addresses and address ranges. Note: The IP Boundary List also accepts single IPv6 addresses; however, IPv6 ranges are not supported.

Import Imports IP Addresses to populate to IP Boundary List. You can import one or more single IPv4 addresses, IPv4 ranges, or single IPv6 addresses into a configuration from a text file. You can import IP addresses in a one-time, static manner, or you can import the addresses each time the configuration is activated, or dynamically.

SNMP Information Specifies community strings and profiles for SNMPv1, SNMPv2c, and SNMPv3 communication. Modeling Options Specifies whether to perform a Discover only operation or a combined Discover and model operation. Click the Modeling Options button to review and accept the modeling defaults provided or to edit them as needed. Advanced Options Contains the Advanced Options button which opens the Advanced Options dialog. In the Advanced Options dialog you can review, accept, or redefine the following options:

SNMP Ports Specifies the default SNMP port and any additional ports. This feature is most often used for managed node environments that use port numbers other than the default port number of 161. IP Exclusion List

Create, delete, modify, or import an IP exclusion list so that the Discovery session will not look for devices in a defined range of IP addresses. Discovery Options Specifies whether the Discovery process uses ICMP and Route Tables; if you select Route Tables, you can set a Throttle level that controls the rate at which the server sends SNMP requests Auto Export Specifies whether to export Discovery session results automatically and the preferred

format for exporting them: comma-delimited, tab-delimited, or web page.

Scheduling Options Specifies whether to activate certain configurations on a regular basis using a schedule.

Note: In a DSS environment that spans multiple time zones, schedules are executed according to the local time of each SpectroSERVER.

Save options as default Specifies whether to save the current configuration settings as the default for all configurations. For example, by default the Discover only option is enabled on the Configuration tab. If you prefer the default setting to be Discover and automatically model to SPECTRUM you would select that option, select the Save options as default check box, and select File, Save. Discover Activates the Discovery session as it is defined in the Configuration tab.

Discovery Tab The Discovery tab displays the results and status of the most recent Discovery session for the configuration selected in the Navigation panel. The results show the devices discovered in the top portion

of the Discovery tab, and the status and error messages generated display in the Discovery Status panel in the lower section of the tab. This tab is available to all users wi

ca spectrum user manual

Documents

b spectrum

installation of spectrum

spectrum installation

install spectrum

ca spectrum overview

spectrum design

ca spectrum user manual

spectrum oneclick topologies