Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

SPOTS V10 Drop 4 Installation Guide - Real Time

301 views

Published on

SPOTS V10 Drop 4 Installation Guide - Real Time

Published in: Education
  • Be the first to comment

  • Be the first to like this

SPOTS V10 Drop 4 Installation Guide - Real Time

  1. 1. SIEMENS S.A. SPOTS V10 Drop 4 Installation Guide - Real Time November/2003 E200301-01-215-V10.0I-04
  2. 2.  SIEMENS S.A. OG IC, R&D WON NM P3 R. Irmãos Siemens, nº 1 2720-093 Amadora Portugal All rights reserved. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, for any purpose other than the purchaser’s personal use without the written permission of Siemens S.A. This document consists of a total of 63 pages (1 Annex included). The information contained in this document is subject to change.
  3. 3. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. Table of Contents 1 INTRODUCTION...........................................................................................................................................3 1.1 SPOTS Real Time documentation......................................................................................................................4 1.2 Target group and structure of this manual..........................................................................................................5 1.2.1 Document Conventions.............................................................................................................................5 2 GENERAL OVERVIEW..................................................................................................................................6 2.1 Platform Hardware & Standard Software...........................................................................................................8 3 INSTALLATION PROCEDURE OVERVIEW.......................................................................................................9 3.1 Initial Installation ...............................................................................................................................................9 3.2 APS Upgrade......................................................................................................................................................9 4 INSTALLING SPOTS REAL TIME SOFTWARE (SOLARIS ENVIRONMENT).................................................10 4.1 Adding SPOTS Real Time SW with admintool ...............................................................................................11 4.2 Adding SPOTS Real Time Software with Package Commands .......................................................................14 4.3 Package Installation .........................................................................................................................................16 4.3.1 SPOTS RT Server (SpotsRTS) ...............................................................................................................16 4.3.2 SPOTS RT Agency (SpotsRTA) in Solaris.............................................................................................17 4.3.3 SPOTS RT Client (SpotsRTC)................................................................................................................18 4.3.4 SPOTS SNMP Alarm Agent (SpotsSAA)...............................................................................................20 4.4 Configuration issues.........................................................................................................................................22 4.4.1 Configuring SPOTS RT Agency Software (Solaris environment) .......................................................22 4.4.1.1 Configuring real_time.cfg files ......................................................................................................22 4.4.1.2 Adding Real-Time specific variables to sas.cfg .............................................................................24 4.4.2 Configuring the events gateway file........................................................................................................25 4.4.3 Modifying the RT Agencies default memory (if desired)........................................................................25 4.4.4 Modifying the RT Agents default granularity (if desired).......................................................................26 4.4.5 Modifying the RT Bar Chart reports default granularity (if desired) ......................................................27 4.4.6 Connecting SAA to an external Fault Management application .............................................................29 4.4.7 Multiple Ethernet Cards on the Same Machine.......................................................................................31 4.5 SPOTS Real Time Licensing Software ............................................................................................................32 4.6 Starting SPOTS RT Applications.....................................................................................................................33 5 INSTALLING SPOTS RT AGENCY SOFTWARE (WINDOWS ENVIRONMENT)............................................34 5.1 Installation sequence ........................................................................................................................................35 5.2 Configuration issues in the Windows environment..........................................................................................37 5.2.1 RT Agency configuration files ................................................................................................................37 5.3 Creating user ....................................................................................................................................................40 6 INSTALLING SPOTS RTC SOFTWARE (WINDOWS ENVIRONMENT)........................................................41 6.1 Installation sequence ........................................................................................................................................42 6.2 Troubleshooting ...............................................................................................................................................45 7 SPOTS REAL TIME LICENSE CHECKING ...................................................................................................46 8 CUSTOMISATION FOR MULTI-SERVER ENVIRONMENTS .............................................................................47 9 DE-INSTALLING SPOTS REAL TIME SOFTWARE (SOLARIS ENVIRONMENT)............................................48 9.1 Stop SPOTS RT Agencies................................................................................................................................48 9.2 Stopping SPOTS RT applications ....................................................................................................................48 9.3 Removing SPOTS Real Time Packages ...........................................................................................................51 9.3.1 Removing SPOTS Real Time Packages with admintool.........................................................................51 9.3.2 Removing SPOTS Real Time Packages with Package Commands.........................................................52 10 DE-INSTALLING SPOTS-RT AGENCY (WINDOWS ENVIRONMENT) ......................................................54 11 DE-INSTALLING SPOTS-RTC (WINDOWS ENVIRONMENT) ..................................................................55 12 ABBREVIATIONS .....................................................................................................................................57 13 REFERENCES...........................................................................................................................................58 ANNEX 1 – UNIX ENVIRONMENT VARIABLES .............................................................................................59 E200301-01-215-V10.0I-04 i
  4. 4. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) ii E200301-01-215-V10.0I-04
  5. 5. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 1 Introduction The SPOTS product belongs to the family of Network Management Systems provided by Siemens (ICM N), for the Operation and Maintenance of Mobile Networks (Core, GERAN and UTRAN sub-networks). The SPOTS product integrates the platform (consisting of hardware and standard software) and application software that supports the Performance Management activities on the Network. The SPOTS V10 application software includes a mandatory Long-Term part and an optional, additional Real-Time part. The SPOTS V10 Long Term provides performance management analysis capabilities, allowing to produce pre-defined and user-defined reports with Performance Management indicators based on data periodically collected from the network. The SPOTS V10 Real Time provides near real-time updates of the network performance management information, allowing to define threshold values for Performance Management indicators that result in alarms when they are violated. The optional module SNMP Alarm Agent allows these alarms to be forwarded via SNMP to an external application. This document describes the installation procedures for the SPOTS V10 Real-Time optional part. These procedures require that the mandatory Long-Term part be previously installed. The description of the SPOTS V10 Long-Term installation is provided in [1]. E200301-01-215-V10.0I-04 3
  6. 6. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 1.1 SPOTS Real Time documentation The SPOTS Real Time application documentation consists of the following parts: Manuals Document the application and provide the necessary information for its operation. SPOTS V10.0 – Real Time Installation Guide (this document). SPOTS V10.0 – Real Time User Manual (refer to [3]). They are available (with the SPOTS Real Time SW) in the SPOTS distribution media (CD-ROM). Release Notes Summarizes the authorized versions of the hardware and software products and up-to-date information about user notes, functional limitations and error corrections. The Release Notes are applied for a specific release of this SPOTS version (including both the Long-Term and the Real-Time part). SPOTS V10.0.x – Release Notes — refer to [4] On-line help Provides a complete “on-context “ description of the system functionality. 4 E200301-01-215-V10.0I-04
  7. 7. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 1.2 Target group and structure of this manual The Real Time Installation Guide is intended for System Administrators and for those who install the Real-Time part of the SPOTS product. It describes the necessary procedures to perform the initial installation, configuration and de-installation of the SPOTS Real-Time part 1), specific chapters are dedicated to the installation and de-installation of the Windows variant of the SPOTS Real Time Client. Chapter 2 describes the functional components of the SPOTS Real Time application. Chapter 3 contains an overview of the required procedures for the initial installation. For the installation procedures, refer to Chapter 4 and Chapter 5. Perform the installation procedures as described in this manual. Deviations can result in malfunctioning. 1.2.1 Document Conventions The following textual and graphic conventions are used in this document: Convention Meaning # The UNIX super-user default prompt. Boldface Emphasises important word or concept. expression An expression enclosed within angle brackets indicates some value to be input that cannot be determined in beforehand and so it should not be taken literally. Important notice or warning. Action that requires user interaction. Note or relevant event triggered by some action. Indicates that a certain procedure is completed. 1) As a prerequisite, please read the corresponding Release Notes. E200301-01-215-V10.0I-04 5
  8. 8. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 2 General Overview The SPOTS Real Time (RT) application for Performance Alarm Monitoring comprises several functional components, grouped into installable software packages according to a Client/Server approach: SPOTS Real Time Server (Solaris packages): • SPOTS Real Time Server (SpotsRTS / SRTS) • SPOTS Real Time Agency (SpotsRTA) (available also on Windows 2000) • SPOTS SNMP Alarm Agent (SpotsSAA / SAA) (optional package) SPOTS Real Time Client (available as Solaris package and on Windows NT/2000/XP): • SPOTS Real Time Client (SpotsRTC / SRTC) The SpotsAS, SpotsNS, SpotsDS components belong to the SPOTS Long-Term (LT) application system. The distribution (and installation) of the SPOTS LT is done separately from the SPOTS RT distribution (and installation). For the SPOTS LT installation procedure, please refer to [1]. The SPOTS LT installation always precedes the SPOTS RT installation. The SPOTS RT Server packages (SpotsRTS, and, if applicable, SpotsSAA) must be installed on the same machine(s) where the SpotsAS (SPOTS Application Server) Long-Term part is installed. The SpotsRTA package may be installed on the same machine as the SpotsAS or/and on a separate Windows 2000 machine to allow the SPOTS load distribution —details on these configurations are described in sections 4.3.2 and 5. Thus, depending on the SPOTS Long-Term installation that was performed, the SPOTS Real Time Server components may be installed in two different configuration types: Single Server and Distributed — details on these configurations are described in [3], Section 1.2 (Environment). The SPOTS RT Client will be installed on each user’s workstation implementing the SPOTS Real-Time Graphical User Interface (GUI). The SPOTS RT Client (SpotsRTC) is typically installed on the same machine(s) where the SpotsCL (SPOTS Client) Long-Term part is installed but this is not mandatory. The SPOTS RT Server components are available on Solaris 8 (release 2/02). The SPOTS RT Agency component is available on Solaris 8 (release 2/02) and on Windows 2000, with Service Pack 3 (or higher). The SPOTS RT Client component is available on the following operating systems: • Solaris 8 (release 2/02) • Windows NT 4.0, with Service Pack 6a (or higher) 6 E200301-01-215-V10.0I-04
  9. 9. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. • Windows 2000, with Service Pack 3 (or higher) • Windows XP It is possible to install the SPOTS RT Client on the same system as the SPOTS RT Server. However, due to performance reasons, intensive usage of RTC in this configuration is not recommended. In a normal operation environment, this SPOTS RT Client configuration is suitable only for sporadic actions (e.g. administrative actions). Complete information about how to install and de-install SPOTS Real Time is presented, in the current document, from Chapter 4 through Chapter 9. E200301-01-215-V10.0I-04 7
  10. 10. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 2.1 Platform Hardware Standard Software Hardware Configuration and Standard Software The SpotsRTS, SpotsRTA and SpotsSAA RT components must be installed on the same machine as the SPOTS LT Application Server component. This machine is designated as a SPOTS PMS (Performance Management Server) machine. Thus, refer to the SPOTS PMS Hardware Configuration in [1], section Platform Hardware Standard Software. SPOTS RTA (Windows environment) The SpotsRTA can also be installed on a dedicated Windows machine. Hardware The following minimal configuration is required: Requirement Value Comment Processor Pentium 4 Mandatory Memory 1 GB Mandatory Hard disk space 36 GB Mandatory The available hard-disk space must be located on a local non-removable drive. Standard Software The Windows SPOTS RTA uses the following standard software products: • Microsoft Windows 2000 with Service Pack 3 (or higher). • TCP/IP protocol. The used HW should be chosen according to the information provided by your Siemens representative, who will help you determine which configuration best fits your network. SPOTS Real Time Software The SPOTS Real Time SW consists of several packages, collectively known as APS — see Chapter 4 and Chapter 5 for a detailed description of the SPOTS Real Time software packages. 8 E200301-01-215-V10.0I-04
  11. 11. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 3 Installation procedure overview This chapter provides an overview of how to carry out the installation of the SPOTS Real Time software from scratch. SPOTS RT software it is an add-on to the SPOTS LT functionality. To operate correctly, SPOTS LT must be already installed and is of no use without it. After completing the installation tasks, always perform a system shutdown. Execute, as root user, the following command: # /etc/shutdown -y -g0 -i6 Two different installation options exist: Initial Installation and APS Upgrade. 3.1 Initial Installation Before installing SPOTS, one shall collect the necessary information, to serve as reference during the installation — refer to [1], Annex 5 – Configuration Worksheet. The following steps have to be carried out for the Initial Installation. 1. Installing Specific Hardware The procedure to install the required hardware components is out of the scope of this manual. Refer to the hardware documentation. 2. Installing Standard Software Refer to [1], Chapter 4, 5 and 6. 3. Installing SPOTS Long Term Software Refer to [1], Chapter 7. 4. Installing SPOTS Real Time Software Refer to Chapters 4, 5 and 5 of this document. 3.2 APS Upgrade For information about the SPOTS APS Upgrade procedure refer to [1], Section 3.2. E200301-01-215-V10.0I-04 9
  12. 12. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 4 Installing SPOTS Real Time Software (Solaris environment) The SPOTS Real Time application for Performance Alarms Monitoring and Alarms Forwarding comprises several functional components organized in software packages: SPOTS RT Performance Alarms Monitoring • SPOTS Real Time Client (SpotsRTC) • SPOTS Real Time Server (SpotsRTS) • SPOTS Real Time Agency (SpotsRTA) SPOTS RT QoS Alarms Forwarding • SPOTS SNMP Alarm Agent (SpotsSAA) These components may be installed in two different environment types: Single Server and Distributed — details on these configurations are described in [2], Section 1.2 (Environment). In a Solaris environment, two different methods for performing software administra-tion are supported: • Admintool, a graphical front-end to the package commands. For a detailed description about adding or removing SPOTS Real Time software using admintool, refer to Sections 4.1 or 9.3.1 respectively. • Package commands (pkgadd, pkgrm and pkginfo). For a detailed description about adding or removing SPOTS Real Time software using package commands, refer to Sections 4.2 or 9.3.2 respectively. After performing the installation of the SPOTS Real Time software according to one of the above methods, perform the configuration actions described in Section 4.4. 10 E200301-01-215-V10.0I-04
  13. 13. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 4.1 Adding SPOTS Real Time SW with admintool The tool admintool offers ease of use, as it is a graphical interface to the pkgadd and pkgrm commands and it includes online help providing general information on using the tool. The user can also benefit from admintool as it offers detailed information about the specified product, including approximate disk space requirements. Using the admintool graphical browser provides a modular view of the contents of the installation medium. These reasons make admintool a preferential tool in software administration, unless you do not meet the requirements described in the following notice: The admintool software manager requires a bit-mapped display monitor and the ability to use the OpenWindows environment. If these requirements are not met, all software-related tasks can alternatively be performed using the package admi-nistration commands. Login as root user. Insert the SPOTS Real Time V10.0 CD. Volume Manager utility will automatically mount it. Verify that the DISPLAY environment variable is correctly set. Start admintool: # admintool Admintool provides online help with general information on using the tool. Use it whenever necessary, accessing the “Help” menu or through the context sensitive Help button. Select “Software” from the Admintool “Browse” menu. The Admintool: Software window is displayed, listing all software currently installed in your system. Select “Add...” from the “Edit” menu. The Admintool: Set Source Media window will appear. Set the Source Media as indicated below: Software Location: “CD with Volume Management” CD Path: “/cdrom/cdrom0” Click on the OK button to acknowledge. Back in the Admintool: Add Software window, click on the checkbox on the Software field to select “SPOTS REAL TIME 10.0”. E200301-01-215-V10.0I-04 11
  14. 14. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) Press the Customize... button. In the Admintool: Customize Installation window, the installer is invited to specify the SPOTS Real Time components to install. To proceed with the installation, execute the following actions: Expand SPOTS RT Performance Alarms Monitoring (RTAlrMon) and SPOTS RT QoS Alarms Forwarding (RTAlrFwd), pressing the triangle-shaped bullet (see Figure 1). The packages in RTAlrMon and RTAlrFwd clusters are displayed. Select/De-select the components to install, clicking on the inner square bullets. Confirm your choice, clicking on the OK button. Figure 1 – Fully expanded Admintool: Customize Installation window Back to the Admintool: Add Software window, click on the Add button. The warning message in Figure 2 may appear. If so, ignore it, clicking on the “Continue” button. To disable it permanently, set the “Check here to disable this message” option before pressing “Continue”. 12 E200301-01-215-V10.0I-04
  15. 15. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. Figure 2 – Desktop Environment warning A window will appear, prompting you for information about the installation of the selected packages. Install the SPOTS Real Time packages, as described in Section 4.3. Return to Admintool: Software window, pressing the Return key. Exit admintool, selecting “Exit” from the “File” menu. If it doesn’t exist, the spots user is automatically created during installation. However, it will be locked until a password is assigned to it. If the spots user didn’t exist, assign a password to it, executing the following shell command: # passwd –r files spots The command will request a new password for the user and its confirmation. Remove the SPOTS RT CD-ROM from drive. Selected SPOTS Real Time components are now installed in the local host. Then, proceed according to the intended SPOTS environment: Single Server Installation completed, all SPOTS Real Time components are now installed in the local host. Distributed Local installation completed. Log on another platform and repeat the installation process until all the desired SPOTS RT components are installed in the corresponding platforms. Upon successful installation of the SAA component, configure it according to the description in Section 4.4. E200301-01-215-V10.0I-04 13
  16. 16. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 4.2 Adding SPOTS Real Time Software with Package Commands Using the pkgadd and pkgrm commands offers flexibility. For example, you can incorporate these commands into scripts, set up optional files to avoid user interaction or perform special checks, and copy software packages to spool directories. Login as root user. Insert the SPOTS Real Time V10.0 CD. Execute the following command: # /usr/sbin/pkgadd -d /cdrom/cdrom0/spots_rt As a result, the pkgadd menu is displayed, prompting for the SPOTS Real Time packages to install in this host: The following packages are available: 1 SpotsRTA SPOTS RT Agency (sparc) 10.0.8 2 SpotsRTC SPOTS RT Client (sparc) 10.0.8 3 SpotsRTS SPOTS RT Server (sparc) 10.0.8 4 SpotsSAA SPOTS SNMP Alarm Agent (sparc) 10.0.8 Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]: Packages may be selected via two different methods: • Accepting the default value, all the packages are installed. After this, the menu is presented so that you can quit (q). Typically, this method is used when installing a Single Server configuration. • Enter one (or more) package(s) at a time. For example, entering “4”, installs SpotsSAA and then reprints the menu, waiting for new input, which can be to install another package or to quit (q) the pkgadd command. Typically, this method is used when installing a package in a Distributed environment. Type in the menu item(s) of the SPOTS Real Time component(s) you wish to install in the local host. After confirming your selection, execute the corresponding installation steps, as described in Section 4.3. After installing all the desired packages just quit the pkgadd tool, entering the option “q”: The following packages are available: 1 SpotsRTA SPOTS RT Agency (sparc) 10.0.8 2 SpotsRTC SPOTS RT Client (sparc) 10.0.8 14 E200301-01-215-V10.0I-04
  17. 17. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 3 SpotsRTS SPOTS RT Server (sparc) 10.0.8 4 SpotsSAA SPOTS SNMP Alarm Agent (sparc) 10.0.8 Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]: q If it doesn’t exist, the spots user is automatically created during installation. However, it will be locked until a password is assigned to it. If the spots user didn’t exist, assign a password to it, executing the following shell command: # passwd –r files spots The command will request a new password for the user and its confirmation. Remove the SPOTS RT CD-ROM from drive. Selected SPOTS Real Time components are now installed in the local host. Then, proceed according to the intended SPOTS environment: Single Server Installation completed, all SPOTS Real Time components are now installed in the local host. Distributed Local installation completed. Log on another platform and repeat the installation process until all the desired SPOTS Real Time components are installed in the corresponding platforms. Upon successful installation of the SAA component, configure it according to the description in Section 4.4. E200301-01-215-V10.0I-04 15
  18. 18. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 4.3 Package Installation The events, warnings and actions detailed below are common to both SW administration methods admintool (Section 4.1) and package commands (Section 4.2) and should only be executed as part of those procedures. The following sub-sections provide answers to the questions presented during the installation of each package. To accept the default values, (just) press the “Return” key. If UNIX users and groups are managed with NIS/NIS+, the SPOTS installation process leaves the creation of the necessary users (spots, …) and groups (pmadmin and pmuser) in the hands of the system administrator. However, some requirements must be ensured: Use the following attributes for user “spots”: • Primary group: pmadmin • Secondary group: dba • Login shell: ksh • Home directory: base_home_dir/user_login. Typical values for base_home_dir are “/home” or “/export/home”. 4.3.1 SPOTS RT Server (SpotsRTS) Only one installation of the SpotsRTS package is allowed per system. If no SRTS software component is detected in the local host, then the installation will proceed otherwise it will stop. The SPOTS Application Server software component from SPOTS LT must be already installed. Specify the installation (absolute) path of the SPOTS RT Server or (recommended) accept the default path “/opt/spots/rt”. Do NOT choose the same directory as the one chosen for installation of the SPOTS LT software (the latter directory is by default /opt/spots - see [1], Section 7.3 “Package Installation”). The specified directory must exist before installation. Otherwise, you’ll be asked if you want the installation program to create it. Specify the SPOTS LT Database Server (SpotsDS) host name or IP Address. If a local SDS installation is detected the default value shall be the local host name; otherwise no default value is given. Specify the Oracle SID value for SPOTS database. If a local SDS installation is detected the default value shall be obtained from SPOTS environment; otherwise the default value shall be“spot”. The installation program checks for the usage of NIS/NIS+ groups. If no NIS/NIS+ groups are detected then no action is required; otherwise the following message is displayed: 16 E200301-01-215-V10.0I-04
  19. 19. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. NIS/NIS+ groups detected. Please check if groups ‘pmuser’ and ‘pmadmin’ are defined in NIS/NIS+ before proceeding Press return key to continue The system administrator performing the installation must guarantee that those groups exist before proceeding with installation. The installation program checks for the usage of NIS/NIS+ users. If no NIS/NIS+ users are detected then no action is required; otherwise the following message is displayed: NIS/NIS+ users detected. Please check if user ‘spots’ is defined in NIS/NIS+ before proceeding Press return key to continue The system administrator performing the installation must guarantee that ‘spots’ user exists, according to SPOTS requirements (see Section 4.3), before proceeding with installation by pressing the “return” key. Since SpotsAS package from SPOTS LT software must be installed, the user’s home directory shall be obtained from SPOTS environment. Confirm all polls with “y”. Inspect the output in order to verify that no problems occur during the installation. Package SpotsRTS installed. 4.3.2 SPOTS RT Agency (SpotsRTA) in Solaris The Spots Real-Time Agency package may be installed on the same machine as the SpotsSAS in Solaris as described in this section, or/and it can be installed on one or more Windows 2000 machine as described in 5, for Spots load distribution. Only one installation of the SpotsRTA package is allowed per system. If no SRTA software component is detected in the local host, then the installation will proceed, otherwise it will stop. Specify the installation (absolute) path of the SPOTS RT Agency or (recommended) accept the default path “/opt/spots/rt”. The specified directory must exist before installation. Otherwise, you’ll be asked if you want the installation program to create it. Do NOT choose the same directory as the one chosen for installation of the SPOTS LT software (the latter directory is by default /opt/spots - see [1], Section 7.3 “Package Installation”). E200301-01-215-V10.0I-04 17
  20. 20. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) The installation program checks for the usage of NIS/NIS+ groups. If no NIS/NIS+ groups are detected then no action is required; otherwise the following message is displayed: NIS/NIS+ groups detected. Please check if groups ‘pmuser’ and ‘pmadmin’ are defined in NIS/NIS+ before proceeding Press return key to continue The system administrator performing the installation must guarantee that those groups exist before proceeding with installation. The installation program checks for the usage of NIS/NIS+ users. If no NIS/NIS+ users are detected then no action is required; otherwise the following message is displayed: NIS/NIS+ users detected. Please check if user ‘spots’ is defined in NIS/NIS+ before proceeding Press return key to continue The system administrator performing the installation must guarantee that ‘spots’ user exists, according to SPOTS requirements (see Section 4.3), before proceeding with installation by pressing the “return” key. Enter the user’s home directory or accept the default (recommended). The default value is “/export/home”. This query is applicable only if no SPOTS package is present in the system. If any SPOTS package is already installed, the home directory specified during its installation will be assumed and the installation proceeds to the next step. Confirm all polls with “y”. Inspect the output in order to verify that no problems occur during package installation. Package SpotsRTA installed. 4.3.3 SPOTS RT Client (SpotsRTC) Only one installation of the SpotsRTC package is allowed per system. If no SRTC software component is detected in the local host, then the installation will proceed otherwise it will stop. Specify the installation (absolute) path of the SPOTS RT Client or (recommended) accept the default path “/opt/spots/rt”. 18 E200301-01-215-V10.0I-04
  21. 21. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. Do NOT choose the same directory as the one chosen for installation of the SPOTS LT software (the latter directory is by default /opt/spots - see [1], Section 7.3 “Package Installation”). The specified directory must exist before installation. Otherwise, you’ll be asked if you want the installation program to create it. When defining the connection settings between SPOTS RT Client and SPOTS Naming Server, two situations can occur: A local SNS installation is detected Decide if a connection to the local SNS should be established (default behaviour) or not (answer “n”). Answering “n” has the same effect as no local SNS being detected; so, proceed executing the steps associated with the other alternative. No local SPOTS Naming Server is detected Specify the SNS host name or IP Address. Specify the SNS TCP/IP port number (or accept the default “19980”) as it was previously configured during SNS installation. The installation program checks for the usage of NIS/NIS+ groups. If no NIS/NIS+ groups are detected then no action is required; otherwise the following message is displayed: NIS/NIS+ groups detected. Please check if groups ‘pmuser’ and ‘pmadmin’ are defined in NIS/NIS+ before proceeding Press return key to continue The system administrator performing the installation must guarantee that those groups exist before proceeding with installation. The installation program checks for the usage of NIS/NIS+ users. If no NIS/NIS+ users are detected then no action is required; otherwise the following message is displayed: NIS/NIS+ users detected. Please check if user ‘spots’ is defined in NIS/NIS+ before proceeding Press return key to continue The system administrator performing the installation must guarantee that ‘spots’ user exists, according to SPOTS requirements (see Section 4.3), before proceeding with installation by pressing the “return” key. Enter the user’s home directory or accept the default (recommended). The default value is “/export/home”. This query is applicable only if no SPOTS package is present in the system. If any SPOTS package is already installed, the home directory specified during its installation will be assumed and the installation proceeds to the next step. E200301-01-215-V10.0I-04 19
  22. 22. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) Confirm all polls with “y”. Inspect the output in order to verify that no problems occur during package installation. Package SpotsRTC installed. 4.3.4 SPOTS SNMP Alarm Agent (SpotsSAA) Only one installation of the SpotsSAA package is allowed per system. If no SAA software component is detected in the local host, then the installation will proceed otherwise it will stop. The SPOTS Application Server software component from SPOTS LT must be already installed. SPOTS SNMP Alarm Agent software will be installed in the same base installation directory as the SPOTS LT Application Server software (this directory is by default /opt/spots - see [1], Section 7.3 “Package Installation”). When defining the connection settings between SPOTS SNMP Alarm Agent and SPOTS Naming Server, two situations can occur: A local SNS installation is detected Decide if a connection to the local SNS should be established (default behaviour) or not (answer “n”). Answering “n” has the same effect as no local SNS being detected; so, proceed executing the steps associated with the other alternative. No local SPOTS Naming Server is detected Specify the SNS host name or IP Address. Specify the SNS TCP/IP port number (or accept the default “19980”) as it was previously configured during SNS installation. When configuring SNMP services to be used by SAA, two approaches can be followed: Configure automatically (default) Answer “y”. No additional action required, the installation program will automatically edit the “/etc/services” file and append it with the required values. This is the most common approach and it’s suited for systems with standalone SPOTS environment. Configure manually Answer “n” no changes will be made. 20 E200301-01-215-V10.0I-04
  23. 23. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. This approach is suited for systems with special configurations. Upon package installation, you shall be instructed to configure the “/etc/services” file. The installation program checks for the usage of NIS/NIS+ groups. If no NIS/NIS+ groups are detected then no action is required; otherwise the following message is displayed: NIS/NIS+ groups detected. Please check if groups ‘pmuser’ and ‘pmadmin’ are defined in NIS/NIS+ before proceeding Press return key to continue The system administrator performing the installation must guarantee that those groups exist before proceeding with installation. The installation program checks for the usage of NIS/NIS+ users. If no NIS/NIS+ users are detected then no action is required; otherwise the following message is displayed: NIS/NIS+ users detected. Please check if user ‘spots’ is defined in NIS/NIS+ before proceeding Press return key to continue The system administrator performing the installation must guarantee that ‘spots’ user exists, according to SPOTS requirements (see Section 4.3), before proceeding with installation by pressing the “return” key. Since SPOTS Application Server software component from SPOTS LT must be installed, the user’s home directory shall be obtained from SPOTS environment. Confirm all polls with “y”. Inspect the output in order to verify that no problems occur during package installation. If you have previously chosen to manually configure the SNMP services, edit the “/etc/services” file according to your particular system needs and SPOTS requirements; otherwise no action is required. The following lines describe the SPOTS default used parameters: snmp 161/udp #saa snmp port snmp-trap 162/udp #saa snmp trap port Package SpotsSAA installed. E200301-01-215-V10.0I-04 21
  24. 24. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 4.4 Configuration issues The configuration procedures described in the next sections must be performed, after installation of the SPOTS RT Software, in order to ensure proper operation of the application. 4.4.1 Configuring SPOTS RT Agency Software (Solaris environment) In this SPOTS version there can be some RT Agents running in the server machine and others running on separate machines, for load distribution. However it is advisable to have all RT Agents running on a separate Windows machine. 4.4.1.1 Configuring real_time.cfg files For each RT Agent Types running on Solaris system, a specific real_time.cfg file must be created and configured. If this file does not exist for a specific RT Agent type the system will assume that the specific RT Agents are running on Windows system. After the SPOTS LT installation the SPOTS_DATA environment variable is defined. For further information refer to Annex 1. Under $SPOTS_DATA/traffic_data/ there is a directory for each agent type according to the following table: Agent types Files directory CS /cyclic ST /sctc HI /hlri Q3 /q3dc SNMP /spr UTRAN /upf BR_OMCB /exp BR_RC /ascii GGSN /ggsn MSP /msp Inside each one of these directories there is a /cfg sub-directory where it could be necessary to create a configuration file named real_time.cfg. The parameters inside this file are used by the loader command to transfer the appropriate agent input files to the right directory. The real_time.cfg file syntax consists in one or more lines with the following format: agency_dir agency_name file_name_filter where: agency_dir The RTA installation directory. In case in the RTA installation the default path was accepted this installation directory is /opt/spots/rt. Otherwise it is the installation 22 E200301-01-215-V10.0I-04
  25. 25. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. path selected by the user. agency_name The agency name defined in the RTC. file_name_filter Logical expression that defines a file name filter for the files to transfer. Only the files whose names satisfy the file name filter expression are transferred by the loader to the agent input running in the agency defined by agency_name. Note: The file name filter shouldn’t contain spaces, and it should be surrounded with quotes. There are several operators that can be used in the file name filter expression: Operator Usage Returns true if ! !op op is false op1op2 op1 and op2 are both true, conditionally evaluates op2 | op1|op2 either op1 or op2 is true, conditionally evaluates op2 Different wildcards are supported: Wildcard Description Symbol * Substitutes zero or more characters. ? Substitutes one character. Follows a real_time.cfg example for the HI Agent Type: /opt/spots/rt Q_Agency_1 'sc*NE_1*' /opt/spots/rt Q_Agency_2 'sc*NE_2*' In this example two agencies (Q_Agency_1 and Q_Agency_2) are used to process HI data files (both agencies must be registered in the RTC). With the file name filters defined, files from different network elements collecting HI data (NE1 and NE2) will be transferred to different agents running in different agencies. In case SPOTS processes only few data types there can be an advantage in split the data processing of the same type amongst different agencies to benefit from the multiprocessing capabilities of the machine used. Below a real_time.cfg example for the CS Agent Type: /opt/spots/rt H_Agency 'CS*' Edit all the real_time.cfg files and insert the parameters according to the appropriate RTA installation directory, the agency names defined in the RTC (refer to E200301-01-215-V10.0I-04 23
  26. 26. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) [3] for details registering Agencies) and the file name filters for the files to transfer for each agent type. 4.4.1.2 Adding Real-Time specific variables to sas.cfg If there is a RT Agency installed in the Solaris environment the sas.cfg file must be configured. These RT specific parameters are only used for the RT Agent types that are running on the Solaris system. In the directory defined by the environment variable SPOTS_DIR (for further information refer to Annex 1.) there is the SAS configuration file: sas.cfg. This file has the syntax exemplified below: # SPOTS Application Server Configuration File [Configuration] NamingServerHost=141.29.139.12 NamingServerPort=19980 TcpPort=19981 DataLoadDir=/var/opt/spots/traffic_data agency_dir=/opt/spots/rt no_periods_transfer=4 no_hours_shift=0 The last three parameters are the ones real-time specific: agency_dir The RTA installation directory. In case in the RTA installation the default path was accepted this installation directory is /opt/spots/rt. Otherwise it is the installation path selected by the user. no_periods_transfer This parameter corresponds to the number of periods that shall be transferred on the current run. If we want to transfer all the files this parameter is 0. If we want to transfer only some periods, we specify here that number of periods. When the SPOTS RT Agent is stopped for some time, there may be a large amount of data files not yet to process when it is restarted again. This parameter provides a way to limit the amount of files to transfer. For example, the data collection process was stopped for 6 hours. In case this parameter has value 0, the files related to the last 24 intervals would be transferred. In case this parameter has value 4 only files related to the last hour will be transferred. no_hours_shift This parameter specifies the number of hours to extend the current time. This should be used whenever processing files that have a time later than the SPOTS current time. This is the 24 E200301-01-215-V10.0I-04
  27. 27. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. case of traffic files originated by NE's located in timezones different from the SPOTS system, where the current time of the NE is later than the current time of SPOTS. In this case the value of this parameter should be at least equal to the time difference between both systems, expressed in hours. Edit the sas.cfg file to specify the RT specific parameters. 4.4.1.3 Modifying the RT Agencies default memory (if desired) The default maximum memory available for each RTAgency is 256MB. If the size of the network is large and the RTAs require more memory to process the data, try changing the max memory value to 512MB and see if it is enough. To do this, edit the file: /opt/spots/rt/james/profiles/service.properties and change the text in bold: # Java Home jdk.home = /opt/spots/rt/jre/bin/java -Xmx512m Make sure that the Spots machine has enough memory. The RTAs work in parallel with all other spots processes! 4.4.2 Configuring the events gateway file The alarms supported by SPOTS RT are generated by the RT Agents. These alarms are sent to the SPOTS Application Server via a UDP port to the SPOTS Event Gateway. In the directory defined by the environment variable SPOTS_DIR (for further information refer to Annex 1.) there is the events gateway configuration file: egw.cfg. This file has the syntax exemplified below: # Events Gateway Configuration File # # Syntax: # DatabaseServerIDName=UDP_PORT_NUMBER # # Ex: E200301-01-215-V10.0I-04 25
  28. 28. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) # DS@spots.siemens.com=10000 DS@cimbalino=10000 Edit the egw.cfg file to specify the database to use to store the alarm’s information. There is one non-commented line (not starting with #), which identifies the database where alarms are stored and the UDP port that the Application Server listens for alarms. The DatabaseServerIDName used has to be the same as the name given to the property “ServerID” on the SDS configuration file “sds.cfg” - see SPOTS Installation Guide ([1]), Annex 4 (Server Configuration Files). If no “ServerID” property is declared on a SDS, the used SDS ID shall be DS@SDS host, where SDS host is the own host name configured on the SDS system (either a simple UnixTM host name, e.g. machineA, or a fully qualified domain name, e.g. machineA.siemens.com). In the example, the database name is identified with DS@cimbalino and the UDP port number is 10000. For the alarms there is no need to configure the UDP port number on the RT Agent. When the user configures one RT Agent its domain is configured and thus internally SPOTS passes the related UDP port information from the egw.cfg file to the RT Agent. 4.4.3 Modifying the RT Agents default granularity (if desired) For each agent, the granularity is fixed at installation time. The default installation procedure installs agents prepared for 15 minutes granularity (core network data) and 60 minutes granularity (radio access network data). For radio access network data (GERAN and UTRAN), the data production granularity can be configured at the NE and thus it may be desirable to change the agent default granularity. This section describes the procedure that allows the user, if desired, to operate an agent type at a different granularity (e.g. change the UTRAN agent type to 15 minutes granularity). However, one agent type shall always operate at one single fixed granularity (the user cannot analyse thresholds at one granularity for some measurements and another granularity for other measurements, within the same agent type). The following steps use the UTRAN agent type as an example (agent_type is UTRAN). An identical procedure may be used for GERAN agent types (in this case agent_type is BR_OMCB or BR_RC). The new granularity will be set to 15 minutes. Stop the agent in RTC GUI Login as SPOTS user Edit the pdc.properties file to specify the desired granularity: This file is located in /opt/spots/rt/Server_rt/Agent/agent_type/properties (assuming the RTS installation path is the default one i.e. /opt/spots/rt). 26 E200301-01-215-V10.0I-04
  29. 29. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. Open the file, search for the occurrence of supported.granularity= and set the value after the = sign to the desired granularity in seconds (e.g. 900). Edit the metadataMapFive.xml file to accept the above-specified granularity: This file is located in /opt/spots/rt/Server_rt/Agent/agent_type/xml (assuming the RTS installation path is the default one i.e. /opt/spots/rt). Open the file, search for all occurrences of spotsMoc granularity=value and, in every occurrence found, replace value by 0 (i.e. the digit zero). Start the agent in RTC GUI 4.4.4 Modifying the RT Bar Chart reports default granularity (if desired) The RT bar-chart reports have the display granularity (time-scope of one bar) hard-coded. The default installation procedure installs bar-charts prepared for 15 minutes granularity (core network data) and 60 minutes granularity (radio access network data). This matches with the default RT agents granularity. Following the procedure to change the granularity of the RT bar-chart reports, in case the user changes the granularity of the associated agent. Modify the report source code (file *.sc) and change in the Request Section the granularity to the desired one. Chose among the available granularities: FIVE_MINUTES, HOURLY or HOUR_QUARTELY. granularity = HOUR_QUARTERLY; These reports have the string the string ‘_BC.sc’ in the name and are stored in /opt/spots/reports/src. E200301-01-215-V10.0I-04 27
  30. 30. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) The relation between Agent Type and RT bar-chart reports is described in the following table: Data type Agent types Bar chart reports GP (min) CS CS ANGRPOC_BC.sc, CELLOC_BC.sc, EXCHOC_BC.sc, LOCAROC_BC.sc 15 ST 15 HI 15 Q3 SSNC 15 PS 15 PS SNMP APNOC_BC.sc, BVCOC_BC.sc, DLCOC_BC.sc, MIB2IFINDEXOC_BC.sc, NSEOC_BC.sc, NSVCOC_BC.sc, RADIUSACCOC_BC.sc, RADIUSAUTHOC_BC.sc, SLOTPORTOC_BC.sc, SPOC_BC.sc, VCLOC_BC.sc, VPLOC_BC.sc, VRINDEXOC_BC.sc, VROC_BC.sc 15 UTRAN UTRAN E1LINEOC_BC.sc, RNCOC_BC.sc, STM1LINEOC_BC.sc, STM1VPOC_BC.sc, UCELLOC_BC.sc 60 Cisco GGSN GGSN 15 MSP MSP 15 GERAN BR_OMCB BSCOC_BC.sc, BTSMOC_BC_sc, 60 BTSOC_BC.sc, TRXOC_BC.sc BR_RC BSCOC_BC.sc, BTSMOC_BC_sc, BTSOC_BC.sc, TRXOC_BC.sc 60 Compile the report source code (In the Reports Editor selecting the option Compile in the Reports menu). This step generates a file with extension ‘.si’ on the same directory of the previous ‘.sc’ file. Publish the report in the SAS that was selected when SCL session was started (selecting the option Add Report to Server in the Reports menu). This step replaces the ‘.sc’ and ‘.si’ files in their respective directories on the SAS, below the report's storage directory. 28 E200301-01-215-V10.0I-04
  31. 31. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. For details using the SPOTS Reports Language please refer to [5], sections 3.4 and 3.5 and for details using the Reports Editor refer to [2], section 4.7. Note: For the RT Time Evolution reports called from the Alarm Browser window the granularity is always 15 minutes. 4.4.5 Connecting SAA to an external Fault Management application The configuration actions described in this section only apply if the SpotsSAA component is installed. In order to forward alarm events to an external Fault Management application (e.g. TeMIP), so that they can be displayed in the corresponding graphical user interface, it is necessary to complete some configuration steps. After SAA installation is completed use spotssnmpadmin application, as described below, to configure the connection between SPOTS SAA and the external Fault Management application. Login as user root. Execute the SPOTS SAA Administration application: #. /etc/saawd.env # spotssnmpadmin The application displays the list of available options, for further information on the SAA Administration application please refer to [3] or choose Help option. SPOTS SNMP Alarm Agent Administration Available options: 1. Configure alarm trap destinations and SNMP protocol version 2. Count all pending alarms 3. Visualize all pending alarms 4. Visualize pending alarms with class ... 5. Visualize pending alarms with instance ... 6. Visualize pending alarms with triggered threshold ... 7. Visualize pending alarms with event time ... 8. Clear all pending alarms 9. Clear pending alarms with class ... 10. Clear pending alarms with instance ... 11. Clear pending alarms with triggered threshold ... 12. Clear pending alarms with event time ... 13. SAA Processes Administration 14. SAA Filtering Administration 15. Help 16. Exit Please select your choice E200301-01-215-V10.0I-04 29
  32. 32. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) Choose Configure alarm trap destinations and SNMP protocol version option: “1” As a result, the following screen is displayed SPOTS SNMP Alarm Agent - Trap Destination Entry Nr.| SNMP Protocol | IP Address ----------------------------------------------- 1 SNMPv2c 127.0.0.1 SPOTS SNMP Management 1. Delete entry 2. Add entry 3. Save and exit 4. Exit without saving Select your option Choose Add entry option: “2” Enter the SNMP protocol version to be used, supported versions are SNMPv1, SNMPv2c and SNMPv3, for example: “SNMPv1” Enter the IP address of the external Fault Management application, for example: “188.102.4.43” If necessary, delete any existing entry that is unwanted. To do it, select the Delete entry option: “1” Enter the number of the entry to be deleted, for example: “1” Inspect the output in order to verify that the configuration parameters are correct. After correct configuration, confirm the inserted data with Save and exit option: “3” Press any key to continue Changes will only take effect in the next SAA startup Back in the main menu, exit from SAA Administration application, choosing the Exit option. SAA connected to the external FM application. 30 E200301-01-215-V10.0I-04
  33. 33. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 4.4.6 Multiple Ethernet Cards on the Same Machine In some cases, the machine acting as a RT Server has multiple Ethernet cards installed, thus has multiple IP numbers for the same machine (if this is not your case, please skip this section). The RT Server component of SPOTS selects one of the available IP numbers for communication with the RT Agencies and the RT Client. However, due to the way that your network is configured, the RT system may not work properly with the selected IP. To overcome this problem you can manually specify which IP number you want RT Server to use. The procedure is the following (assuming the RTS installation path is the default one i.e. /opt/spots/rt): 1. Stop the RT processes according to section 9.2. Look for the directory /opt/spots/rt/Server_rt/James/profiles/Managers of the RT Server machine, and delete all its contents. 2. You must edit the manager.properties file on the /opt/spots/rt/Server_rt/James/profiles directory of your RT Server machine, and add the line: manager.ip = ip_that_rt_should_use 3. You must edit the apm.properties file on the /opt/spots/rt/Server_rt/Apm/properties directory of your RT Server machine, and add the line: java.rmi.server.hostname = rt_server_hostname 4. You must edit the MonitorServer.properties file on the /opt/spots/rt/Server_rt/properties directory of your RT Server machine, and add the line: java.rmi.server.hostname = rt_server_hostname 5. Start the RT processes according to section 4.6. You can, in alternative, restart the RT Server machine. Note: If you have already registered RT Agencies before you made this modifications, please unregister them and delete the contents of the following directory (assuming the RTA installation path is the default one i.e. /opt/spots/rt): /opt/spots/rt/james/profiles/Agencies. Then you need to register the agencies again through the RT Client. E200301-01-215-V10.0I-04 31
  34. 34. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 4.5 SPOTS Real Time Licensing Software The SPOTS Real Time software uses the same licensing mechanism as SPOTS LT, which is dependent on the SAS License Server. Two extra licensing features exist in the license file, one for SPOTS RT and one for SPOTS SAA. Your Siemens representative shall supply you with a valid license file. The license installation is performed as a part of the SPOTS LT installation procedure. For further information, refer to [1], Section Configuring SPOTS licenses. 32 E200301-01-215-V10.0I-04
  35. 35. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 4.6 Starting SPOTS RT Applications Execute the following steps to start the SPOTS RT services: Login as spots user Start all SPOTS RTS daemons: $ /etc/init.d/initServer start Start the SPOTS RTA daemon: $ /etc/init.d/initAgency start The following step must be performed by user root. To do so, issue the command “su –“ and supply the appropriate password. Start the SPOTS SAA watchdog (applicable only on hosts with SAA installed): # /etc/init.d/init.saawd start Exit from root user role by means of the “exit” command. The following procedure can be used to start all the above indicated services with a single command. This procedure also starts all SPOTS Long-Term services (see Section Starting SPOTS in [1]). Login as root user. Give the following command: # /etc/init.d/initSpotsAll start Now it’s possible to start the SPOTS RT Client application. E200301-01-215-V10.0I-04 33
  36. 36. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 5 Installing SPOTS RT Agency Software (Windows environment) To install the SPOTS RT Agency in a Windows environment, insert the supplied CD-ROM in the system’s CD unit. For Windows 2000, you must be logged on as an administrator or a member of the Administrators group in order to perform this installation. During the installation process, it is assumed that the CD-ROM drive letter is “D”. If this is not the case, use the corresponding letter instead. The installation process comprises several steps, which are described in the remainder of this chapter. 34 E200301-01-215-V10.0I-04
  37. 37. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 5.1 Installation sequence Close all other applications before proceeding. If you have some other windows opened, close then all prior to proceed. You can switch to the other opened windows by pressing simultaneously ALT and TAB keys on your keyboard. To start the installation process execute the following steps: Click on the button, located in the lower left corner of your screen. Select Run … option. Execute the SPOTS RTA set-up, typing the following command and then press Ok “D:Setup” The next window will appear: The first step to perform is to read carefully the Real Time Agency Installation Guide (this chapter), which is available by clicking on “RTC/RTA Installation Guide”. The next step is to initiate the SPOTS Real Time Agency installation itself, clicking on “RTA Installation” button. The user performing the installation must have administrator’s privileges. E200301-01-215-V10.0I-04 35
  38. 38. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) The SPOTS RTA splash screen is displayed for a few seconds. Then, the Welcome window is presented over the SPOTS Real Time blue background. In the Welcome window, click on the Next button to proceed, or on the Cancel button to abort the installation process. The EULA – End-User License Agreement window is presented. Read carefully all the supplied information. Click on the Yes button if you accept all the terms contained in the EULA. Otherwise, terminate the installation, clicking on the No button. The Back button allows returning to the previous window. It is available in the following windows. Choose the location where SPOTS RTA shall be installed. It is recommended to install SPOTS RTA in a directory called “SPOTS-Agency” on the root of the boot drive. However, a different destination may be defined. Almost every drive/directory is allowed, except installing on either a removable drive or a network drive. Avoid using space characters in directory names If the selected location does not exist, a confirmation window is displayed, let Setup create the specified location. HOST Name or IP Address, from where the data will be collected, is requested on next window. Write hostname or hostname.domain or IP Address of the platform where the SAS is installed. If a hostname is used, it must correspond to the name defined in the file“/hosts”. Click on the Next button to proceed. SPOTS RT Agency SW is copied to your system. 36 E200301-01-215-V10.0I-04
  39. 39. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. When all installation procedures have been done, a final window is displayed: Click on the Finish button to terminate SPOTS RTA installation. If don’t want to Restart the computer, select No, I will restart my computer later option. 5.2 Configuration issues in the Windows environment The configuration procedures described in the next section must be performed, after installation of the SPOTS RT Agency Software in the Windows environment, in order to ensure proper operation of the application. 5.2.1 RT Agency configuration files During installation process some configuration files are copied to “%SPOTS-AGENCY% FileTransfercfg” directory. The “FileTransfer.cfg” configuration file has general parameter to FileTransfer process. This file is created with default values, but these parameter values can be adjusted to one concrete situation. Only the entries on section [GENERAL_DATA] could be changed: E200301-01-215-V10.0I-04 37
  40. 40. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) Property Type Description Default value Accepted values PDC_DIR String list separated by ‘;’ Host identification or List of directories path that has files to be collected. ftp@host name ftp@hostname or ftp@IP_address Or list of directories MOVE_OR_COPY Character Move(M) or Copy(C) the files M M/C GRANULARITY Number Files granularity 15 5/15 N_PERIOD_WAIT Number Number of period the files must wait to be transferred. 0 If GRANULARITY =15 [0, 672] GRANULARITY=5 [0, 2016] N_PERIOD_TRAN SFERE Number Number periods to transfer 6 [If GRANULARITY =15 [0, 672] GRANULARITY=5 [0, 2016] N_BACKUP_HOU RS Number Number hours to keep the files on Backup. 24 [0,9999] N_PERIOD_WAIT _AGENT Number Number periods to wait for Agent restart 4 [0,9999] TIMEZONE Number Number hours. 0 [0,23] The PDC_DIR parameter is filled during installation process (see Section 5.1). A link between the file names and the Agency/Agent that processes them is made on “AgentDirectories.cfg” file. By default this file is created with agency name = “AGENCY_Agent_type”. If the agency is created with different name from default name, edit the file and change the Agency name to the correct one. Edit the file and comment the lines referred to agent types not used on Windows machine, or delete those lines. To comment the lines use the character “#”. Sample of a “AgentDirectories.cfg” file: # ------------------------------------------------------------- # --- MSP agent # ------------------------------------------------------------- AGENT_DIR=%SPOTS_GENCY%JamesprofilesAgenciesAGENCY_MSPMSPDatainput FILES=MSP_; # ------------------------------------------------------------- # --- GGSN agent # ------------------------------------------------------------- 38 E200301-01-215-V10.0I-04
  41. 41. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. # AGENT_DIR=%SPOTS_AGENCY%JamesprofilesAgenciesAGENCY_GGSNGGSNDatainput # FILES=GGSN_; # ------------------------------------------------------------- # --- SNMP agent # ------------------------------------------------------------- AGENT_DIR=%SPOTS-AGENCY%JamesprofilesAgenciesAGENCY_SNMPSNMPDatainput FILES=SPR_; On this example the Agent Type GGSN are commented, the others are running. The files with “MSP_” suffix are collected to AGENCY_MSP agency and MSP agent type. The files with “SPR_” suffix are collected to AGENCY_SNMP agency and SNMP agent type. The PDCData.cfg configuration file has the list of file names, generated for each SPOTS converter. This file is already configured. The file is read only, so first change permissions to modify it. Edit the file and comment the lines referred to agent types not used/configured on Windows machine, or delete those lines. To comment the lines use the character “#”. On SPOTS Server machine, the file $SPOTS_DATA/traffic_data/cfg/real_time.cfg, can’t exist to the agent types running on Windows system. The default maximum memory available for each RTAgency is 256MB. If the size of the network is large and the RTAs require more memory to process the data, try changing the max memory value to 512MB and see if it is enough. To do this, edit the file: %SPOTS-RTAgency%Jamesprofilesservice.properties and change the text in bold: # Java Home jdk.home = /opt/spots/rt/jre/bin/java -Xmx512m Make sure that the Spots machine has enough memory. The RTAs work in parallel with all other spots processes! E200301-01-215-V10.0I-04 39
  42. 42. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 5.3 Creating user On SPOTS SAS machine a user must be created to allow the WIN RT agents to collect its data. This user must have the following attributes: • Primary group: pmadmin • Login shell: ksh • Home directory: $SPOTS_DATA/traffic_data/rtft’. Windows SPOTS-RT Agency by default is using a user named ‘spotsft’ with equal password, but it could be some other user and/or password. Running next command the user ‘spotsft’ is created supposing that the environment variable $SPOTS_DATA are ‘/var/opt/spots’: # Useradd –g pmadmin –d /var/opt/spots/traffic_data/rtft spotsft Setting the password: #Passwd spotsft #spotsft #spotsft When user or password are different from ‘spotsft’ a file should be created on ‘%SPOTS_AGENCY%/FileTransfer/cfg’ directory named hostname.cfg or ip_address.cfg. In this file, user and password must be written in the same line, separated by spaces or by a Tab. 40 E200301-01-215-V10.0I-04
  43. 43. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 6 Installing SPOTS RTC Software (Windows environment) To install the SPOTS RTC in a Windows environment, insert the supplied CD-ROM in the system’s CD unit. For Windows 2000 or XP, you must be logged on as an administrator or a member of the Administrators group in order to perform this installation. During the installation process, it is assumed that the CD-ROM drive letter is “D”. If this is not the case, use the corresponding letter instead. The installation process comprises several steps, which are described in the remainder of this chapter. E200301-01-215-V10.0I-04 41
  44. 44. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 6.1 Installation sequence Close all other applications before proceeding. If you have some other windows opened, close then all prior to proceed. You can switch to the other opened windows by pressing simultaneously ALT and TAB keys on your keyboard. To start the installation process execute the following steps: Click on the button, located in the lower left corner of your screen. Select Run … option. Execute the SPOTS RTC set-up, typing the following command and then press Ok “D:Setup” The first step to perform is to read carefully the Real Time Client Installation Guide (this chapter), which is available by clicking on “RTC/RTA Installation Guide”. Special attention shall be given to all aspects concerning the installation requirements. The next step is to initiate the SPOTS Real Time Client installation itself, clicking on “RTC Installation” button. The SPOTS RTC splash screen is displayed for a few seconds. Then, the Welcome window is presented over the SPOTS Real Time blue background. In the Welcome window, click on the Next button to proceed, or on the Cancel button to abort the installation process. The EULA – End-User License Agreement window is presented. Read carefully all the supplied information. Click on the Yes button if you accept all the terms contained in the EULA. Otherwise, terminate the installation, clicking on the No button. The Back button allows returning to the previous window. It is available in the following windows. If the user performing the installation has administrator’s privileges, it shall be questioned about the Installation Type. Two types of installation are available: Global all the users have SPOTS RTC available from the SPOTS RTC folder in the Windows Start menu; Personal only the user who installed SPOTS RTC has it available from the SPOTS RTC folder in the Windows Start menu. 42 E200301-01-215-V10.0I-04
  45. 45. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. For installers without administrator’s privileges (applied only to Windows NT — note that, for Windows 2000 or XP, these privileges are required), SPOTS RTC is installed as Personal. For installers with administrator’s privileges, it is suggested to install SPOTS RTC as a Global application. Choose the location where SPOTS RTC shall be installed. It is recommended to install SPOTS RTC in a directory called “SPOTS-RTC” on the root of the boot drive. However, a different destination may be defined. Almost every drive/directory is allowed, except installing on either a removable drive or a network drive. Avoid using space characters in directory names If the selected location does not exist, a confirmation window is displayed, let Setup create the specified location. Select the Program Folder after reading the note below: During SPOTS RTC installation, a folder is added to the StartPrograms menu, containing an icon to start SPOTS RTC. The folder suggested name is SPOTS-RTC, but the icons may also be added to an existing folder, for which the list of existing folders is presented. The Naming Server connection settings window is presented. E200301-01-215-V10.0I-04 43
  46. 46. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) The SPOTS RT Client must be connected to a specific Naming Server. A Use local check box is enabled and checked in target systems where a SPOTS Naming Server is detected, suggesting a connection to it. However, this check box can be unchecked, allowing direct definition of SPOTS Naming Server parameters - Hostname and Domain and TCP/IP Port. If the SPOTS Naming Server is not detected, the check box is disabled (dimmed). When the Use local check box is not checked or disabled, it is mandatory to fill the Naming Server Hostname and Domain (or IP Address) and TCP/IP Port. Provide the settings for connecting to SNS: Fill in the Hostname, which can be up to 15 characters and Domain, which can be up to 20 characters, where dots(“.”) are allowed, except as the first or the last characters or the IP Address of the platform where the SNS is installed. Fill in the Naming Server TCP/IP Port number. To reset the TCP/IP Port to its default value (“19980”) press the Set default port button. The Start button is only enabled when the Use local check box is checked or all required data fields are correctly specified. This is the last user selection prior to file copying. Press the Start button. SPOTS RTC SW is copied to your system. When Setup is completed, click on the Finish button to terminate SPOTS RTC installation. SPOTS RTC installation is completed. To start using SPOTS RTC, select SPOTS Real Time Client from the folder selected before (during Program Folder selection), for instance: 44 E200301-01-215-V10.0I-04
  47. 47. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 6.2 Troubleshooting When SPOTS RTC cannot establish a session with its corresponding SPOTS Naming Server, a window is presented with the following message: Unable to contact naming server. Fatal. In such a situation, it is required to execute the tool spotsPing command from the bin subdirectory of the SPOTS RTC installation. To do so: Open a DOS command prompt window Admitting that SPOTS Real Time Client was installed on c:SPOTS-RTC, type the following command: cd /d c:SPOTS-RTCbin Run the SpotsPing tool, executing the command: SpotsPing NS address [TCP/IP port] where: address is the SNS address, its hostname or the TCP/IP address. TCP/IP port is the SNS TCP/IP port number (optional if SNS has been configured with the default value “19980”). If the SNS is detected, the following message is presented: Server detected!!! Otherwise (SNS is not detected), Unable to contact the server. Close the DOS command window with the Exit command. E200301-01-215-V10.0I-04 45
  48. 48. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 7 SPOTS Real Time License checking During login, SPOTS RTC establishes a connection to a user-defined SAS, for which a valid license must exist. If the license does not exist or is invalid, a message is presented: Cannot Start a Session in the specified Application Server: License not available. In such cases, it is mandatory to obtain a license for the corresponding SAS. The license installation is performed as a part of the SPOTS LT installation procedure. For further information, refer to [1], Section Configuring SPOTS licenses. 46 E200301-01-215-V10.0I-04
  49. 49. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 8 Customisation for Multi-server Environments In multi-server environments, it is commonly required to access from one SPOTS-RT Client to more than one SPOTS-RT Server. The SPOTS-RT Client is connected to a SPOTS-Naming Server that is aware of all the SPOTS-RT Servers. In order to connect the SPOTS-RT Client to a specific SPOTS-RT Server, the Server in question must be specified at login time i.e. upon starting the SPOTS-RT Client. For further information on how to start the SPOTS-RT Client, refer to [3]. E200301-01-215-V10.0I-04 47
  50. 50. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 9 De-installing SPOTS Real Time software (Solaris environment) If it is desired to de-install both the Long-Term and the Real-Time SPOTS parts, refer to [1], Section Uninstalling SPOTS Software (Solaris environment). To remove the SPOTS Real Time SW only, execute the following actions as described in the following sections: 1. Stop SPOTS RT Agencies. 2. Stop SPOTS RT applications. 3. Remove all SPOTS Real Time packages. 9.1 Stop SPOTS RT Agencies Prior to initiate SPOTS-RTA de-installation, it is mandatory that the corresponding RT Agency has been stopped within the RT Administration (from SPOTS-RTClient). If this is ignored, it will be impossible to re-install SPOTS-RTA afterwards. Detailed information concerning agency administration is available in the User Manual for Real Time [3] (Agency Management Tab chapter). 9.2 Stopping SPOTS RT applications Ensure that SPOTS RT applications and all the associated daemons are stopped, by performing the steps here described: Ensure that all SPOTS RT users have exited from all SPOTS RT applications including all SPOTS RT Client sessions. Login as spots user The following step must be performed by user root. To do so, issue the command “su –“ and supply the appropriate password. Stop the SPOTS SAA watchdog (applicable only on hosts with SAA installed): # /etc/init.d/init.saawd stop Exit from root user role by means of the “exit” command. Stop the SPOTS RTA daemon (applicable only on hosts with RTA installed): $ /etc/init.d/initAgency stop This command attempts to stop the SPOTS RT Agency service. It might happen that the service doesn’t stop; in such a case, proceed as follows: Wait a few seconds and then verify if the RTA daemon is stopped, executing the following command: 48 E200301-01-215-V10.0I-04
  51. 51. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. $ ps –ef | grep rtagency If the processes are already stopped, no action is required; otherwise force them to stop, with: $ /etc/init.d/initAgency stop -force Stop all SPOTS RTS daemons: $ /etc/init.d/initServer stop This command attempts to stop all RTS services (monitorserver, apm and manager). It might happen that some of the services don’t stop; in such a case, proceed as follows: Wait a few seconds and then verify if the RTS daemons are stopped, executing the following commands: $ ps –ef | grep rtmonitor $ ps –ef | grep rtapm $ ps –ef | grep rtmanager If the processes are already stopped, no action is required; otherwise force them to stop, with: $ /etc/init.d/initServer stop -force The following procedure can be used to stop all the above indicated services with a single command. This procedure also stops all SPOTS Long-Term services (see Section Stopping SPOTS in [1]). Login as root user. Give the following command: # /etc/init.d/initSpotsAll stop It might happen that some of the Real-Time services don’t stop; in such a case, proceed as follows: Wait a few seconds and then verify if the RTA daemon and the RTS daemons are stopped, executing the following command: $ ps –ef | grep rtagency $ ps –ef | grep rtmonitor $ ps –ef | grep rtapm $ ps –ef | grep rtmanager If the processes are already stopped, no action is required; otherwise force them to stop, with: $ /etc/init.d/initServer stop -force SPOTS RT stopped E200301-01-215-V10.0I-04 49
  52. 52. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 50 E200301-01-215-V10.0I-04
  53. 53. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 9.3 Removing SPOTS Real Time Packages This action, which consists of removing the SPOTS Real Time packages installed in each host, can be accomplished via admintool command (refer to the following section) or via package commands (refer to Section 9.3.2). SPOTS Real Time SW in Solaris comprises the following packages: SpotsRTA, SpotsRTC, SpotsRTS and SpotsSAA. However, in a distributed environment, packages can be spread over multiple hosts; consequently, the procedure described in the next sections shall be repeated for each system hosting SPOTS Real Time components. 9.3.1 Removing SPOTS Real Time Packages with admintool Login as root user. Verify that the DISPLAY environment variable is correctly set. Start admintool: # admintool Choose “Software” from the Admintool “Browse” menu. The Admintool: Software window appears, listing the software currently installed in the system. Select all SPOTS Real Time components, pressing “Ctrl” key and clicking with the mouse pointer in the corresponding entries: “SPOTS RT Agency (SpotsRTA)” “SPOTS RT Client (SpotsRTC)” “SPOTS RT Server (SpotsRTS)” “SPOTS SNMP Alarm Agent (SpotsSAA)” Choose “Delete” from the “Edit” menu. Confirm the deletion of every package selected in the previous step, clicking on the Delete button. A warning message like the one depicted in Figure 2 may appear. If so, ignore it pressing the “Continue” button. To disable it permanently, click on the “Check here to disable this message” checkbox before pressing the “Continue” button. A window appears prompting for information about the de-installation: Confirm all polls with “y”. Inspect the output in order to verify that all package removals are successful. E200301-01-215-V10.0I-04 51
  54. 54. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) Return to the Admintool: Software window, pressing the Return key. Exit admintool selecting “Exit” from the “File” menu. Several files and directories were created during the execution of SpotsRTS and SpotsRTA, independently of the user, which are not removed by the uninstaller, as they were not created during installation. The user who uninstalls SPOTS RT shall also delete these directories: SPOTS RT Server base directory (e.g. /opt/spots/rt/Server_rt/) SPOTS RT Agency base directory (e.g. /opt/spots/rt/james/) to guarantee that the initial situation on the system was restored. SPOTS Real Time software uninstalled. 9.3.2 Removing SPOTS Real Time Packages with Package Commands Login as root user. Identify the installed SPOTS Real Time packages, executing the following shell commands: # pkginfo | grep SpotsRT # pkginfo | grep SpotsSAA According to the installed packages in this host, the output of the commands can be more or less extensive. If all SPOTS Real Time packages are installed, then the following output is given, for each one of the above commands: application SpotsRTA SPOTS RT Agency application SpotsRTC SPOTS RT Client application SpotsRTS SPOTS RT Server application SpotsSAA SPOTS SNMP Alarm Agent Remove the package(s) identified in the previous step, listing it(them) in the pkgrm command. If all packages are installed, the command will be: # /usr/sbin/pkgrm SpotsRTA SpotsRTC SpotsRTS SpotsSAA Confirm all polls with “y”. Inspect the output in order to verify that all package removals are successful Several files and directories were created during the execution of SpotsRTS and SpotsRTA, independently of the user, which are not removed by the uninstaller, as 52 E200301-01-215-V10.0I-04
  55. 55. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. they were not created during installation. The user who uninstalls SPOTS RT shall also delete these directories: SPOTS RT Server base directory (e.g. /opt/spots/rt/Server_rt/) SPOTS RT Agency base directory (e.g. /opt/spots/rt/james/) to guarantee that the initial situation on the system was restored. SPOTS Real Time software uninstalled. E200301-01-215-V10.0I-04 53
  56. 56. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 10 De-installing SPOTS-RT Agency (Windows environment) Very important note: Prior to initiate SPOTS-RTA de-installation, it is mandatory that the corresponding RT Agency has been stopped within the RT Administration (from SPOTS-RTClient). The de-install process is common to almost every product designed for Microsoft Windows environment. To de-install SPOTS-RT Agency, the user must have at least the same privileges as the installer. Follow the instructions given below: Click on the button, located in the lower left corner of your screen. Select SettingsControl Panel option. Double-click on the Add/Remove Programs icon. A window is displayed; containing a list of all products installed whom de-installation process has been tailored for the Microsoft Windows environment. Select the SPOTS-Agency V10.0M product and click on the Change/Remove button. A confirmation window is displayed, to avoid an accidental removal of the product. Confirm SPOTS-Agency removal. During the de-installation of SPOTS-Agency, a window may be presented, preventing to some files and directories not removed during de-installation. At the end a final window is presented where it is only necessary to click on the Finish button. Several files and directories were created during the execution of SpotsRTA, independently of the user, which are not removed by the uninstaller, as they were not created during installation. The user who uninstalls SpotsRTA shall also delete these directories to guarantee that the initial situation on the system was restored. SPOTS-RT Agency software removed. Reference to the SPOTS-Agency software is no longer presented since the list of currently installed products was updated. 54 E200301-01-215-V10.0I-04
  57. 57. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 11 De-installing SPOTS-RTC (Windows environment) The de-install process is common to almost every product designed for Microsoft Windows environment. To de-install SPOTS-RTC, the user must have at least the same privileges as the installer. Follow the instructions given below: Click on the button, located in the lower left corner of your screen. Select SettingsControl Panel option. Double-click on the Add/Remove Programs icon. A window is displayed; containing a list of all products installed whom de-installation process has been tailored for the Microsoft Windows environment. Select the SPOTS-RTC V10.0M product and click on the Add/Remove … or Change/Remove button according to the Microsoft Windows system (NT or 2000/XP) that you’re using. A confirmation window is displayed, to avoid an accidental removal of the product. Confirm SPOTS-RTC removal. During the de-installation of SPOTS RTC, a window may be presented, requesting the user permission to remove an existing file: “Win32Printer.dll” is a shared file installed with that SPOTS-RTC. However it might be used by other applications. In such an event, other applications should have registered themselves as users of that file. Some-times this does not occur, thus every time a shared file is about to be remo-ved a similar message is presented. E200301-01-215-V10.0I-04 55
  58. 58. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) In case of doubt, do not remove the file. Its presence is harmless to the sys-tem, just occupying disk space. Otherwise click on the Yes button to allow removal. At the end a final window is presented where it is only necessary to click on the Finish button. SPOTS-RTC software removed. Reference to the SPOTS-RTC software is no longer presented since the list of currently installed products was updated. 56 E200301-01-215-V10.0I-04
  59. 59. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. 12 Abbreviations APS Application Program System. CDE Common Desktop Environment. FM Fault Management GERAN GSM and EDGE Radio Access Network. GSM Global System for Mobile communications. PDC Performance Data Collector. PM Performance Management. PMC Performance Management – Client Configuration. PMS Performance Management – Server Configuration. SAA SPOTS SNMP Alarm Agent SAS SPOTS Application Server. SDS SPOTS Database Server. SNS SPOTS Naming Server. SPOTS Support for Planning, OperationMaintenance and Traffic Analysis. SSNC Signalling System Network Control. SW Software. RTA SPOTS Real Time Agency RTC SPOTS Real Time Client RTS SPOTS Real Time Server UMTS Universal Mobile Telecommunication System. UTRAN UMTS Terrestrial Radio Access Network. E200301-01-215-V10.0I-04 57
  60. 60. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) 13 References [1] Installation Guide SPOTS V10 Drop 4 (SSA Doc E200301-01-115-V10.0I-*) [2] User Manual SPOTS V10 Drop 4 (SSA Doc E200301-01-114-V10.0I-*) [3] User Manual - Real Time SPOTS V10 Drop 4 (SSA Doc E200301-02-114-V10.0I-*) [4] Release Notes SPOTS V10.0.x (SSA Doc E200301-01-121-V10.0I-*) [5] Reports Processing Language SPOTS V10 Drop 4 (SSA Doc E200301-01-314-V10.0I-*) 58 E200301-01-215-V10.0I-04
  61. 61. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. Annex 1 – UNIX environment variables E200301-01-215-V10.0I-04 59
  62. 62. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) UNIX environment variables LD_LIBRARY_PATH Path to ORACLE and SPOTS libraries. PATH Path for file search. SPOTS_DIR SPOTS base installation directory (default value: /opt/spots). SPOTS_DATA SPOTS base directory for PM data collection from NMSs (default value: /var/opt/spots). TMP SPOTS Directory for temporary files (default value: /tmp). ORACLE_HOME Oracle home directory (default value: /opt/oracle/product/8.1.7). ORACLE_SID Oracle SID for SPOTS database, valid input must be a string of letters and/or digits with a length less than or equal to 4 (default value: spot). TNS_ADMIN Path to Oracle SQL*Net configuration files (value: $ORACLE_HOME/network/spots_ora_admin). SPOTS_SAA_DIR SPOTS Alarm Agent (SAA) base installation directory (default value: /opt/spots). SR_LOG_DIR SAA log directory (value: $SPOTS_SAA_DIR/log). SR_AGT_CONF_DIR SNMP Agent configuration directory (value: $SPOTS_SAA_DIR/config). SR_MGR_CONF_DIR SNMP Manager configuration directory (value: $SPOTS_SAA_DIR/config). All variables, except the SAA related ones, are defined, after SPOTS installation, in the file “/etc/spotsenv”. To display the value of any of these environment variables: Execute the following commands: $ . /etc/spotsenv $ echo $environment_variable_name The value of the environment variable is displayed. The SAA environment variables are defined, after SAA installation, in the file “/etc/saawd.env”. To display the value of any of these environment variables: Execute the following commands: $ . /etc/saawd.env $ echo $environment_variable_name The value of the environment variable is displayed. 60 E200301-01-215-V10.0I-04
  63. 63. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. E200301-01-215-V10.0I-04 61

×