SPECTRUM Installation Guide Document 0675
Notice Copyright Notice Copyright © 2002-present by Aprisma Management Technologies, Inc. All rights reserved worldwide. Use, duplication, or disclosure by the United States government is subject to the restrictions set forth in DFARS 252.227-7013(c)(1)(ii) and FAR 52.227-19. Liability Disclaimer Aprisma Management Technologies, Inc. (“Aprisma”) reserves the right to make changes in specifications and other information contained in this document without prior notice.
Contents Notice ........................................................................................... 2 Preface ......................................................................................... 8 Intended Audience ..................................................................... 8 Text Conventions ....................................................................... 8 Document Feedback ................................................................... 9 Online Documents ................
Installing SPECTRUM Patches ......................................................21 Installing SPECTRUM Advanced and Value-Added Applications .........21 Distributed and Fault-Tolerant SPECTRUM Configurations ...............21 Installing on Solaris ................................................................... 22 Prerequisites (Solaris) ...............................................................22 Root Privileges .....................................................................
In-Place Upgrade (Windows) ......................................................36 Migration and Upgrade (Windows) ...............................................37 Running the Installation Software .............................................. 39 SpectroGRAPH and SpectroSERVER on Separate Workstations ........39 Starting the Installation on Solaris ..............................................40 Starting the Installation on Windows ...........................................43 Installation GUI Screens .
Location Server Configuration Screen .....................................67 Selecting a Main Location Server .......................................68 Using the Command Buttons ............................................68 User Model Index Service Screen ...........................................69 Installation Summary Screen .................................................70 Installation Monitor Screen ....................................................71 Using the Command Buttons ....................
Upgrading Model Types and Models From SPECTRUM 5.0.1 .............89 MM_dep_50R1_script.pl ........................................................89 Convert_to_SSX.script ..........................................................90 MT_del_50R1_script.pl .........................................................91 Removing Discontinued Ethernet Application Models and Model Types ..........................................................................92 Rem_EnetApp_Mdls.sh ..................................
Preface In this section: Intended Audience [page 8] Text Conventions [page 8] Document Feedback [page 9] Online Documents [page 9] Intended Audience This guide is intended for system administrators who are installing or upgrading SPECTRUM on a Windows or Solaris platform. Text Conventions The following text conventions are used in this document: Element Convention Used Example User-supplied parameter names Courier and Italic in angle The user needs to type the brackets <>.
Element Convention Used Example Solaris and Windows directory paths Unless otherwise noted, directory paths are common to both operating systems, with the exception that forward slashes (/) should be used in Solaris paths, and backslashes should be used in Windows paths. <$SPECROOT>/app-defaults on Solaris is equivalent to <$SPECROOT>\app-defaults on Windows. Document Feedback Please send feedback regarding SPECTRUM documents to the following e-mail address: spectrum-docs@aprisma.
Getting Started This guide contains prerequisites, instructions, troubleshooting tips, and reference information related to SPECTRUM installation. Refer to the table below to determine where to begin the installation process and how to proceed from there. In this section: Installation Process Tasks [page 10] Installation Process Tasks The table below lists the common tasks for installing SPECTRUM. Use this as a guide for determining how to proceed for your specific installation.
System Requirements and Recommendations This section contains system requirements along with recommendations for configuring your operating environment—before you install SPECTRUM—for enhanced SPECTRUM performance and efficiency. In this section: System Requirements [page 11] Optimizing Your Operating Environment for SPECTRUM [page 12] SpectroSERVER Landscape Handle Requirements [page 14] System Requirements The following tables list the hardware and software required to run SPECTRUM.
Table 2: Windows System Requirements Component Requirement Operating System Windows NT 4.
Table 3: Recommended System Configurations One Workstation Managing Fewer Than 500 Devices/Avg.
Disk Striping and RAID For optimum performance, Aprisma recommends running SPECTRUM on systems with multiple, ultrawide, 10 K-rpm, SCSI disk drives using disk striping and/or RAID (redundant array of independent disks) technologies. Disk striping is a technique for spreading data over multiple disk drives. RAID is a disk drive system that employs two or more drives in combination for fault tolerance and performance improvement.
WARNING! You must run the lh_set utility before you run SpectroSERVER for the first time after installation. If you run SpectroSERVER before running lh_set, SPECTRUM assigns a default landscape handle that is the same whenever and wherever it is assigned by SPECTRUM. This creates the potential for duplicate landscape handles when multiple landscapes are configured. This means that these landscapes can never be accessed simultaneously from the same SpectroGRAPH or application.
Determining and Changing Landscape Handles This section contains the procedure for changing a SPECTRUM landscape handle. You may need to complete this procedure if you are upgrading an existing SpectroSERVER database and need to change its landscape handle to meet SPECTRUM requirements Determining the Current Landscape Handle Procedure 1. Navigate to: <$SPECROOT>/SS 2. Run the following command: ../SS-Tools/lh_set Changing the Landscape Handle Of a SpectroSERVER Database With Existing Models Procedure 1.
<$SPECROOT>/app-defaults/Reports 3. Navigate to: <$SPECROOT>/app-defaults 4. Edit the SDE and Reports files where they contain entries like the following: *PreferredLandscapes : 5. Enter the value that represents the updated landscape handle.
Types of SPECTRUM Installations This section describes the types of SPECTRUM installations and the differences between them. Read these descriptions to determine which kind of installation to perform. If you have existing SPECTRUM data that you want to preserve, it is important to perform the correct type of installation.
is 5.0.1 (with CS2 and MMS2) or earlier, contact your Aprisma support or sales representative for information on upgrading. Compatibility Between SPECTRUM Releases Using new versions of SpectroGRAPH and other client applications with an older version of SpectroSERVER is not supported. You may, however, connect to a newer version of SpectroSERVER from older clients.
If you have modified any .pib files (not recommended) and want to retain the changes in the post-upgrade database, create a default.p file and add your .pib file entries before beginning the installation. For further instructions, see the SPECTRUM Extension Integration (SEI) Developer Guide (0623). If you made any changes to the resource files listed in Table 4, make a note of them, since these files are overwritten by any upgrade or patch installation.
Installing SPECTRUM Patches When necessary, Aprisma issues software updates (“patches”) to existing versions of SPECTRUM. Patches are supplied on a CD complete with the SPECTRUM installer. Use the Component Selection Screen [page 57] to view the components to be installed. Each patch release includes a software release notice that gives step-by-step installation instructions, including those for relinking SPECTRUM components.
Installing on Solaris In this section: Prerequisites (Solaris) [page 22] First-Time Installation (Solaris) [page 29] In-Place Upgrade (Solaris) [page 29] Migration and Upgrade (Solaris) [page 30] Prerequisites (Solaris) These prerequisites must be satisfied before you begin installing SPECTRUM on a Solaris system. Root Privileges You must have root privileges to perform a SPECTRUM installation on Solaris systems; therefore, before running the installation software, you must log on as root.
CDE Style Manager Settings To set up your desktop environment for SPECTRUM, use the CDE Style Manager to make the following selections: In Style Manager-Window, select Allow Primary Windows On Top to allow pop-up windows to appear on top of SpectroGRAPH views. Also in Style Manager-Window, select Raise Window When Made Active to allow a partially blocked window to appear on top when active.
Table 5: Solaris 7 Patches Patch Number OS Description 106144-20 Solaris 7 Elite3D AFB Graphics Patch 106145-17 Solaris 7 Creator 7 FFB Graphics Patch 106146-14 Solaris 7 M64 Graphics Patch 106147-06 Solaris 7 VIS/XIL Graphics Patch 106148-12 Solaris 7 XFB Graphics Patch 106327-08 Solaris 7 Shared Library Patch for C++ 106541-12 Solaris 7 Kernel Update Patch 106944-03 Solaris 7 /kernel/fs/fifos and kernel/fs/sparc9/fifofs Patch 106950-13 Solaris 7 Linker Patch 106980-13 Solari
Table 6: Solaris 8 Patches Patch Number OS Description 108434-01 Solaris 8 Shared Library Patch for C++ 108528-02 Solaris 8 Kernel Update Patch 108576-06 Solaris 8 Expert3D IFB Graphics Patch 108604-10 Solaris 8 Elite3D AFB Graphics Patch 108605-10 Solaris 8 Creator 8 FFB Graphics Patch 108606-07 Solaris 8 M64 Graphics Patch 108652-16 X11 6.4.1 Xsun Patch 108827-01 Solaris 8 libthread Patch 108869-02 Solaris 8 snmpdx/mibiisa/libssasnmp/snmplib Patch 108921-07 CDE 1.
has an 8-bit frame buffer and does not meet SPECTRUM requirements (you must upgrade): cgfour cgthree cgsix If the output contains any of the following, your workstation has a 24bit frame buffer, and you can continue with step 3: afb cgeight ffb gfxp tcx If the output contains m64, your workstation has an 8/24-bit frame buffer that is configured for 8-bit operation, and you must perform the following procedure before continuing with step 3: • As root, create an empty file named S99m64setup in the /etc/rc2.
procedure. If the type returned for your card is different from types listed above, contact the video card manufacturer for instructions on how to configure it for 24-bit, true color capability. Configuring 24-Bit Color Mode If a 24-bit color card is installed, but your workstation is not in 24-bit color mode, follow these configuration instructions: 1. Log on as root. 2. Create your own, user-defined configuration directory, by running the following command: mkdir -p /etc/dt/config 3.
Stopping the Process Daemon (processd) [Upgrades From 5.0.1 Only] If you upgrading from SPECTRUM version 5.0.1, the SPECTRUM process daemon, processd, must be shut down before you install the newer version. Procedure 1. Log on as root. 2. Navigate to: SPECTRUM/SDPM 3. Run the following command: ./processd.sh stop Processd automatically restarts when you reboot the system after installation. If you quit the installation before it is complete you can restart processd without rebooting. Procedure 1.
First-Time Installation (Solaris) To install SPECTRUM on a Solaris workstation where SPECTRUM has never been installed, proceed to Running the Installation Software [page 39] as long as all prerequisites have been met (see Prerequisites (Solaris) [page 22]). In-Place Upgrade (Solaris) This section contains the procedure for installing a new version of SPECTRUM directly over an earlier version on the same Solaris workstation, in the same directory.
not feasible, consult your Aprisma support or sales representative before continuing. 6. Install SPECTRUM (see Running the Installation Software [page 39]) after all prerequisites have been met (see Prerequisites (Solaris) [page 22]). 7. Follow the procedures in Upgrading SPECTRUM Models, Model Types, and Management Modules [page 84].
mkdir -p <$SPECROOT>/SS/DDM Important: Do not use /opt/SPECTRUM as an installation directory name; this location is reserved for a directory that will be created automatically during the installation. 7. Copy or FTP (in binary mode) the dbsavefile.SSdb file from step 4 to the new <$SPECROOT>/SS directory. 8. Copy or FTP (in binary mode) the dbsavefile file from step 5 to the new <$SPECROOT>/SS/DDM directory.
Installing on Windows In this section: Prerequisites (Windows) [page 32] First-Time Installation (Windows) [page 36] In-Place Upgrade (Windows) [page 36] Migration and Upgrade (Windows) [page 37] Prerequisites (Windows) These prerequisites must be satisfied before you begin installing SPECTRUM on a Windows system. Administrative Privileges You must be logged in as administrator and have administrative privileges to perform a SPECTRUM installation on Windows systems.
SNMP Services Software [Windows NT Only] SNMP Services software must be installed on Windows NT systems before installing SPECTRUM. See Checking Network and Security Settings [page 33]. Creating an Emergency Repair Disk Aprisma recommends that you create an emergency repair disk before installing SPECTRUM in the event that the SPECTRUM installation causes file corruption. The ERD can be used to restore Windows configuration files to their original condition.
3. [Windows NT only] On the Services tab, ensure that SNMP Service is listed under Network Services; then click OK. If the SNMP software is not listed, install it from the Windows NT disks. 4. Make sure that the user profile for the person logged on and running SPECTRUM is configured to send e-mail using the supported service provider if you plan to use e-mail for applications such as SPECTRUM Enterprise Alarm Manager. 5. Set security as desired for the directory where you are installing SPECTRUM.
CONVERT C: /FS:NTFS The conversion utility can be run without damaging or deleting existing data. If the hard drive has already been converted, a message to that effect display when you enter the command above. 7. Restart your workstation for the reformatting to take effect. Stopping the Process Daemon (processd) [Upgrades From 5.0.1 Only] If you upgrading from SPECTRUM version 5.0.1, the SPECTRUM process daemon, processd, must be shut down before you install the newer version. Procedure 1.
First-Time Installation (Windows) To install SPECTRUM on a Windows workstation where SPECTRUM has never been installed, proceed to Running the Installation Software [page 39] as long as all prerequisites have been met (see Prerequisites (Windows) [page 32]). In-Place Upgrade (Windows) This section contains the procedure for installing a new version of SPECTRUM directly over an earlier version on the same Windows workstation, in the same directory.
program will not run if your database is locked, as it is whenever SpectroSERVER is running. If shutting down your SpectroSERVER is not feasible, consult your Aprisma support or sales representative before continuing. 6. Install SPECTRUM (see Running the Installation Software [page 39]) after all prerequisites have been met (see Prerequisites (Windows) [page 32]). 7. Follow the procedures in Upgrading SPECTRUM Models, Model Types, and Management Modules [page 84].
6. Create a SPECTRUM installation directory (<$SPECROOT>) where the new version of SPECTRUM will reside. 7. Within <$SPECROOT>, create an SS subdirectory and navigate to that subdirectory. 8. Copy or FTP (in binary mode) the dbsavefile.SSdb file from step 4 to the new <$SPECROOT>\SS subdirectory. 9. In the SS subdirectory, create a DDM subdirectory. 10. Copy or FTP (in binary mode) the dbsavefile from step 5 to the new <$SPECROOT>\SS\DDM subdirectory.
Running the Installation Software This section explains how to use the SPECTRUM installation software on the application CD.
Starting the Installation on Solaris Procedure 1. After completing the installation prerequisites (see Installing on Solaris [page 22]), insert the SPECTRUM Application CD into your CD drive. If the CD does not mount automatically, see Mounting the SPECTRUM CD [page 109]. 2. If you are using a remote display to install SPECTRUM, set the display environment (see Setting the Solaris Display Environment [page 111]). 3.
4. Double-click the Installer icon. 5. In the Password prompt, type the system’s root password. 6. In the Install screen (Figure 4), perform one or more of the following options: • Click the hyperlink to read the on-screen SPECTRUM Software Release Notice. • Click the hyperlink to install SPECTRUM. • Click Close to stop the installation process.
7. In the Choose Destination Location screen (Figure 5), do one of the following: • To install SPECTRUM in the default directory, click Next. If you are performing an in-place upgrade, the installer detects the previous installation directory. WARNING! Do not change the default destination to a location other than the directory that contains the SPECTRUM database you are upgrading.
Starting the Installation on Windows Procedure 1. After completing the installation prerequisites (see Installing on Windows [page 32]), insert the SPECTRUM Application CD into your CD drive. 2. Do one of the following: • If autorun starts and the Install screen (Figure 6) appears, go to step 3. • If autorun does not start, double-click My Computer, right-click your CD drive; then select AutoPlay from the menu to display the Install screen.
3. In the Install screen (Figure 6 [page 43]), perform one or more of the following options: • Click the hyperlink to read the on-screen SPECTRUM Software Release Notice. • Click the hyperlink to install SPECTRUM. • Click Close to stop the installation process. 4. In the Welcome screen (Figure 7), Click Next.
5. In the Installation Selection screen (Figure 8), select the products you want to install; then click Next. Note: If the Exceed X server is already installed on your system, and is not the same version that ships with SPECTRUM, the installation program prompts you to uninstall Exceed and restart your system. If you select to install the Exceed X server, the installation wizard appears at the end of the SPECTRUM Installation.
6. In the Choose Destination Location screen (Figure 9), do one of the following: • To install SPECTRUM in the default folder, click Next. If you are performing an in-place upgrade, the installer detects the previous installation folder. WARNING! Do not change the default destination to a location other than the folder that contains the SPECTRUM database you are upgrading. • To install SPECTRUM in a location other than the default folder, click Browse to select a new location; then click Next.
After clicking Next, the Setup screen appears. This screen graphically monitors the installation process. The horizontal bar graph in the Setup panel shows the percentage of files copied. The three vertical gauges show, from left to right: percentage of the current file copied; percentage of the CD copied; and the space available on the target system’s hard disk. When the available space falls to less than 5%, the Low indicator turns bright red.
Installation GUI Screens This section provides a description of each installation screen and explains user input when required. The sequence and appearance of the installation GUI screens described in this section are almost identical for Solaris and Windows. File Extraction Screen The File Extraction screen (Figure 10) dynamically lists the components extracted from the Application CD. When this process is complete, a message appears at the bottom of the scrollable display area.
Software Extraction Key Screen Procedure 1. In the Software Extraction Key screen (Figure 11), check that the Platform and CDROM Version fields display the correct values for the target workstation. 2. In the Extraction Key data field, type the extraction key that is printed on the certificate accompanying the CD. 3. In the License Number field, type the SPECTRUM license number (also printed on the certificate). 4. Click Next to continue the installation.
End User License Agreement Screen The End User License Agreement screen (Figure 12) shows the license agreement associated with the key you entered in the Software Extraction Key screen (see Figure 11 [page 49]). Procedure 1. Use the scroll bar to view the entire agreement. 2. Do one of the following: • To accept the terms of the agreement and continue the installation, click Accept. • To decline the terms of the agreement and terminate the installation, click Decline.
Host Evaluation Screen The SPECTRUM installation software automatically checks the operating system version and disk space resources of your workstation to make sure they are compatible with installation requirements. The results of this evaluation are displayed in a Host Evaluation screen (Figure 13). This information is critical to successful installation and operation of SPECTRUM. You are advised to comply with all recommendations returned by the evaluation. If your system is in compliance, click Next.
Installation Configuration Screen The Installation Configuration screen (Figure 14) displays default settings for the installation and lets you change them as necessary.
The following sections provide more detailed instructions for using the Installation Configuration screen: Selecting an Installation Type [page 53] Selecting Location Configuration [page 54] Installing Individual Components [page 54] Installing All SPECTRUM Components on a Single Workstation [page 55] Installing SpectroGRAPH Only [page 55] Installing SpectroSERVER Only [page 55] Resetting the Default Component Configuration Values [page 56] Using the Command Buttons [page 56] Selecting an Installation Type
Selecting Location Configuration Procedure Important: If you are doing an upgrade installation on either Solaris or Windows, the owner of the target directory must have a SPECTRUM user model in the database being upgraded. Otherwise, the directory owner will not be able to start SpectroGRAPH after the installation is completed. In the Location Configuration panel’s Target Ownership field (see Figure 14 [page 52]), do one of the following: • For Solaris installations, this field is blank.
Installing All SPECTRUM Components on a Single Workstation Procedure In the Component Configuration panel (see Figure 14 [page 52]), select the following options: • Select all SpectroSERVER components • Select all SpectroGRAPH components • Select all external applications.
Resetting the Default Component Configuration Values Procedure In the Component Configuration panel (see Figure 14 [page 52]), click Reset to undo any entries or settings you made and restore the default values. Using the Command Buttons Procedure At the bottom of the Installation Configuration screen, do one of the following: • Click Next to continue the installation. If you are installing SpectroSERVER components, the SpectroSERVER Validation screen (Figure 17 [page 63]) appears.
Component Selection Screen The Component Selection screen (Figure 15) displays a listing of all purchased SPECTRUM components and lets you select individual components for installation and linking. If you have already installed SPECTRUM and select Re-link previously installed components from the Installation Configuration screen, this list will not show any components because individual components cannot be selected during relinking. This screen also provides descriptive and dependency information.
The following sections provide more detailed information on the Component Selection screen: Components Available for Installation Table [page 58] Using the Selector Buttons [page 60] Selection Filters [page 61] Using the Command Buttons [page 62] Components Available for Installation Table The scrollable table at the top of the Component Selection screen (see Figure 15 [page 57]) identifies each of the components purchased, or already installed on the target system.
• UPGRD (Upgrade) - The version number of the CD component is newer than the version number of an installed copy of the same component type and represents an upgrade. • BADVERSION - This indicates that the version of the component is inappropriate to install on this system. Typically, this will indicate a mismatch between your version of SPECTRUM and a patch you are attempting to install. Note: Components that are selected for installation have a Y in the appropriate SS, SG, or EXT columns described below.
Disk Space Required The KB column indicates the approximate amount of disk space (in kilobytes) required for all elements of each component (i.e., both SS and SG). The values in this column and at the bottom of the panel for Total KB of Disk Space Required are dynamically updated to reflect current Y and N settings.
Selection Filters The Selection Filters dialog box (Figure 16) lets you apply special filters to override certain normal installation constraints by using the (SAME), (UPGRD), and (DNGRD) buttons. Click OK to confirm settings and return to the Component Selection screen, or click Help for instructions for this screen.
Using the Command Buttons The command buttons are located at the bottom of the Component Selection screen (see Figure 15 [page 57]). Procedure Do one of the following: • Click OK to close the Component Selection screen (with the current settings in effect) and return to the Installation Configuration screen (Figure 14 [page 52]). • Click Cancel to cancel any changes you made to the default settings and returns to the Installation Configuration screen • Click Reset to restore the default values.
SpectroSERVER Validation Screen The SpectroSERVER Validation screen (Figure 17) lets you verify installation information, enter an SS Activation Key, and enter a landscape handle.
Field Descriptions The following describes each field in the SpectroSERVER Validation screen: Hostname This value is derived from the Hostname(s) in the Installation Configuration screen (see Installation Configuration Screen [page 52]). Authorization Code This value is derived from the installation software. SSVersion This value is derived from the installation software.
Entering a Landscape Handle Procedure In the Landscape Handle box (see Figure 17 [page 63]), type a numeric value that is a multiple of 4 and is between 4 and 16,376 to serve as a unique identifier for each SpectroSERVER you are installing. You can also enter hexadecimal values in the range from 0x100000 to 0xffe00000, where the lower 20 bits are set to zero.
Using the Command Buttons The command buttons are located at the bottom of the Component Selection screen (see Figure 17 [page 63]). Procedure Do one of the following: • Click Help to open a screen that provides online instructions for the SpectroSERVER Validation screen. • Click Back to return to the previous screen. • Click Next to continue the installation. • Click Cancel to exit the installation program.
Location Server Configuration Screen The Location Server Configuration screen (Figure 18 [page 67]) lets you select a Main Location Server. When you install SPECTRUM components on a workstation, you also automatically install a location server. In a distributed environment, where there are multiple SpectroSERVERs, SPECTRUM uses these location servers to maintain the VNM landscape map, and to provide connection services to client applications. See Distributed SpectroSERVER (2770) for more information.
Selecting a Main Location Server Procedure Do one of the following: • To select a Main Location Server, select Point the Local Location Server to the Location Server on the Following Machine; then type the name of the Main Location Server in the Main Location Server Host box. • To select the target workstation as the Main Location Server, select This machine will host a Main Location Server. (Also Use this option if this machine will not be part of a distributed environment.
User Model Index Service Screen The User Model Index Service screen appears only when the workstation on which you are currently installing SPECTRUM is also going to be the Main Location Server. The User Model Index Service allows information stored in the user models (such as preferences) to be shared by all systems using the same main location server.
Installation Summary Screen The Installation Summary screen (Figure 19) lists the entries you made and the settings you selected in the previous series of screens. Procedure Do one of the following: • Click Back to return to previous screens and make changes. • Click Finish to start the actual installation. • Click Cancel to exit the installation program.
Installation Monitor Screen The top panel of Installation Monitor screen (Figure 20) displays the status of the installation (Initial, Running, Paused, Failed, or Completed). It also displays the current installation phase (Initializing, MediaExtract, DBImporting, Custom Scripts, LinkingSG, LinkingSS, or ValidatingSS). The Progress Meter shows a graphical representation of the percentage of the installation completed, and the total kilobytes of free disk space remaining.
Using the Command Buttons The command buttons at the bottom of the screen let you cancel the installation or view online help on the Installation Monitor screen. Procedure Do one of the following: • Click Cancel to exit the installation program. • Click Help to open another screen that provides instructions for the Installation Monitor screen.
When Installation Is Complete Procedure 1. When the installation software is finished running, do one of the following: • On Solaris systems, restart the CDE workspace manager to update your desktop icons. • On Windows systems, restart your workstation. 2. If you have performed an upgrade, back up your SpectroSERVER database before starting SPECTRUM.
Starting SPECTRUM and Postinstallation Configuration This section explains how to start SPECTRUM after its installation and describes required and optional postinstallation configuration tasks.
deprecating obsolete models and model types, see Upgrading SPECTRUM Models, Model Types, and Management Modules [page 84]. Configuring SPECTRUM CORBA Services Some SPECTRUM operations rely on CORBA agents. When these agents are started on the local network, they discover each other using UDP broadcast messages. If your SPECTRUM environment spans multiple broadcast domains, make sure the primary IP address of the host for each of these agents is available to the agents in different domains.
a. Using the Registry Editor, add the Visigenic Software Inc subkey information as indicated by bold text in Figure 1: Figure 1: Visigenic Software Inc Subkey - HKEY_LOCAL_MACHINE - SOFTWARE - Visigenic Software Inc - Visibroker - 3.0 - OSAGENT_PORT:REG_SZ:14000 - PathName:REG_SZ:<$SPECROOT>/bin/VBOA - vbc:REG_SZ: - vbj:REG_SZ: - VBROKER_ADM:REG_SZ:<$SPECROOT>/bin/VBOA b. Restart Spectrum Visibroker SmartAgent. [Solaris] 1.
Changing the OSAGENT_PORT You can configure SPECTRUM to use an osagent port (OSAGENT_PORT) other than the default of 14000. In environments where Visibroker applications in addition to SPECTRUM are used, each Visibroker application must have a unique osagent port to avoid conflicts. Additionally, to avoid conflict in a distributed SPECTRUM environment, you can define a unique OSAGENT_PORT for each distributed SpectroSERVER. Complete this procedure to change the OSAGENT_PORT. Procedure 1.
Scheduler Requirements (Windows) This section describes how to configure the Windows Scheduled Tasks service to work with the SPECTRUM Scheduler. Procedure 1. [Windows NT] Select Start > Windows NT Explorer. [Windows 2000] Select Start > Settings > Control Panel. 2. Open Scheduled Tasks. 3. Select Advanced > AT Service Account. 4. In the AT Service Account Configuration dialog box, select This Account. 5. Enter a user name (including the domain, if applicable) of a valid SPECTRUM user (e.g.
/etc/rc2.d/S97processd WARNING! These files are required for SPECTRUM operation and should not be removed. For more information about processd, see the Distributed SpectroSERVER (9032770) guide. SPECTRUM Remote Administration Daemon (SRAdmin) Files The installation adds the SPECTRUM Remote Administration daemon (SRAdmin) files required by SPECTRUM for user authentication and distributed administration: /sw/SPECTRUM/SRAdmin/sradmin.exe /etc/init.d/sradmin /etc/rc0.d/K01sradmin /etc/rc2.
Setting up Client Access Client access to SPECTRUM is controlled by the .hostrc file in your SPECTRUM installation directory. By default, this file is configured to prevent other workstations from connecting to your SpectroSERVER (or your SpectroGRAPH from connecting to a SpectroSERVER if you have installed only SpectroGRAPH). You can configure the .hostrc file from the SPECTRUM Control Panel to set up client access. Procedure 1. Start the SPECTRUM Control Panel. 2. Select Configure > Host Security. 3.
Configuring Exceed X Server for Remote Display Use this procedure to configure the Hummingbird Exceed X server for remote display: 1. Install the SPECTRUM-required version of Exceed (see Table 2 [page 12]) on the intended remote display workstation if it is not already present. 2. [If your Exceed X server is already running, disregard this step.] Using Windows Explorer, migrate to Program Files>Exceed.nt, and double-click exceed.exe to start the Exceed X server. 3.
Initiating Remote Display To initiate remote display at your Windows workstation, follow these instructions: 1. Make sure the SPECTRUM Control Panel, and any applications that you want to remotely display, are installed on the Solaris workstation and configured to support remote display. Note: SpectroGRAPH does not need to be running to initiate remote display. 2. From the Windows Start menu, click Run. The Run window displays. 3. Type: Telnet and hit Enter.
Terminating a Remote Display Session Exit all remotely displayed SPECTRUM applications properly. Then type exit at the prompt in the Telnet terminal window to end the Telnet session. Remote Display Limitations The limitations to the functionality of remote display of SPECTRUM are: • Java applications that are run from remote display sometimes display in a window that is too small for the contents. Try resizing the window. If resizing is not successful, launch the application again.
Upgrading SPECTRUM Models, Model Types, and Management Modules This section contains information about upgrading your SPECTRUM models, model types, and management modules after you install the new version of SPECTRUM. In this section: Ensuring Database Compatibility With Your Upgrade [page 85] Upgrading Model Types and Models From SPECTRUM 5.0.
Ensuring Database Compatibility With Your Upgrade To ensure compatibility between your SpectroSERVER database and your SPECTRUM upgrade, you must convert SPECTRUM models created with older model types and remove the discontinued model types after you install the new version of SPECTRUM. This procedure is not required for first-time installations. In some cases, a model type has changed based on vendor requirements.
Table 1: Upgrade Scripts, Templates, and Procedures Listed by SPECTRUM Version If you are upgrading from this SPECTRUM version: Use the following script, template or procedure: 5.0.1 6.0 6.0.1 6.0.2 MM_dep_50R1_script.pl [page 89] X Convert_to_SSX.script [page 90] X MT_del_50R1_script.pl [page 91] X Rem_EnetApp_Mdls.sh [page 92] X X X X Removing the Discontinued Model Types [page 93] X X X X host_conversion.
If You Used Model Type Editor If you used the Model Type Editor (MTE) to customize your SpectroSERVER database, make a record of all changes that you made with the MTE. Some changes made with the MTE are not preserved when the database is upgraded to a later version of SPECTRUM.
Figure 2: Attributes Preserved With Scripts SPECTRUM Installation Guide Page 88 Document 0675
Upgrading Model Types and Models From SPECTRUM 5.0.1 This section contains the procedure for upgrading your SPECTRUM models if you are upgrading from SPECTRUM 5.0.1. Several management modules were deprecated since this SPECTRUM version. In addition, see Postinstallation Scripts and Templates [page 85] for additional scripts you must run to upgrade to the latest SPECTRUM version. MM_dep_50R1_script.pl The MM_dep_50R1_script.pl script identifies and converts old models.
procedure, delete that model and manually create it as a new GnSNMPDev model or the appropriate LANPlex or Kentrux model type. Troubleshooting If the MT_dep_50R1_script.pl script does not run: 1. Make sure you are logged in as a valid SPECTRUM user. 2. Navigate to: <$SPECROOT>/vnmsh 3. Run the following command: ./connect 4. Run the following command: ./disconnect You may have to perform this procedure more than once.
Procedure 1. Start the SpectroSERVER. 2. Navigate to: <$SPECROOT>/SS-Tools/Convert_to_SSX 3. Run the following command: Convert_to_SSX.script The -gnsnmpdev flag can be added to the end of this command to convert both Gen9000 and GnSNMPDev models. Only models of 9x5xx devices are converted; other Gen9000 and GnSNMPDev models are not converted. 4. After the script runs, check the Conv_SSX_Log__
Procedure 1. When you have determined that all models have converted, stop the SpectroSERVER. 2. Run the MT_del_50R1_script.pl script, using a logon identity that has permissions to delete database entries, files, and directories in the SPECTRUM installation directory (<$SPECROOT>). Removing Discontinued Ethernet Application Models and Model Types The section contains the procedure for removing the discontinued models and model types listed in Table 3, using the procedure that follows.
4. Check the Rem_Mdls_Log__
Upgrading Host Models and Model Types The section contains the procedure for converting the host model types listed in Table 4 to new model types as part of your SPECTRUM upgrade. The table shows model conversion data for old host model types and the new converted host model types. Table 4: Host Model Type Conversions Old Host Model Type New Host Model Type SM-GHO1000: Host_NT, Host_HP, Host_SGI, Host_IBM, Host_DEC, Host_Sun, and GenericHost model types.
host_conversion.pl Procedure 1. Start the SpectroSERVER. 2. Navigate to: SS-Tools/Convert_to_Host 3. Run the following command: host_conversion.pl [gnsnmpdev] Note: If you run the script with the gnsnmpdev flag, it will also convert any workstations modeled as a GnSNMPDev. It may take a few minutes for the script to run. 4. Check the Conv_HOST_Log__
Procedure 1. Stop the SpectroSERVER. 2. Navigate to: <$SPECROOT>/SS 3. Run the following command: ../SS-Tools/db_remove ../SS-Tools/ Convert_to_Host/obsmodellist.txt You can also run the above command with the debug flag turned on, as follows: ../SS-Tools/db_remove -debug ../SS-Tools/Convert_to_Host/obsmodellist.
Upgrading Nortel Accelar Models and Model Types The section contains the procedure for upgrading the models and model types listed in Table 5, using the procedure that follows. Table 5: Nortel Accelar Upgrade Old Model Type New Model Type Template PassportDev Accelar1200 Psp2Accelar.dbc (model type handle 0x2ec0005) (model type handle 0x2ec0002) Note: You can use Search Manager to determine if you have models that meet this criteria.
Upgrading Generic Cable Modem Models and Model Types The section contains the procedure for upgrading the models and model types listed in Table 6, using the procedure that follows. Table 6: Generic Cable Modem Upgrade Old Model Type New Model Type Script Details GnCableModem DocsisCM DocsisCM_migration.pl The new model type retains the same model type handle, so information about that model is retained in the upgrade. Procedure 1. Start the SpectroSERVER. 2.
Upgrading Juniper Router Models and Model Types The section contains the procedure for upgrading the models and model types listed in Table 7, using the procedure that follows. Table 7: Juniper Router Upgrade Old Model Type New Model Type Script Details JNPR_Mxxx JnprRedundRtr Improved redundancy components for the M20, M40e, and M160 devices. juniperConv.pl Procedure 1. Start the SpectroSERVER. 2. Navigate to: <$SPECROOT>/SS-Tools/juniperConversion 3. Run the following command: juniperConv.pl 4.
Upgrading Management Modules Use Table 8 to determine the script and template combination to run to upgrade the SPECTRUM management modules listed; then complete the procedure—or individual steps—that follow. Table 8: Scripts and Templates for Upgrading Management Modules For this management module: Use this template: With these scripts: SM-WEL1003 Ntlwf_dep_template MM_Model_Migration.pl MM_MType_Deletion.pl MM_rediscovery.pl SM-CSI1097 DocsisDepTemplate MM_MType_Deletion.pl MM_rediscovery.
Troubleshooting If one of the scripts fails: 1. Ensure that you are running the scripts in the order presented in the procedure. 2. Ensure that the SpectroSERVER is running or stopped, as indicated in the procedure. 3. Ensure that the database is not locked by another process.
Troubleshooting This section describes error messages and problems you may encounter when using the SPECTRUM installation software. Possible causes and solutions are provided wherever possible. Error: On Solaris systems, the screen displays inverted text, partially missing text, or other improper elements. Solution: Make sure you are using the latest drivers for your video card. Error Message: You must have the correct privileges to run Install. On a Unix system, you must be root.
Error Message: - - - - - - - - - - - TRACEBACK Module "X " Message Module "Dsply" Message Module "Err - - - - - - - - 2: file "err.c " line 438 0: file "./xdsply.c" line 102 " Message -1: file "err.
Error Message: ** Error during Database save as db_ Installation Phase: DBImporting Cause: Installation software is unable to save the existing SS database, most likely because the SS database is write-protected or does not exist (was deleted). Solution: Use the chmod utility to make the SS database writable, and reinstall. If this does not work, contact your Aprisma support or sales representative.
Cause: These and similar messages during linking are caused by failure of on-site linking of a product executable. Often, these messages are preceded by output of various link utilities, for example: ld: SS.o: No such file or directory ld: : output write error: Bad file number nm: SpectroSERVER: cannot open The exact format and nature of these errors may vary somewhat between platforms.
Uninstalling SPECTRUM You should uninstall SPECTRUM when you are migrating from one machine to another; or when removing SPECTRUM from your network environment. You should not uninstall SPECTRUM when upgrading in place. In this section: Uninstalling SPECTRUM 6.5.1 on Solaris [page 106] Uninstalling SPECTRUM 6.5.1 on Windows [page 107] Uninstalling SPECTRUM 6.5.1 on Solaris The uninstall program deletes everything in the directory tree, regardless of file permissions.
Uninstalling SPECTRUM 6.5.1 on Windows The uninstall program deletes everything in the directory tree, regardless of file permissions. Prerequisites Stop all processes (for example, Alarm Manager, Event Log). Procedure 1. Go to Start > Settings > Control Panel. 2. Double-click Add/Remove Programs. 3. Select SPECTRUM 6.5.1.0; then click the Change/Remove button (Windows 2000) or Add/Remove button (Windows NT). 4. The SPECTRUM Uninstall screen displays. Select the components of SPECTRUM to uninstall.
7. To uninstall Hummingbird Exceed, click Next. 8. Make sure Remove is selected in the Program Maintenance window; then click Next. 9. Click Remove. 10. In the SPECTRUM Uninstall screen, click Done. Note: The uninstalled programs still appear selectable in the Change/Remove (or Add Remove) window until the window is closed and reopened.
Appendix A This section contains detailed information on topics referenced from other parts of this guide. In this section: Using the Online Backup Utility [page 109] Mounting the SPECTRUM CD [page 109] Setting the Solaris Display Environment [page 111] Using the DBconv Utility [page 112] Using the Online Backup Utility Procedure 1. In the SPECTRUM Control Panel select File > Save Database. The Online Database Backup Configuration View opens. 2.
If Volume Management is disabled, you will need to set up a CD mountpoint directory and enter a mount command to access the installation software on the SPECTRUM CD. This procedure varies depending on whether the installation is local (the target workstation is the host for the CD drive) or remote (the drive is hosted by a workstation other than the target workstation). CD mounting procedures for local and remote installations are described separately in the following sections.
If the dfstab file does not already exist, you will have to create it. Add this entry, perform Step 6, and then reboot (or run etc/rc2.d/K28nfs.server.start) before proceeding to Step 7.) 6. Export the file system by making the following command line entry: exportfs -a 7. Log onto the target workstation as root using the su - command. 8. Type mkdir /cdrom to create a directory for the CD mount point.
is in effect on your workstation. If it is not, set the variable by entering one of the following commands: From the C shell: setenv DISPLAY :0 From the Bourne or Korn shells: DISPLAY=:0 ; export DISPLAY Using the DBconv Utility SPECTRUM provides a DBconv utility that converts a set of models in the SPECTRUM database from one model type to another. You can also use DBconv to rediscover applications and to reconfigure the interfaces in a set of models.
If you wish to convert only a subset of the models present, you can remove the comment symbol from the #models_to_convert line and enter a specific number of models to be converted. This action will cause the DBConv utility to selectively convert the number of models you specify from among those present in your database. Leaving the line commented (with the # in place) will convert all models of the specified type with which SpectroSERVER has established contact. 5.
(e.g., Rtr_cisco_IGS instead of Rtr_CiscoIGS), the system will generate an Event00010644 model mismatch alarm. The DBconv utility can take its configuration from two places: • A file that is specified on the command line • Directly from the command line itself. Options entered via the command line will override corresponding options specified in the configuration file. To get a list of available command line options, run DBconv with no option listed. For further details on DBconv functions, see the DBconv.
Index C Client Access setting up Solaris for clients [80] Components Available for Installation status [58] converting models during an upgrade [84] D databases backing up after an upgrade [73] installation savefiles [79] preserving customizations [19] using online backup utility [109] directory structure migration and upgrade (Windows) [38] E emergency repair disk creating (Windows) [33] Exceed X server configuring for remote display [81] incorrect version [45] Expiration Date [64] F File System convert
G getting started [10] graphics 24-bit color (Solaris) [25] checking 24-bit frame buffer [25] configuring 24-bit color mode [27] I in-place upgrade (Windows) [36] installation files created during (Solaris) [78] prerequisites (Windows) [32] Solaris prerequisites [22] types [18] Windows prerequisites [32] installation GUI displaying on a remote Solaris workstation [111] installation GUI screens [48] Choose Destination Location (Solaris) [42] Choose Destination Location (Windows) [46] Component Configuration
migrations [18] SPECTRUM advanced and value-added applications [21] SPECTRUM patches [21] upgrades [18] installing SpectroSERVER on its own workstation [14] installing SPECTRUM preserving database customizations [19] upgrading models [84] installing SPECTRUM on Solaris in-place upgrade [29] migration and upgrade [30] IP address of target workstation [22], [32] L Landscape Handle assigning [14] changing [14] changing your database landscape handle [16] determining current [16] entering [65] numeric value [6
N NuTCRACKER uninstalling (Windows) [35] O OSAGENT_PORT [77] P patches Solaris 7 [24] Solaris 8 [25] privileges administrator (Windows) [32] root (Solaris) [22] processd stopping in SPECTRUM version 5.0.1 (Solaris) [28] stopping in SPECTRUM version 5.0.
security checking network settings (Windows) [33] SpectroGRAPH and SpectroSERVER on separate workstations [39] SPECTRUM application CD installing from a local drive [110] installing from a remote drive [110] mounting on Solaris [109] SPECTRUM releases compatibility between [19] SS Activation Key [64] swap space recommended setting [13] System configurations recommended [13] System performance disk striping and RAID [14] optimizing [12] recommended system configurations [13] user auditing (Windows NT) [34] S
installing on Windows [72] SPECTRUM Installation Guide Page 120 Document 0675