1. SIEMENS S.A.SPOTS V10 Drop 4Installation Guide - Real TimeNovember/2003E200301-01-215-V10.0I-04

2. SIEMENS S.A.OG IC, R&D WON NM P3R. Irmos Siemens, n 12720-093 AmadoraPortugalAll rights reserved. No part of this document may be reproduced or transmittedin any form or by any means, electronic or mechanical, including photocopyingand recording, for any purpose other than the purchasers personal use withoutthe 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. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.Table of Contents1 INTRODUCTION...........................................................................................................................................31.1 SPOTS Real Time documentation......................................................................................................................41.2 Target group and structure of this manual..........................................................................................................51.2.1 Document Conventions.............................................................................................................................52 GENERAL OVERVIEW..................................................................................................................................62.1 Platform Hardware & Standard Software...........................................................................................................83 INSTALLATION PROCEDURE OVERVIEW.......................................................................................................93.1 Initial Installation ...............................................................................................................................................93.2 APS Upgrade......................................................................................................................................................94 INSTALLING SPOTS REAL TIME SOFTWARE (SOLARIS ENVIRONMENT).................................................104.1 Adding SPOTS Real Time SW with admintool ...............................................................................................114.2 Adding SPOTS Real Time Software with Package Commands .......................................................................144.3 Package Installation .........................................................................................................................................164.3.1 SPOTS RT Server (SpotsRTS) ...............................................................................................................164.3.2 SPOTS RT Agency (SpotsRTA) in Solaris.............................................................................................174.3.3 SPOTS RT Client (SpotsRTC)................................................................................................................184.3.4 SPOTS SNMP Alarm Agent (SpotsSAA)...............................................................................................204.4 Configuration issues.........................................................................................................................................224.4.1 Configuring SPOTS RT Agency Software (Solaris environment) .......................................................224.4.1.1 Configuring real_time.cfg files ......................................................................................................224.4.1.2 Adding Real-Time specific variables to sas.cfg .............................................................................244.4.2 Configuring the events gateway file........................................................................................................254.4.3 Modifying the RT Agencies default memory (if desired)........................................................................254.4.4 Modifying the RT Agents default granularity (if desired).......................................................................264.4.5 Modifying the RT Bar Chart reports default granularity (if desired) ......................................................274.4.6 Connecting SAA to an external Fault Management application .............................................................294.4.7 Multiple Ethernet Cards on the Same Machine.......................................................................................314.5 SPOTS Real Time Licensing Software ............................................................................................................324.6 Starting SPOTS RT Applications.....................................................................................................................335 INSTALLING SPOTS RT AGENCY SOFTWARE (WINDOWS ENVIRONMENT)............................................345.1 Installation sequence ........................................................................................................................................355.2 Configuration issues in the Windows environment..........................................................................................375.2.1 RT Agency configuration files ................................................................................................................375.3 Creating user ....................................................................................................................................................406 INSTALLING SPOTS RTC SOFTWARE (WINDOWS ENVIRONMENT)........................................................416.1 Installation sequence ........................................................................................................................................426.2 Troubleshooting ...............................................................................................................................................457 SPOTS REAL TIME LICENSE CHECKING ...................................................................................................468 CUSTOMISATION FOR MULTI-SERVER ENVIRONMENTS .............................................................................479 DE-INSTALLING SPOTS REAL TIME SOFTWARE (SOLARIS ENVIRONMENT)............................................489.1 Stop SPOTS RT Agencies................................................................................................................................489.2 Stopping SPOTS RT applications ....................................................................................................................489.3 Removing SPOTS Real Time Packages ...........................................................................................................519.3.1 Removing SPOTS Real Time Packages with admintool.........................................................................519.3.2 Removing SPOTS Real Time Packages with Package Commands.........................................................5210 DE-INSTALLING SPOTS-RT AGENCY (WINDOWS ENVIRONMENT) ......................................................5411 DE-INSTALLING SPOTS-RTC (WINDOWS ENVIRONMENT) ..................................................................5512 ABBREVIATIONS .....................................................................................................................................5713 REFERENCES...........................................................................................................................................58ANNEX 1 UNIX ENVIRONMENT VARIABLES .............................................................................................59E200301-01-215-V10.0I-04 i 4. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)ii E200301-01-215-V10.0I-04 5. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.1 IntroductionThe SPOTS product belongs to the family of Network Management Systems providedby 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 standardsoftware) and application software that supports the Performance Management activitieson the Network.The SPOTS V10 application software includes a mandatory Long-Term part and anoptional, 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 Managementindicators based on data periodically collected from the network.The SPOTS V10 Real Time provides near real-time updates of the network performancemanagement information, allowing to define threshold values for PerformanceManagement indicators that result in alarms when they are violated. The optionalmodule SNMP Alarm Agent allows these alarms to be forwarded via SNMP to anexternal application.This document describes the installation procedures for the SPOTS V10 Real-Timeoptional part. These procedures require that the mandatory Long-Term part bepreviously installed. The description of the SPOTS V10 Long-Term installation isprovided in [1].E200301-01-215-V10.0I-04 3 6. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)1.1 SPOTS Real Time documentationThe SPOTS Real Time application documentation consists of the following parts:ManualsDocument 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 NotesSummarizes the authorized versions of the hardware and software products and up-to-dateinformation about user notes, functional limitations and error corrections. TheRelease Notes are applied for a specific release of this SPOTS version (including boththe Long-Term and the Real-Time part).SPOTS V10.0.x Release Notes refer to [4]On-line helpProvides a complete on-context description of the system functionality.4 E200301-01-215-V10.0I-04 7. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.1.2 Target group and structure of this manualThe Real Time Installation Guide is intended for System Administrators and for thosewho install the Real-Time part of the SPOTS product. It describes the necessaryprocedures to perform the initial installation, configuration and de-installation of theSPOTS Real-Time part 1), specific chapters are dedicated to the installation and de-installationof 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 canresult in malfunctioning.1.2.1 Document ConventionsThe following textual and graphic conventions are used in this document:Convention Meaning# The UNIX super-user default prompt.Boldface Emphasises important word or concept.expressionAn expression enclosed within angle brackets indicates somevalue to be input that cannot be determined in beforehand and soit 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. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)2 General OverviewThe SPOTS Real Time (RT) application for Performance Alarm Monitoring comprisesseveral functional components, grouped into installable software packages according toa 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 WindowsNT/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 SPOTSRT distribution (and installation). For the SPOTS LT installation procedure, please referto [1]. The SPOTS LT installation always precedes the SPOTS RT installation. The SPOTS RT Server packages (SpotsRTS, and, if applicable, SpotsSAA) mustbe installed on the same machine(s) where the SpotsAS (SPOTS ApplicationServer) Long-Term part is installed.The SpotsRTA package may be installed on the same machine as the SpotsASor/and on a separate Windows 2000 machine to allow the SPOTS load distributiondetails on these configurations are described in sections 4.3.2 and 5.Thus, depending on the SPOTS Long-Term installation that was performed, theSPOTS Real Time Server components may be installed in two differentconfiguration types: Single Server and Distributed details on theseconfigurations are described in [3], Section 1.2 (Environment).The SPOTS RT Client will be installed on each users workstation implementing theSPOTS Real-Time Graphical User Interface (GUI).The SPOTS RT Client (SpotsRTC) is typically installed on the same machine(s) wherethe 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 onWindows 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. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. Windows 2000, with Service Pack 3 (or higher) Windows XPIt is possible to install the SPOTS RT Client on the same system as the SPOTS RTServer. However, due to performance reasons, intensive usage of RTC in thisconfiguration is not recommended. In a normal operation environment, this SPOTS RTClient configuration is suitable only for sporadic actions (e.g. administrative actions).Complete information about how to install and de-install SPOTS Real Time ispresented, in the current document, from Chapter 4 through Chapter 9.E200301-01-215-V10.0I-04 7 10. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)2.1 Platform HardwareStandard SoftwareHardware Configuration and Standard SoftwareThe SpotsRTS, SpotsRTA and SpotsSAA RT components must be installed on thesame machine as the SPOTS LT Application Server component. This machine isdesignated as a SPOTS PMS (Performance Management Server) machine.Thus, refer to the SPOTS PMS Hardware Configuration in [1], section PlatformHardwareStandard Software.SPOTS RTA (Windows environment)The SpotsRTA can also be installed on a dedicated Windows machine.HardwareThe following minimal configuration is required:Requirement Value CommentProcessor Pentium 4 MandatoryMemory 1 GB MandatoryHard disk space 36 GB MandatoryThe available hard-disk space must be located on a local non-removable drive.Standard SoftwareThe 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 yourSiemens representative, who will help you determine which configuration best fitsyour network.SPOTS Real Time SoftwareThe 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 Timesoftware packages.8 E200301-01-215-V10.0I-04 11. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.3 Installation procedure overviewThis chapter provides an overview of how to carry out the installation of the SPOTSReal Time software from scratch. SPOTS RT software it is an add-on to the SPOTS LT functionality. To operatecorrectly, 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 -i6Two different installation options exist: Initial Installation and APS Upgrade.3.1 Initial InstallationBefore installing SPOTS, one shall collect the necessary information, to serve asreference 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 HardwareThe procedure to install the required hardware components is out of the scope ofthis manual. Refer to the hardware documentation.2. Installing Standard SoftwareRefer to [1], Chapter 4, 5 and 6.3. Installing SPOTS Long Term SoftwareRefer to [1], Chapter 7.4. Installing SPOTS Real Time SoftwareRefer to Chapters 4, 5 and 5 of this document.3.2 APS UpgradeFor information about the SPOTS APS Upgrade procedure refer to [1], Section 3.2.E200301-01-215-V10.0I-04 9 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 AlarmsForwarding 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 Serverand Distributed details on these configurations are described in [2], Section 1.2(Environment).In a Solaris environment, two different methods for performing software administra-tionare supported: Admintool, a graphical front-end to the package commands.For a detailed description about adding or removing SPOTS Real Time softwareusing 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 softwareusing 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 ofthe above methods, perform the configuration actions described in Section 4.4.10 E200301-01-215-V10.0I-04 13. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.4.1 Adding SPOTS Real Time SW with admintoolThe tool admintool offers ease of use, as it is a graphical interface to the pkgadd andpkgrm commands and it includes online help providing general information on using thetool. The user can also benefit from admintool as it offers detailed information about thespecified product, including approximate disk space requirements. Using the admintoolgraphical browser provides a modular view of the contents of the installation medium.These reasons make admintool a preferential tool in software administration, unless youdo not meet the requirements described in the following notice: The admintool software manager requires a bit-mapped display monitor and theability to use the OpenWindows environment. If these requirements are not met,all software-related tasks can alternatively be performed using the package admi-nistrationcommands. 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:# admintoolAdmintool provides online help with general information on using the tool. Use itwhenever necessary, accessing the Help menu or through the context sensitiveHelp button. Select Software from the Admintool Browse menu. The Admintool: Software window is displayed, listing all software currentlyinstalled 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 theSoftware field to select SPOTS REAL TIME 10.0.E200301-01-215-V10.0I-04 11 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 specifythe SPOTS Real Time components to install. To proceed with the installation,execute the following actions: Expand SPOTS RT Performance Alarms Monitoring (RTAlrMon) andSPOTS RT QoS Alarms Forwarding (RTAlrFwd), pressing the triangle-shapedbullet (see Figure 1). The packages in RTAlrMon and RTAlrFwd clusters are displayed. Select/De-select the components to install, clicking on the inner squarebullets. 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 theContinue button. To disable it permanently, set the Check here todisable this message option before pressing Continue.12 E200301-01-215-V10.0I-04 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 theselected 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 doesnt 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 didnt exist, assign a password to it, executing the following shellcommand:# passwd r files spotsThe 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 arenow installed in the local host.Distributed Local installation completed. Log on another platform and repeatthe installation process until all the desired SPOTS RTcomponents are installed in the corresponding platforms. Upon successful installation of the SAA component, configure it according to thedescription in Section 4.4.E200301-01-215-V10.0I-04 13 16. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)4.2 Adding SPOTS Real Time Software with Package CommandsUsing the pkgadd and pkgrm commands offers flexibility. For example, you canincorporate these commands into scripts, set up optional files to avoid user interactionor 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 Timepackages to install in this host:The following packages are available:1 SpotsRTA SPOTS RT Agency(sparc) 10.0.82 SpotsRTC SPOTS RT Client(sparc) 10.0.83 SpotsRTS SPOTS RT Server(sparc) 10.0.84 SpotsSAA SPOTS SNMP Alarm Agent(sparc) 10.0.8Select package(s) you wish to process (or 'all' to processall packages). (default: all) [?,??,q]: Packages may be selected via two different methods: Accepting the default value, all the packages are installed. After this, the menuis 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, installsSpotsSAA and then reprints the menu, waiting for new input, which can be toinstall another package or to quit (q) the pkgadd command.Typically, this method is used when installing a package in a Distributedenvironment. Type in the menu item(s) of the SPOTS Real Time component(s) you wish toinstall in the local host. After confirming your selection, execute thecorresponding installation steps, as described in Section 4.3. After installing all the desired packages just quit the pkgadd tool, entering theoption q:The following packages are available:1 SpotsRTA SPOTS RT Agency(sparc) 10.0.82 SpotsRTC SPOTS RT Client(sparc) 10.0.814 E200301-01-215-V10.0I-04 17. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.3 SpotsRTS SPOTS RT Server(sparc) 10.0.84 SpotsSAA SPOTS SNMP Alarm Agent(sparc) 10.0.8Select package(s) you wish to process (or 'all' to process allpackages). (default: all) [?,??,q]: q If it doesnt 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 didnt exist, assign a password to it, executing the following shellcommand:# passwd r files spotsThe 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 arenow installed in the local host.Distributed Local installation completed. Log on another platform and repeatthe installation process until all the desired SPOTS Real Timecomponents are installed in the corresponding platforms. Upon successful installation of the SAA component, configure it according to thedescription in Section 4.4.E200301-01-215-V10.0I-04 15 18. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)4.3 Package InstallationThe events, warnings and actions detailed below are common to both SW administrationmethods admintool (Section 4.1) and package commands (Section 4.2) and should onlybe executed as part of those procedures. The following sub-sections provide answers tothe 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 installationprocess leaves the creation of the necessary users (spots, ) and groups (pmadminand pmuser) in the hands of the system administrator. However, somerequirements 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 forbase_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 SRTSsoftware component is detected in the local host, then the installation will proceedotherwise it will stop. The SPOTS Application Server software component from SPOTS LT must bealready 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 theSPOTS 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, youll beasked if you want the installation program to create it. Specify the SPOTS LT Database Server (SpotsDS) host name or IP Address. If alocal 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 isdetected the default value shall be obtained from SPOTS environment; otherwisethe default value shall bespot. The installation program checks for the usage of NIS/NIS+ groups. If noNIS/NIS+ groups are detected then no action is required; otherwise the followingmessage is displayed:16 E200301-01-215-V10.0I-04 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 inNIS/NIS+ before proceedingPress return key to continue The system administrator performing the installation must guarantee thatthose 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 isdisplayed:NIS/NIS+ users detected.Please check if user spots is defined in NIS/NIS+ beforeproceedingPress return key to continue The system administrator performing the installation must guarantee thatspots 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 usershome 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 SolarisThe Spots Real-Time Agency package may be installed on the same machine as theSpotsSAS in Solaris as described in this section, or/and it can be installed on one ormore Windows 2000 machine as described in 5, for Spots load distribution.Only one installation of the SpotsRTA package is allowed per system. If no SRTAsoftware 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, youll beasked if you want the installation program to create it. Do NOT choose the same directory as the one chosen for installation of theSPOTS 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. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4) The installation program checks for the usage of NIS/NIS+ groups. If noNIS/NIS+ groups are detected then no action is required; otherwise the followingmessage is displayed:NIS/NIS+ groups detected.Please check if groups pmuser and pmadmin are defined inNIS/NIS+ before proceedingPress return key to continue The system administrator performing the installation must guarantee thatthose 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 isdisplayed:NIS/NIS+ users detected.Please check if user spots is defined in NIS/NIS+ beforeproceedingPress return key to continue The system administrator performing the installation must guarantee thatspots user exists, according to SPOTS requirements (see Section 4.3),before proceeding with installation by pressing the return key. Enter the users home directory or accept the default (recommended). The defaultvalue 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 specifiedduring its installation will be assumed and the installation proceeds to thenext step. Confirm all polls with y. Inspect the output in order to verify that no problems occur during packageinstallation. Package SpotsRTA installed.4.3.3 SPOTS RT Client (SpotsRTC)Only one installation of the SpotsRTC package is allowed per system. If no SRTCsoftware component is detected in the local host, then the installation will proceedotherwise 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. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. Do NOT choose the same directory as the one chosen for installation of theSPOTS 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, youll beasked if you want the installation program to create it.When defining the connection settings between SPOTS RT Client and SPOTS NamingServer, two situations can occur:A local SNS installation is detected Decide if a connection to the local SNS should be established (defaultbehaviour) or not (answer n). Answering n has the same effect as nolocal SNS being detected; so, proceed executing the steps associated withthe 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 itwas previously configured during SNS installation. The installation program checks for the usage of NIS/NIS+ groups. If noNIS/NIS+ groups are detected then no action is required; otherwise the followingmessage is displayed:NIS/NIS+ groups detected.Please check if groups pmuser and pmadmin are defined inNIS/NIS+ before proceedingPress return key to continue The system administrator performing the installation must guarantee thatthose 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 isdisplayed:NIS/NIS+ users detected.Please check if user spots is defined in NIS/NIS+ beforeproceedingPress return key to continue The system administrator performing the installation must guarantee thatspots user exists, according to SPOTS requirements (see Section 4.3),before proceeding with installation by pressing the return key. Enter the users home directory or accept the default (recommended). The defaultvalue 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 specifiedduring its installation will be assumed and the installation proceeds to thenext step.E200301-01-215-V10.0I-04 19 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 packageinstallation. Package SpotsRTC installed.4.3.4 SPOTS SNMP Alarm Agent (SpotsSAA)Only one installation of the SpotsSAA package is allowed per system. If no SAAsoftware component is detected in the local host, then the installation will proceedotherwise it will stop. The SPOTS Application Server software component from SPOTS LT must bealready installed. SPOTS SNMP Alarm Agent software will be installed in the same base installationdirectory as the SPOTS LT Application Server software (this directory is bydefault /opt/spots - see [1], Section 7.3 Package Installation).When defining the connection settings between SPOTS SNMP Alarm Agent and SPOTSNaming Server, two situations can occur:A local SNS installation is detected Decide if a connection to the local SNS should be established (defaultbehaviour) or not (answer n). Answering n has the same effect as nolocal SNS being detected; so, proceed executing the steps associated withthe 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 itwas 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 automaticallyedit the /etc/services file and append it with the required values. This isthe most common approach and its suited for systems with standaloneSPOTS environment.Configure manually Answer n no changes will be made.20 E200301-01-215-V10.0I-04 23. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. This approach is suited for systems with special configurations. Uponpackage installation, you shall be instructed to configure the /etc/servicesfile. The installation program checks for the usage of NIS/NIS+ groups. If noNIS/NIS+ groups are detected then no action is required; otherwise the followingmessage is displayed:NIS/NIS+ groups detected.Please check if groups pmuser and pmadmin are defined inNIS/NIS+ before proceedingPress return key to continue The system administrator performing the installation must guarantee thatthose 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 isdisplayed:NIS/NIS+ users detected.Please check if user spots is defined in NIS/NIS+ beforeproceedingPress return key to continue The system administrator performing the installation must guarantee thatspots 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 beinstalled, the users 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 packageinstallation. If you have previously chosen to manually configure the SNMP services, edit the/etc/services file according to your particular system needs and SPOTSrequirements; otherwise no action is required. The following lines describe the SPOTS default used parameters:snmp 161/udp #saa snmp portsnmp-trap 162/udp #saa snmp trap port Package SpotsSAA installed.E200301-01-215-V10.0I-04 21 24. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)4.4 Configuration issuesThe configuration procedures described in the next sections must be performed, afterinstallation of the SPOTS RT Software, in order to ensure proper operation of theapplication.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 andothers running on separate machines, for load distribution. However it is advisable tohave all RT Agents running on a separate Windows machine.4.4.1.1 Configuring real_time.cfg filesFor each RT Agent Types running on Solaris system, a specific real_time.cfg file mustbe created and configured. If this file does not exist for a specific RT Agent type the system will assume thatthe 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 tothe following table:Agent types Files directoryCS /cyclicST /sctcHI /hlriQ3 /q3dcSNMP /sprUTRAN /upfBR_OMCB /expBR_RC /asciiGGSN /ggsnMSP /mspInside each one of these directories there is a /cfg sub-directory where it could benecessary to create a configuration file named real_time.cfg. The parameters insidethis file are used by the loader command to transfer the appropriate agent input files tothe right directory.The real_time.cfg file syntax consists in one or more lines with the following format:agency_dir agency_name file_name_filterwhere:agency_dir The RTA installation directory.In case in the RTA installation the default path was accepted thisinstallation directory is /opt/spots/rt. Otherwise it is the installation22 E200301-01-215-V10.0I-04 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 totransfer. Only the files whose names satisfy the file name filterexpression are transferred by the loader to the agent input running inthe agency defined by agency_name.Note: The file name filter shouldnt contain spaces, and it shouldbe surrounded with quotes.There are several operators that can be used in the file name filterexpression:Operator Usage Returns true if! !op op is false op1op2 op1 and op2 are both true, conditionallyevaluates op2| op1|op2 either op1 or op2 is true, conditionallyevaluates op2Different wildcards are supported:WildcardDescriptionSymbol* 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 HIdata files (both agencies must be registered in the RTC). With the file name filtersdefined, files from different network elements collecting HI data (NE1 and NE2) will betransferred to different agents running in different agencies.In case SPOTS processes only few data types there can be an advantage in split the dataprocessing of the same type amongst different agencies to benefit from themultiprocessing 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 theappropriate RTA installation directory, the agency names defined in the RTC (refer toE200301-01-215-V10.0I-04 23 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 foreach agent type.4.4.1.2 Adding Real-Time specific variables to sas.cfgIf there is a RT Agency installed in the Solaris environment the sas.cfg file must beconfigured. These RT specific parameters are only used for the RT Agent types that are runningon the Solaris system.In the directory defined by the environment variable SPOTS_DIR (for furtherinformation refer to Annex 1.) there is the SAS configuration file: sas.cfg. This file hasthe syntax exemplified below:# SPOTS Application Server Configuration File[Configuration]NamingServerHost=141.29.139.12NamingServerPort=19980TcpPort=19981DataLoadDir=/var/opt/spots/traffic_dataagency_dir=/opt/spots/rtno_periods_transfer=4no_hours_shift=0The 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 acceptedthis installation directory is /opt/spots/rt. Otherwise it is theinstallation path selected by the user.no_periods_transfer This parameter corresponds to the number of periods that shallbe 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 thatnumber of periods.When the SPOTS RT Agent is stopped for some time, theremay be a large amount of data files not yet to process when it isrestarted again. This parameter provides a way to limit theamount of files to transfer.For example, the data collection process was stopped for 6hours. In case this parameter has value 0, the files related to thelast 24 intervals would be transferred. In case this parameter hasvalue 4 only files related to the last hour will be transferred.no_hours_shift This parameter specifies the number of hours to extend thecurrent time. This should be used whenever processing filesthat have a time later than the SPOTS current time. This is the24 E200301-01-215-V10.0I-04 27. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.case of traffic files originated by NE's located in timezonesdifferent from the SPOTS system, where the current time of theNE is later than the current time of SPOTS. In this case thevalue of this parameter should be at least equal to the timedifference 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 toprocess the data, try changing the max memory value to 512MB and see if itis enough.To do this, edit the file:/opt/spots/rt/james/profiles/service.propertiesand change the text in bold:# Java Homejdk.home = /opt/spots/rt/jre/bin/java -Xmx512mMake 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 fileThe alarms supported by SPOTS RT are generated by the RT Agents. These alarms aresent 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 furtherinformation 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. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)# DS@spots.siemens.com=10000DS@cimbalino=10000 Edit the egw.cfg file to specify the database to use to store the alarms information.There is one non-commented line (not starting with #), which identifies the databasewhere 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 propertyServerID on the SDS configuration file sds.cfg - see SPOTS Installation Guide([1]), Annex 4 (Server Configuration Files). If no ServerID property is declared on aSDS, the used SDS ID shall be DS@SDS host, where SDS host is the ownhost 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 portnumber 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 internallySPOTS 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 installationprocedure installs agents prepared for 15 minutes granularity (core network data) and 60minutes granularity (radio access network data).For radio access network data (GERAN and UTRAN), the data production granularitycan be configured at the NE and thus it may be desirable to change the agent defaultgranularity. This section describes the procedure that allows the user, if desired, tooperate an agent type at a different granularity (e.g. change the UTRAN agent type to 15minutes granularity). However, one agent type shall always operate at one single fixedgranularity (the user cannot analyse thresholds at one granularity for somemeasurements and another granularity for other measurements, within the same agenttype).The following steps use the UTRAN agent type as an example (agent_type isUTRAN). An identical procedure may be used for GERAN agent types (in this caseagent_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. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.Open the file, search for the occurrence of supported.granularity= and set thevalue 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=valueand, in every occurrence found, replace value by 0 (i.e. the digit zero). Start the agent in RTC GUI4.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 minutesgranularity (core network data) and 60 minutes granularity (radio access network data).This matches with the default RT agents granularity. Following the procedure to changethe granularity of the RT bar-chart reports, in case the user changes the granularity of theassociated agent. Modify the report source code (file *.sc) and change in the Request Section thegranularity to the desired one.Chose among the available granularities: FIVE_MINUTES, HOURLY orHOUR_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. 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 followingtable:Data type Agent types Bar chart reports GP (min)CS CS ANGRPOC_BC.sc, CELLOC_BC.sc,EXCHOC_BC.sc, LOCAROC_BC.sc15ST 15HI 15Q3SSNC 15PS15PS 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.sc15UTRAN UTRAN E1LINEOC_BC.sc, RNCOC_BC.sc,STM1LINEOC_BC.sc, STM1VPOC_BC.sc,UCELLOC_BC.sc60CiscoGGSNGGSN 15MSP MSP 15GERAN BR_OMCB BSCOC_BC.sc, BTSMOC_BC_sc,60BTSOC_BC.sc, TRXOC_BC.scBR_RC BSCOC_BC.sc, BTSMOC_BC_sc,BTSOC_BC.sc, TRXOC_BC.sc60 Compile the report source code (In the Reports Editor selecting the optionCompile in the Reports menu). This step generates a file with extension .si on thesame 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 replacesthe .sc and .si files in their respective directories on the SAS, below the report'sstorage directory.28 E200301-01-215-V10.0I-04 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.5and 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 thegranularity 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 SpotsSAAcomponent 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 isnecessary to complete some configuration steps.After SAA installation is completed use spotssnmpadmin application, as describedbelow, to configure the connection between SPOTS SAA and the external FaultManagement 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 onthe SAA Administration application please refer to [3] or choose Help option.SPOTS SNMP Alarm Agent AdministrationAvailable options:1. Configure alarm trap destinations and SNMP protocolversion2. Count all pending alarms3. Visualize all pending alarms4. 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 alarms9. 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 Administration14. SAA Filtering Administration15. Help16. ExitPlease select your choice E200301-01-215-V10.0I-04 29 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 displayedSPOTS SNMP Alarm Agent - Trap DestinationEntry Nr.| SNMP Protocol | IP Address-----------------------------------------------1 SNMPv2c 127.0.0.1SPOTS SNMP Management1. Delete entry2. Add entry3. Save and exit4. Exit without savingSelect your optionChoose Add entry option:2 Enter the SNMP protocol version to be used, supported versions areSNMPv1, SNMPv2c and SNMPv3, for example:SNMPv1 Enter the IP address of the external Fault Management application, forexample:188.102.4.43 If necessary, delete any existing entry that is unwanted. To do it, select the Deleteentry 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:3Press 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 theExit option. SAA connected to the external FM application.30 E200301-01-215-V10.0I-04 33. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.4.4.6 Multiple Ethernet Cards on the Same MachineIn 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 skipthis section).The RT Server component of SPOTS selects one of the available IP numbers forcommunication with the RT Agencies and the RT Client. However, due to the way thatyour 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 RTServer to use.The procedure is the following (assuming the RTS installation path is the default onei.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, anddelete 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 addthe line:manager.ip = ip_that_rt_should_use3. You must edit the apm.properties file on the /opt/spots/rt/Server_rt/Apm/propertiesdirectory of your RT Server machine, and add the line:java.rmi.server.hostname = rt_server_hostname4. You must edit the MonitorServer.properties file on the/opt/spots/rt/Server_rt/properties directory of your RT Server machine, and add theline:java.rmi.server.hostname = rt_server_hostname5. Start the RT processes according to section 4.6. You can, in alternative, restart theRT 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 theRTA 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. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)4.5 SPOTS Real Time Licensing SoftwareThe 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 thelicense 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. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.4.6 Starting SPOTS RT ApplicationsExecute 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 commandsu 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 asingle command. This procedure also starts all SPOTS Long-Term services (see SectionStarting SPOTS in [1]). Login as root user. Give the following command:# /etc/init.d/initSpotsAll start Now its possible to start the SPOTS RT Client application.E200301-01-215-V10.0I-04 33 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-ROMin the systems CD unit. For Windows 2000, you must be logged on as an administrator or a member ofthe Administrators group in order to perform this installation.During the installation process, it is assumed that the CD-ROM drive letter is D. Ifthis is not the case, use the corresponding letter instead.The installation process comprises several steps, which are described in the remainderof this chapter.34 E200301-01-215-V10.0I-04 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 canswitch to the other opened windows by pressing simultaneously ALT and TABkeys 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 pressOkD:SetupThe 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 onRTA Installation button. The user performing the installation must haveadministrators privileges.E200301-01-215-V10.0I-04 35 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 Welcomewindow is presented over the SPOTS Real Time blue background. In the Welcome window, click on the Nextbutton to proceed, or on theCancel 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. TheBack button allows returning to the previous window. It is available inthe following windows. Choose the location where SPOTS RTA shall be installed. It is recommended to install SPOTS RTA in a directory called SPOTS-Agencyon the root of the boot drive. However, a different destination maybe defined. Almost every drive/directory is allowed, except installing oneither a removable drive or a network drive. Avoid using space characters in directory namesIf the selected location does not exist, a confirmation window is displayed, letSetup create the specified location. HOST Name or IP Address, from where the data will be collected, is requested onnext window. Write hostname or hostname.domain or IP Address of the platform wherethe SAS is installed. If a hostname is used, it must correspond to the name defined in thefile/hosts. Click on the Nextbutton to proceed. SPOTS RT Agency SW is copied to your system.36 E200301-01-215-V10.0I-04 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 dont want to Restart the computer, select No, I will restart my computerlater option.5.2 Configuration issues in the Windows environmentThe configuration procedures described in the next section must be performed, afterinstallation of the SPOTS RT Agency Software in the Windows environment, in orderto ensure proper operation of the application.5.2.1 RT Agency configuration filesDuring installation process some configuration files are copied to %SPOTS-AGENCY%FileTransfercfg directory. The FileTransfer.cfg configuration file has general parameter to FileTransferprocess. This file is created with default values, but these parameter values can beadjusted to one concrete situation.Only the entries on section [GENERAL_DATA] could be changed:E200301-01-215-V10.0I-04 37 40. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)Property Type Description DefaultvalueAccepted valuesPDC_DIRString listseparatedby ;Host identification or Listof directories path thathas files to be collected.ftp@hostnameftp@hostname orftp@IP_address Orlist of directoriesMOVE_OR_COPY Character Move(M) or Copy(C) thefiles M M/CGRANULARITY Number Files granularity 15 5/15N_PERIOD_WAIT NumberNumber of period thefiles must wait to betransferred.0If GRANULARITY =15[0, 672]GRANULARITY=5[0, 2016]N_PERIOD_TRANSFERE Number Number periods totransfer 6[If GRANULARITY =15[0, 672]GRANULARITY=5[0, 2016]N_BACKUP_HOURS Number Number hours to keepthe files on Backup. 24 [0,9999]N_PERIOD_WAIT_AGENT Number Number periods to waitfor Agent restart 4 [0,9999]TIMEZONE Number Number hours. 0 [0,23] The PDC_DIR parameter is filled during installation process (see Section5.1). A link between the file names and the Agency/Agent that processes them is madeon AgentDirectories.cfg file. By default this file is created with agency name =AGENCY_Agent_type. If the agency is created with different namefrom default name, edit the file and change the Agency name to the correctone. Edit the file and comment the lines referred to agent types not used onWindows machine, or delete those lines. To comment the lines use thecharacter #.Sample of a AgentDirectories.cfg file:# -------------------------------------------------------------# --- MSP agent# -------------------------------------------------------------AGENT_DIR=%SPOTS_GENCY%JamesprofilesAgenciesAGENCY_MSPMSPDatainputFILES=MSP_;# -------------------------------------------------------------# --- GGSN agent# -------------------------------------------------------------38 E200301-01-215-V10.0I-04 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_SNMPSNMPDatainputFILES=SPR_;On this example the Agent Type GGSN are commented, the others are running. Thefiles with MSP_ suffix are collected to AGENCY_MSP agency and MSP agenttype. The files with SPR_ suffix are collected to AGENCY_SNMP agency andSNMP agent type.The PDCData.cfg configuration file has the list of file names, generated for eachSPOTS converter. This file is already configured. The file is read only, so first change permissions to modify it. Edit the fileand comment the lines referred to agent types not used/configured onWindows machine, or delete those lines. To comment the lines use thecharacter #. On SPOTS Server machine, the file$SPOTS_DATA/traffic_data/cfg/real_time.cfg, cant exist to the agent typesrunning 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 toprocess the data, try changing the max memory value to 512MB and see if itis enough.To do this, edit the file:%SPOTS-RTAgency%Jamesprofilesservice.propertiesand change the text in bold:# Java Homejdk.home = /opt/spots/rt/jre/bin/java -Xmx512mMake 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. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)5.3 Creating userOn SPOTS SAS machine a user must be created to allow the WIN RT agents to collectits 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 equalpassword, but it could be some other user and/or password.Running next command the user spotsft is created supposing that the environmentvariable $SPOTS_DATA are /var/opt/spots:# Useradd g pmadmin d /var/opt/spots/traffic_data/rtft spotsftSetting the password:#Passwd spotsft#spotsft#spotsft When user or password are different from spotsft a file should be createdon %SPOTS_AGENCY%/FileTransfer/cfg directory namedhostname.cfg or ip_address.cfg. In this file, user and password must bewritten in the same line, separated by spaces or by a Tab.40 E200301-01-215-V10.0I-04 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-ROMin the systems CD unit. For Windows 2000 or XP, you must be logged on as an administrator or amember 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. Ifthis is not the case, use the corresponding letter instead.The installation process comprises several steps, which are described in the remainderof this chapter.E200301-01-215-V10.0I-04 41 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 canswitch to the other opened windows by pressing simultaneously ALT and TABkeys 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 pressOkD:SetupThe 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. Specialattention shall be given to all aspects concerning the installation requirements.The next step is to initiate the SPOTS Real Time Client installation itself, clicking onRTC Installation button. The SPOTS RTC splash screen is displayed for a few seconds. Then, the Welcomewindow is presented over the SPOTS Real Time blue background. In the Welcome window, click on the Nextbutton to proceed, or on theCancel 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. TheBack button allows returning to the previous window. It is available inthe following windows. If the user performing the installation has administrators privileges, it shall bequestioned about the Installation Type. Two types of installation are available: Global all the users have SPOTS RTC available from the SPOTS RTC folder inthe Windows Start menu; Personal only the user who installed SPOTS RTC has it available from the SPOTSRTC folder in the Windows Start menu.42 E200301-01-215-V10.0I-04 45. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A. For installers without administrators privileges (applied only to WindowsNT note that, for Windows 2000 or XP, these privileges are required),SPOTS RTC is installed as Personal. For installers with administrators privileges, it is suggested to installSPOTS 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-RTCon the root of the boot drive. However, a different destination may bedefined. Almost every drive/directory is allowed, except installing on eithera removable drive or a network drive. Avoid using space characters in directory namesIf the selected location does not exist, a confirmation window is displayed, letSetup create the specified location. Select the Program Folder after reading the note below: During SPOTS RTC installation, a folder is added to the StartProgramsmenu, containing an icon to start SPOTS RTC. The folder suggested nameis SPOTS-RTC, but the icons may also be added to an existing folder, forwhich the list of existing folders is presented. The Naming Server connection settings window is presented.E200301-01-215-V10.0I-04 43 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 SPOTSNaming Server is detected, suggesting a connection to it. However, this check box canbe 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 theNaming 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, whichcan be up to 20 characters, where dots(.) are allowed, except as the first orthe last characters or the IP Address of the platform where the SNS isinstalled. Fill in the Naming Server TCP/IP Port number. To reset the TCP/IP Port toits default value (19980) press the Set default port button. The Start button is only enabled when the Use local check box is checkedor 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 RTCinstallation. SPOTS RTC installation is completed. To start using SPOTS RTC, select SPOTSReal Time Client from the folder selected before (during Program Folderselection), for instance:44 E200301-01-215-V10.0I-04 47. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.6.2 TroubleshootingWhen SPOTS RTC cannot establish a session with its corresponding SPOTS NamingServer, 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 binsubdirectory 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, typethe following command:cd /d c:SPOTS-RTCbin Run the SpotsPing tool, executing the command:SpotsPing NS address [TCP/IP port]where:addressis the SNS address, its hostname or the TCP/IP address.TCP/IP portis the SNS TCP/IP port number (optional if SNS has been configuredwith 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. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)7 SPOTS Real Time License checkingDuring login, SPOTS RTC establishes a connection to a user-defined SAS, for which avalid 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. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.8 Customisation for Multi-server EnvironmentsIn multi-server environments, it is commonly required to access from one SPOTS-RTClient to more than one SPOTS-RT Server.The SPOTS-RT Client is connected to a SPOTS-Naming Server that is aware of all theSPOTS-RT Servers.In order to connect the SPOTS-RT Client to a specific SPOTS-RT Server, the Server inquestion must be specified at login time i.e. upon starting the SPOTS-RT Client. Forfurther information on how to start the SPOTS-RT Client, refer to [3].E200301-01-215-V10.0I-04 47 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 describedin 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 AgenciesPrior to initiate SPOTS-RTA de-installation, it is mandatory that the correspondingRT 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 UserManual for Real Time [3] (Agency Management Tab chapter).9.2 Stopping SPOTS RT applicationsEnsure that SPOTS RT applications and all the associated daemons are stopped, byperforming the steps here described: Ensure that all SPOTS RT users have exited from all SPOTS RT applicationsincluding all SPOTS RT Client sessions. Login as spots user The following step must be performed by user root. To do so, issue the commandsu 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 mighthappen that the service doesnt stop; in such a case, proceed as follows: Wait a few seconds and then verify if the RTA daemon is stopped, executingthe following command:48 E200301-01-215-V10.0I-04 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 forcethem 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 andmanager). It might happen that some of the services dont stop; in such acase, 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 forcethem to stop, with:$ /etc/init.d/initServer stop -forceThe following procedure can be used to stop all the above indicated services with asingle command. This procedure also stops all SPOTS Long-Term services (see SectionStopping 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 dont stop; in such acase, proceed as follows: Wait a few seconds and then verify if the RTA daemon and the RTSdaemons 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 forcethem to stop, with:$ /etc/init.d/initServer stop -force SPOTS RT stoppedE200301-01-215-V10.0I-04 49 52. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)50 E200301-01-215-V10.0I-04 53. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.9.3 Removing SPOTS Real Time PackagesThis action, which consists of removing the SPOTS Real Time packages installed ineach 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 describedin the next sections shall be repeated for each system hosting SPOTS Real Timecomponents.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:# admintoolChoose Software from the Admintool Browse menu. The Admintool: Software window appears, listing the software currently installedin the system. Select all SPOTS Real Time components, pressing Ctrl key and clicking withthe 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 onthe 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, clickon the Check here to disable this message checkbox before pressingthe 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. 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 andSpotsRTA, independently of the user, which are not removed by the uninstaller, as theywere not created during installation. The user who uninstalls SPOTS RT shall alsodelete 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 shellcommands:# pkginfo | grep SpotsRT# pkginfo | grep SpotsSAA According to the installed packages in this host, the output of the commands canbe more or less extensive. If all SPOTS Real Time packages are installed, then thefollowing output is given, for each one of the above commands:application SpotsRTA SPOTS RT Agencyapplication SpotsRTC SPOTS RT Clientapplication SpotsRTS SPOTS RT Serverapplication SpotsSAA SPOTS SNMP Alarm Agent Remove the package(s) identified in the previous step, listing it(them) in thepkgrm 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 andSpotsRTA, independently of the user, which are not removed by the uninstaller, as52 E200301-01-215-V10.0I-04 55. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.they were not created during installation. The user who uninstalls SPOTS RT shallalso 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. 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 thecorresponding RT Agency has been stopped within the RT Administration(from SPOTS-RTClient).The de-install process is common to almost every product designed for MicrosoftWindows environment. To de-install SPOTS-RT Agency, the user must have at leastthe 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-installationprocess has been tailored for the Microsoft Windows environment. Select the SPOTS-Agency V10.0M product and click on the Change/Removebutton. A confirmation window is displayed, to avoid an accidental removal of theproduct. 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 theFinish 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 werenot created during installation. The user who uninstalls SpotsRTA shall also deletethese directories to guarantee that the initial situation on the system was restored. SPOTS-RT Agency software removed. Reference to the SPOTS-Agency softwareis no longer presented since the list of currently installed products was updated.54 E200301-01-215-V10.0I-04 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 MicrosoftWindows environment. To de-install SPOTS-RTC, the user must have at least thesame 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-installationprocess has been tailored for the Microsoft Windows environment. Select the SPOTS-RTC V10.0M product and click on the Add/Remove orChange/Remove button according to the Microsoft Windows system (NT or2000/XP) that youre using. A confirmation window is displayed, to avoid an accidental removal of theproduct. Confirm SPOTS-RTC removal. During the de-installation of SPOTS RTC, a window may be presented, requestingthe 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, otherapplications should have registered themselves as users of that file. Some-timesthis does not occur, thus every time a shared file is about to be remo-veda similar message is presented.E200301-01-215-V10.0I-04 55 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 allowremoval. At the end a final window is presented where it is only necessary to click on theFinish button. SPOTS-RTC software removed. Reference to the SPOTS-RTC software is nolonger presented since the list of currently installed products was updated.56 E200301-01-215-V10.0I-04 59. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.12 AbbreviationsAPS Application Program System.CDE Common Desktop Environment.FM Fault ManagementGERAN 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 AgentSAS 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 AgencyRTC SPOTS Real Time ClientRTS SPOTS Real Time ServerUMTS Universal Mobile Telecommunication System.UTRAN UMTS Terrestrial Radio Access Network.E200301-01-215-V10.0I-04 57 60. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)13 References[1] Installation GuideSPOTS V10 Drop 4(SSA Doc E200301-01-115-V10.0I-*)[2] User ManualSPOTS V10 Drop 4(SSA Doc E200301-01-114-V10.0I-*)[3] User Manual - Real TimeSPOTS V10 Drop 4(SSA Doc E200301-02-114-V10.0I-*)[4] Release NotesSPOTS V10.0.x(SSA Doc E200301-01-121-V10.0I-*)[5] Reports Processing LanguageSPOTS V10 Drop 4(SSA Doc E200301-01-314-V10.0I-*)58 E200301-01-215-V10.0I-04 61. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.Annex 1 UNIX environment variablesE200301-01-215-V10.0I-04 59 62. Siemens S.A. Installation Guide - Real Time (SPOTS V10 Drop 4)UNIX environment variablesLD_LIBRARY_PATHPath to ORACLE and SPOTS libraries.PATHPath for file search.SPOTS_DIRSPOTS base installation directory (default value: /opt/spots).SPOTS_DATASPOTS base directory for PM data collection from NMSs (default value: /var/opt/spots).TMPSPOTS Directory for temporary files (default value: /tmp).ORACLE_HOMEOracle home directory (default value: /opt/oracle/product/8.1.7).ORACLE_SIDOracle SID for SPOTS database, valid input must be a string of letters and/or digits with a length lessthan or equal to 4 (default value: spot).TNS_ADMINPath to Oracle SQL*Net configuration files (value: $ORACLE_HOME/network/spots_ora_admin).SPOTS_SAA_DIRSPOTS Alarm Agent (SAA) base installation directory (default value: /opt/spots).SR_LOG_DIRSAA log directory (value: $SPOTS_SAA_DIR/log).SR_AGT_CONF_DIRSNMP Agent configuration directory (value: $SPOTS_SAA_DIR/config).SR_MGR_CONF_DIRSNMP Manager configuration directory (value: $SPOTS_SAA_DIR/config).All variables, except the SAA related ones, are defined, after SPOTS installation, in thefile /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. Installation Guide - Real Time (SPOTS V10 Drop 4) Siemens S.A.E200301-01-215-V10.0I-04 61