IBM Tivoli Netcool Performance Manager 1.4 Document Revision R2E1. Installing and Using Solution Packs

Transcription

1 IBM Tioli Netcool Performance Manager 1.4 Document Reision R2E1 Installing and Using Solution Packs

2 Note Before using this information and the product it supports, read the information in Notices on page 51. Copyright IBM Corporation US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

3 Contents About this information Intended audience Organization Serice Management Connect Tioli technical training i Support information i Conentions used in this publication i Typeface conentions i Chapter 1. Introduction Architecture Use cases in Solution Pack Chapter 2. Downloading the Solution Pack Components of the Solution Pack Chapter 3. Software requirements and prerequisite software Supported configurations Chapter 4. Special Eents Management 9 Deploying the Special Eent Management dashboard solution Using Tioli Directory Integrator as a data proider Preparing the Tioli Directory Integrator enironment Installing Tioli Directory Integrator Creating Pweb reports on Tioli Netcool Performance Manager Web client Deploying the Dashboard Application Serices Hub data packages on Tioli Directory Integrator 17 Starting the Special Eent Management solution 20 Running the Special Eent Management dashboard reports Deploying the Special Eent Management Cognos solution Getting started with common reporting Running the Special Eent Management Cognos report Chapter 5. 4G and Legacy Networks Interoperability Getting started with common reporting Logging in to the reporting interface Exporting Cognos report packages Importing Cognos report packages Running the 4G and Legacy Networks Interoperability reports Chapter 6. Network QoS Assurance.. 31 Getting started with common reporting Running the Network QoS Assurance reports Filtering criteria for the reports Scheduling and ing an Actie Report Chapter 7. Comprehensie Report Launchpad Deploying solution pack report launchpad on Dashboard Application Serices Hub for Wireline Component Preparing the Tioli Directory Integrator enironment Installing Tioli Directory Integrator Importing Wireline Dashboard Application Serices Hub pages Special Tioli Directory Integrator tables definitions Starting the Report Launchpad solution Running the reports from Report Launchpad.. 42 Report List Configuration Chapter 8. Troubleshooting the solution pack Appendix. Common directory locations for Jazz for Serice Management Notices Copyright IBM Corp iii

4 i Installing and Using Solution Packs

5 About this information Intended audience Organization Solution Packs can be used to monitor a user-defined cluster of network objects from IBM Tioli Netcool Performance Manager for some specific use cases. This document gies step-by-step installation and usage instructions for the Solution Pack This document is intended for: NOC Engineers who want to install and administer data models on a Tioli Netcool Performance Manager system. Radio Optimization Engineers Network Planners Tioli Netcool Performance Manager Users (TNPM Users) Readers must be familiar with the following topics: Tioli Netcool Performance Manager reporting concepts Tioli Netcool Performance Manager Technology Packs Common reporting Jazz for Serice Management components Read this summary information to help you find the information that you need. Chapter 1, Introduction, on page 1 Chapter 2, Downloading the Solution Pack , on page 5 Chapter 3, Software requirements and prerequisite software, on page 7 Chapter 5, 4G and Legacy Networks Interoperability, on page 25 Chapter 6, Network QoS Assurance, on page 31 Chapter 4, Special Eents Management, on page 9 Chapter 7, Comprehensie Report Launchpad, on page 35 Chapter 8, Troubleshooting the solution pack, on page 45 Common directory locations for Jazz for Serice Management, on page 47 Serice Management Connect Connect, learn, and share with Serice Management professionals: product support technical experts who proide their perspecties and expertise. Access Network and Serice Assurance community at deeloperworks/sericemanagement/nsa/index.html. Use Serice Management Connect in the following ways: Become inoled with transparent deelopment, an ongoing, open engagement between other users and IBM deelopers of Tioli products. You can access early designs, sprint demonstrations, product roadmaps, and prerelease code. Connect one-on-one with the experts to collaborate and network about Tioli and the Network and Serice Assurance community. Copyright IBM Corp. 2014

6 Tioli technical training Support information Read blogs to benefit from the expertise and experience of others. Use wikis and forums to collaborate with the broader user community. Related information: Tioli Netcool Performance Manager Wiki on deeloperworks For Tioli technical training information, see the following Tioli Netcool Performance Manager Training website at training. If you hae a problem with your IBM software, you want to resole it quickly. IBM proides the following ways for you to obtain the support you need: Online Access the IBM Software Support site at support/probsub.html. IBM Support Assistant The IBM Support Assistant is a free local software sericeability workbench that helps you resole questions and problems with IBM software products. The Support Assistant proides quick access to support-related information and sericeability tools for problem determination. To install the Support Assistant software, go to support/isa. Troubleshooting Guide For more information about resoling problems, see the problem determination information for this product. Conentions used in this publication Seeral conentions are used in this publication for special terms, actions, commands, and paths that are dependent on your operating system. Typeface conentions This publication uses the following typeface conentions: Bold Italic Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, property sheets), labels (such as Tip:, and Operating system considerations:) Keywords and parameters in text Citations (examples: titles of publications, diskettes, and CDs) Words defined in text (example: a nonswitched line is called a point-to-point line) i Installing and Using Solution Packs

7 Emphasis of words and letters (words as words example: "Use the word that to introduce a restrictie clause."; letters as letters example: "The LUN address must start with the letter L.") New terms in text (except in a definition list): a iew is a frame in a workspace that contains data. Variables and alues you must proide:... where myname represents... Monospace Examples and code examples File names, programming keywords, and other elements that are difficult to distinguish from surrounding text Message text and prompts addressed to the user Text that the user must type Values for arguments or command options Bold monospace Command names, and names of macros and utilities that you can type as commands Enironment ariable names in text Keywords Parameter names in text: API structure parameters, command parameters and arguments, and configuration parameters Process names Registry ariable names in text Script names About this information ii

8 iii Installing and Using Solution Packs

9 Chapter 1. Introduction IBM Tioli Netcool Performance Manager Solution Packs proide an integrated, use case drien solution with improed user experience and dashboard capabilities in managing customer s network infrastructure. Currently, the solution packs are not deliered in the Commercial Off The Shelf (COTS) program with the corresponding technology packs. Architecture Architecture of the solution pack ersion that is released in April Copyright IBM Corp

10 Figure 1. Integration of all use case scenarios in Tioli Netcool Performance Manager Solution Pack : Use cases in Solution Pack Solution Pack contains four use cases that are explained. 2 Installing and Using Solution Packs

11 Solution Pack has the following use cases that are combined into one single package: Table 1. Use cases aailable in Solution Pack S.no. Use Case Description 1 4G and Legacy Networks Interoperability 2 Special Eents Management 3 Network QoS Assurance 4 Comprehensie Report Launch Pad This use case shows how Communications Serice Proiders (CSPs) handle problems of inter-rat handoer failures, in terms of where it is occurring, when it started and which Radio Access Technologies (RAT) is the biggest contributor. This use case helps Communications Serice Proiders (CSPs) to actiely monitor a user-defined cluster of network objects, especially for special eents. This use case helps Network Planner to assess the Network QoS performance trends and identify worst performing cells by iewing the weekly scheduled and interactie Cognos Actie Reports. The insights obtained could be used to improe customer experience by ensuring the network meets data growth and new serices requirements. This use case helps TNPM users with an easier naigation to report of interest through the DASH capability and proides the feature to sae user s faorite reports. Chapter 1. Introduction 3

12 4 Installing and Using Solution Packs

13 Chapter 2. Downloading the Solution Pack Solution Pack is aailable for download on the ISML. Procedure 1. Download the Solution Pack from the IBM Serice Management Library (ISML). You can download the package from: 2. Extract the Solution Pack to a location of your choice to find the contents as described in Components of the Solution Pack Components of the Solution Pack Package name TNPM Solution Pack zip Contents ibm.tnpm.lte.n.2.zip 4G_and_Legacy_Networks_Interoperability.zip Special_Eent_Management.zip This compressed file has these two components: Special_Eent_Management_Cognos.zip Special_Eent_Management_Dash.zip Network_QoS_Assurance.zip Report_Launchpad.zip Copyright IBM Corp

14 6 Installing and Using Solution Packs

15 Chapter 3. Software requirements and prerequisite software Supported configurations Ensure that your system meets the minimum software requirements and that all prerequisite software is installed and configured before starting the installation. Ensure that you hae the following Tioli Netcool Performance Manager configuration with the correct patch leels before you start the installation. Table 2. Supported software components Software Supported ersions Operating system RHEL 5.9, 6.2 Tioli Netcool Performance Manager 1.4 Jazz for Serice Management Tioli Common Reporting Database IBM Cognos Business Intelligence 10.2 Microsoft Office Supported browsers The following browsers are required to support the Web client and proide access to the Solution Pack reports: Browser Versions Internet Explorer Mozilla Firefox ESR ESR Important: Do not use Mozilla Firefox to iew Network QoS Assurance reports. Hardware requirements A minimum of 16 GB serer disk space is required for IBM Cognos Business Intelligence. For more information about Hardware requirements for Wireline Component, see com.ibm.tnpm_1.4_kc.doc/config_recommendations/ ctnpm_configrecguide_minimumrequirementsforinstallation-1-03.dita?cp=ssbnj7_1.4.0%2f Copyright IBM Corp

16 For more information about Hardware requirements for Wireless Component, see com.ibm.tnpm_1.4_kc.doc/wls_deployment/ ctnpm_wls_deployment_operating_system.dita. Other requirements Product Version LTE Vendor Neutral Technology Pack LTE Vendor Neutral Common Pack (ibm.tnpm.lte.n.2.zip) Related information: Jazz for Serice Management IBM Knowledge Center Tioli Netcool Performance Manager IBM Knowledge Center 8 Installing and Using Solution Packs

17 Chapter 4. Special Eents Management This solution helps to monitor special eents, essentially a user-defined cluster of network objects. The Special Eents Management solution contains two of report packages in it. Dashboard reports and Cognos reports Consider the following scenarios on how this solution is helpful: Special Eent in a single location; A rock concert in a stadium Special Eent in multiple locations; An eent conducted across many geographies like a world cup foot ball matched happening in many cities in a country Special festie seasons in some countries where you see a periodic surge in traffic that requires a close monitoring Regular monitoring of routes that are typically used by VIPs in a city where safety could be a concern Target Persona NOC Engineers Radio Optimization Engineers Benefits Actiity monitoring of network hotspots Fine-tuning of configuration parameters Components LTE Vendor Neutral Technology Pack Special Dashboard Application Serices Hub pages that are integrated on Jazz for Serice Management serer Common reporting on Cognos 10 Data integration by using Tioli Directory Integrator on Jazz for Serice Management Deploying the Special Eent Management dashboard solution Deploying the Special Eent Management solution on Dashboard Application Serices Hub for Wireless Component, Before you begin Ensure that you hae the following software installed: Tioli Netcool Performance Manager 1.4 Wireless Component Latest ersion of the Vendor Neutral Common Pack ibm.tnpm.lte.n.2.zip Jazz for Serice Management Extract the report package Special_Eent_Management.zip and also the Special_Eent_Management_Dash.zip files for this solution. Copyright IBM Corp

18 Using Tioli Directory Integrator as a data proider You can populate widgets with data from data sets proided by IBM Tioli Directory Integrator. Tioli Directory Integrator is an integrated deelopment enironment and runtime serice for general-purpose, multi-format, multi-directional, real-time data moement, synchronization and transformation. Dashboard Application Serices Hub can use Tioli Directory Integrator to retriee data from different Tioli and third-party data sources and store the data in data sets. The console then uses the Tioli Directory Integrator data proider to retriee these data sets from the Tioli Directory Integrator serer, and use the data in widgets. The steps to use Tioli Directory Integrator as a data proider are summarized as follows: Install Tioli Directory Integrator, the fix pack, and the JAR files. See Preparing the Tioli Directory Integrator enironment. Create Tioli Directory Integrator data sets. See Reinitialize the Tioli Directory Integrator data proider to pick up new and modified data sets from the Tioli Directory Integrator serer. See Related tasks: Preparing the Tioli Directory Integrator enironment Install Tioli Directory Integrator Fix Pack 2 and oerwrite the OSGI plugins. Preparing the Tioli Directory Integrator enironment Install Tioli Directory Integrator Fix Pack 2 and oerwrite the OSGI plugins. Before you begin For more information about the requirements for Tioli Directory Integrator, see com.ibm.ibmdi.doc_7.1.1/adminguide11.htm?path=8_11_0_4_4_0#wq20 About this task 10 Installing and Using Solution Packs The Tioli Directory Integrator installation media and fix pack are proided with the Jazz for Serice Management installation media. You can install Tioli Directory Integrator on the same serer on which Dashboard Application Serices Hub is installed. Procedure 1. Install Tioli Directory Integrator Version The Tioli Directory Integrator installation media is in the TDI7.1.1 subdirectory of the extracted Jazz for Serice Management installation image on your local file system. 3. Install Tioli Directory Integrator Version Fix Pack 2. For more information about applying the fix pack, see the TIV-TDI-FP0002.README file in the fix pack directory. The Tioli Directory Integrator fix pack is located in the TDI7.1.1FP2 subdirectory of the extracted Jazz for Serice Management installation image on your local file system. 4. Back up the following JAR files in the <TDI_HOME>/osgi/plugins directory.

19 com.ibm.di.api.bind.jar com.ibm.di.api.rest.jar By default, <TDI_HOME> is/opt/ibm/tdi/v Copy the com.ibm.di.api.bind.jar and com.ibm.di.api.rest.jar files from the DASH_Home/installableApps to the TDI_HOME/osgi/plugins directory. 6. Stop the Tioli Directory Integrator serer or the Configuration Editor. Then, start the Tioli Directory Integrator serer by starting the Configuration Editor. For more information, see Introducing IBM Tioli Directory Integrator. Related concepts: Using Tioli Directory Integrator as a data proider on page 10 You can populate widgets with data from data sets proided by IBM Tioli Directory Integrator. Related information: IBM Tioli Directory Integrator, Version Information Center Integrating with Dashboard Application Serices Hub Installing Tioli Directory Integrator The Tioli Directory Integrator installer allows you to install Tioli Directory Integrator in its entirety, only those Tioli Directory Integrator components that you need, upgrade a preious ersion of Tioli Directory Integrator (ersions 6.0, 6.1, 6.1.1, 7.0, or 7.1), or add features to an existing Tioli Directory Integrator installation. About this task Installing Tioli Directory Integrator uninstalls a preious ersion; the uninstallation does not remoe any files that the user has created. User created files are still aailable after the new installation completes. Configuration files such as global.properties and am_config.properties are migrated to Tioli Directory Integrator 7.1.1, keeping any custom configuration changes that hae been made. The Tioli Directory Integrator installation continues to use the features aailable in preious ersions of Tioli Directory Integrator: Administration and Monitoring Console (AMC) Configuration Editor (CE) Examples IBM User Interface Help System built on Eclipse Jaa API Documentation Runtime Serer Procedure 1. Launch the installer directly by using the installation executable file as follows: Linux 64-bit install_tdi711_linux_x86_64.bin 2. Double-click the executable file, or type the executable file name at the command prompt. This launches the installer. The installer is launched. For information on how to use the installer, see Using the platform-specific TDI installer. Related information: Chapter 4. Special Eents Management 11

20 Preparing the Tioli Directory Integrator enironment Creating Pweb reports on Tioli Netcool Performance Manager Web client Reporting page contains a wizard-like interface that steps you through creating a report definition, or report template. After completing the report definition, you can run the report immediately. About this task For more information on the report creation process in Tioli Netcool Performance Manager Web client, see Using Tioli Netcool Performance Manager - Wireless Component. Procedure 1. Log in to Tioli Netcool Performance Manager Web client by using the following URL: 2. Enter the user name and password. 3. Click Reporting > define Report. 4. Specify the report name. For example, DASH_Report. 5. Select the focal entity. Typically, the focal entity represents the entity type that you want to report on. For example, if you want to report on the cells in your network, you would select the cell entity type. For example, select EUtranCell. 6. Select the following fields: The Field Selections section of the report definition allows you to select the performance measurements, or fields, against which you ealuate your wireless network. It is in the Field Selections section that you select the metrics that are of interest to you. EUtranCell.ENodeBFunction_Id (attribute EUtranCell.Neutral.Aailability._%_Cell_aailability EUtranCell.Neutral.EUtranCellTraffic.DL_traffic_olume EUtranCell.Neutral.EUtranCellTraffic.UL_traffic_olume EUtranCell.Neutral.HO_outgoing_inter_RAT._%_IratOutSucc EUtranCell.Neutral.Mobility._%_Success_intra_eRan_out EUtranCell.Neutral.Retainability._%_Call_drop_all_serice 7. Click Extended Functions > Group By > Time Hour to rank top and bottom field alues. 8. Sae the report and exit. 9. Click Reporting > new schedule. Allows you to schedule a report to run at a future date. 10. In the New Schedule page, select the following: Hourly in Frequency to Run to run eery single hour Database Export in Automatic Export of Report Results 11. Sae and exit. Wait for the report to run and create the XP_DASH_DSH2_SCHDLE_RES table. 12 Installing and Using Solution Packs

21 Note: Replace the name XP_DASH_DSH2_SCHDLE_RES by the table name that is generated by Tioli Netcool Performance Manager Web client. What to do next Alternatiely, you can import the report by using report_impexp tool. For more information, see Importing a report by using report_impexp tool. Related concepts: Pweb report table definition When the Pweb report is run for the first time, this table is created with these fields. Related tasks: Importing a report by using report_impexp tool The report_impexp tool proides functionality for importing and exporting report definitions among other things. This procedure is an alternate procedure for importing a report. Pweb report table definition When the Pweb report is run for the first time, this table is created with these fields. TSTAMP EUTRANCELL_ID T_HOUR ENODEBFUNCTION_ID PC_CELL_AVAILABILITY DL_TRAFFIC_VOLUME UL_TRAFFIC_VOLUME PC_IRATOUTSUCC PC_SUCCESS_INTRA_ERAN_OUT PC_CALL_DROP_ALL_SERVICE Related concepts: Pweb report iew definition on page 15 Create the iew from the report table. Related tasks: Creating Pweb reports on Tioli Netcool Performance Manager Web client on page 12 Reporting page contains a wizard-like interface that steps you through creating a report definition, or report template. After completing the report definition, you can run the report immediately. Importing a report by using report_impexp tool The report_impexp tool proides functionality for importing and exporting report definitions among other things. This procedure is an alternate procedure for importing a report. Importing a report by using report_impexp tool The report_impexp tool proides functionality for importing and exporting report definitions among other things. This procedure is an alternate procedure for importing a report. Chapter 4. Special Eents Management 13

22 About this task The report_impexp tool is located in: $WMCROOT/bin. Do not run more than one instance of the tool at any particular time. For more information about this tool, see Administering Tioli Netcool Performance Manager - Wireless Component. Procedure 1. Log in to Tioli Netcool Performance Manager system as user irtuo. 2. Go to <package>/pweb/. 3. Run the following command in a single line: report_impexp -i -u <user_id> -p <password> -f <file dir> -l<serer_directory> -dup <failonerror oerwrite ignore> Where: Option Description -i Initiates the import process. -u <user_id> The username of the user inoking the import tool. -p <password> The user's password. -f <file dir> Name of xml file from which to import user documents. Can be a reference to a file or a folder. If a reference to a folder is gien then a recursie search is carried out for all files with an.xml extension. Each file is then imported. -l <serer_directory> Destination on serer that is the root location for imported documents. This must be a alid user folder location. For example: /Users/sysadm /Users/peter/folder1 /Users/mary/backup/daily If the -l option is not used then the location and associations are taken from the imported document(s). -dup <failonerror oerwrite ignore> Import process behaior. This option is specified with one of the following three parameters: failonerror fail when an existing document with the same name is found oerwrite oerwrite when existing documents with the same names are found ignore ignore documents that already exist For example, report_impexp -i -u sysadm -p Sysadm01 -f DASH_schedule.xml -l /Users/sysadm -dup failonerror 14 Installing and Using Solution Packs

23 . 4. Verify that the import is successful by using the following steps: a. Log in to Tioli Netcool Performance Manager system as user sysadm. b. Click Reporting > manage report. Allows you to open a saed report definition or template. You see DASH in the report listing. c. Click Reporting > manage schedule. You see DASH_schedule in the schedule listing. 5. Change the frequency of the report by using the following steps: a. Log in to Tioli Netcool Performance Manager system as user sysadm. b. Click Reporting > manage schedule. c. Select DASH_schedule and click open schedule. d. Click Automatic Export of Report Results and click Edit. e. Go to Database tab and select Database Export under Export Format. f. Click Apply, and then click sae schedule. Related concepts: Pweb report table definition on page 13 When the Pweb report is run for the first time, this table is created with these fields. Related tasks: Creating Pweb reports on Tioli Netcool Performance Manager Web client on page 12 Reporting page contains a wizard-like interface that steps you through creating a report definition, or report template. After completing the report definition, you can run the report immediately. Pweb report iew definition Create the iew from the report table. Run the following command in a single line to create the iew from the report that was created earlier: CREATE OR REPLACE FORCE VIEW "VIRTUO"."UC2_PWEB_REPORT_V" ("TSTAMP", "EUTRANCELL_ID", "T_HOUR", "ENODEBFUNCTION_ID", "PC_CELL_AVAILABILITY", "DL_TRAFFIC_VOLUME", "UL_TRAFFIC_VOLUME", "PC_IRATOUTSUCC", "PC_SUCCESS_INTRA_ERAN_OUT", "PC_CALL_DROP_ALL_SERVICE") AS SELECT "TSTAMP", "EUTRANCELL_ID", "T_HOUR", "ENODEBFUNCTION_ID", ROUND(NVL("PC_CELL_AVAILABILITY",0),2), "DL_TRAFFIC_VOLUME", "UL_TRAFFIC_VOLUME", ROUND(NVL("PC_IRATOUTSUCC",0),2), ROUND(NVL("PC_SUCCESS_INTRA_ERAN_OUT",0),2), ROUND(NVL("PC_CALL_DROP_ALL_SERVICE",0),2) FROM XP_DASH2_DSH2SCHDL_RES; Note: Replace the name XP_DASH2_DSH2SCHDL_RES by the table name that is generated by Pweb in Creating Pweb reports on Tioli Netcool Performance Manager Web client on page 12. Related concepts: Pweb report table definition on page 13 When the Pweb report is run for the first time, this table is created with these Chapter 4. Special Eents Management 15

24 fields. Creating the index: Create the index t_hour_idx. About this task Use the following command to create the index: CREATE INDEX t_hour_idx ON XP_DASH_DSH_SCHDLE_RES(T_HOUR); CREATE INDEX eutrancell_id_idx ON XP_DASH_DSH_SCHDLE_RES(EUTRANCELL_ID); CREATE INDEX enodebfunction_id_idx ON XP_DASH_DSH_SCHDLE_RES(ENODEBFUNCTION_ID); Note: Replace XP_DASH2_DSH2SCHDL_RES by the table name that is generated by Tioli Netcool Performance Manager Web client from here: 1. Log in to Tioli Netcool Performance Manager Web client from the following URL as smadmin user: 2. Click Reporting > manage schedule. 3. Select DASH_schedule. You can find the table name in External Report pane. Specific tables for Monitoring of Object Cluster for Special Eent Tioli Netcool Performance Manager system database eent table definitions. UC2_EVENTLIST table definition EVENT_ID EVENT_NAME AVENUE END_TSTAMP START_TSTAMP DESCRIPTION UC2_EVENT_CELL_MAP table definition EUTRANCELL_ID EVENT_ID Use the following SQL statement to create the table: CREATE TABLE UC2_EVENTLIST ( EVENT_ID VARCHAR2(50), EVENT_NAME VARCHAR2(100), AVENUE VARCHAR2(100), END_TSTAMP DATE, START_TSTAMP DATE, DESCRIPTION VARCHAR2(2048) ); CREATE TABLE UC2_EVENT_CELL_MAP ( EUTRANCELL_ID VARCHAR2(50), EVENT_ID VARCHAR2(50) ); 16 Installing and Using Solution Packs

25 Deploying the Dashboard Application Serices Hub data packages on Tioli Directory Integrator Procedure 1. Launch Configure the Configuration Editor from Application > IBM Tioli Integrator > Configuration Editor. 2. Use the default workspace directory. The first time you start the Configuration Editor, it prompts you for a workspace directory. The workspace directory is the filesystem location where your projects are stored. You can change this directory later from the File menu. 3. On the welcome screen, click Create Tioli Directory Integrator project link and specify the name of the project as DASH_SPECIAL_EVENTS. 4. Import the <package>/tdi/tdi_conf.xml file into the project. 5. Connect to the wireless component tdb datasource by following these steps: a. Go to project > scripts > database_config. b. For Oracle JDBC connection, specify the following information: JDBC URL jdbc:oracle:thin:@<ip_address>:1521:tdb JDBC Drier oracle.jdbc.drier.oracledrier Username irtuo Password Virtuo01 6. Deploy the configuration to the Tioli Directory Integrator Serer by following these steps: a. Drag and drop the project to Running serer. b. On runtime configuration dialog, click Finish. 7. Copy the ojdbc6.jar file to /opt/ibm/tdi/v7.1.1/jars/3rdparty/others, if database is not installed on the same serer where Tioli Directory Integrator is installed. Tioli Directory Integrator can now connect to the Oracle database. Note: You can find the ojdbc6.jar file from $ORACLE_HOME/jdbc/lib/ ojdbc6.jar. 8. Restart the Configuration Editor. Importing Dashboard Application Serices Hub Pages IBM Dashboard Application Serices Hub allows you to create custom dashboard pages. A page is an arrangement of one or more widgets in the work area of the console. A widget is a user interface component that displays information in a console dashboard. Dashboard Application Serices Hub proides a set of predefined widgets. Each widget is configured to retriee information from a data proider that has a connection defined in Dashboard Application Serices Hub. Each data proider diides its information into data sets. Before you begin For detailed information on predefined widgets, how to edit and customize each widget type, and how to create catalogs and pages with widgets, see the Chapter 4. Special Eents Management 17

26 Dashboard Application Serices Hub online help orjazz for Serice Management Integration Guide. About this task Describes the steps to import the packaged Dashboard Application Serices Hub Pages: Procedure 1. Import the following Dashboard Application Serices Hub data packages by running the consolecli commands: Note: The consolecli commands are entered from the <DASH_HOME>/bin directory. The default <DASH_HOME> is/opt/ibm/jazzsm/ui./consolecli.sh Import --importfile <package>/dash_pages/dash_special_eent_management_folder.zip --username <WAS_admin_user_name> --password <WAS_admin_password> --excludeplugins TCRImportPlugins./consolecli.sh Import --importfile <package>/dash_pages/dash_special_eent_administration.zip --username <WAS_admin_user_name> --password <WAS_admin_password> --excludeplugins TCRImportPlugins./consolecli.sh Import --importfile <package>/dash_pages/dash_special_eent_monitoring_report.zip --username <WAS_admin_user_name> --password <WAS_admin_password> --excludeplugins TCRImportPlugins./consolecli.sh Import --importfile <package>/dash_pages/dash_cell_details.zip --username <WAS_admin_user_name> --password <WAS_admin_password> --excludeplugins TCRImportPlugins./consolecli.sh Import --importfile <package>/dash_pages/dash_radio_capacity_report.zip --username <WAS_admin_user_name> --password <WAS_admin_password> --excludeplugins TCRImportPlugins./consolecli.sh Import --importfile <package>/dash_pages/dash_special_eent_view.zip --username <WAS_admin_user_name> --password <WAS_admin_password> --excludeplugins TCRImportPlugins 2. Extract the custom pages as follows: a. Go to DASH_Profile/installedApps/JazzSMNode01Cell folder. The default location for DASH_Profile is /opt/ibm/jazzsm/profile. b. Extract the packages by using the following command: tar xf <package>/custom_pages/dash_custom_pages.tar Related information: Integrating with Dashboard Application Serices Hub Starting Dashboard Application Serices Hub serices Procedure 1. Start Jazz for Serice Management. 2. Start Tioli Directory Integrator derby database by using these steps: a. Go to /opt/ibm/tdi/v7.1.1/bin. b. Start Tioli Directory Integrator from command line by using startsemserer.sh file. c. Optional: Stop Tioli Directory Integrator from command line by using stopsemserer.sh file. 3. Login to Dashboard Application Serices Hub from the following URL: For more information, see Logging in to the reporting interface on page 25. Related tasks: 18 Installing and Using Solution Packs

27 Starting Jazz for Serice Management application serers You can start any Jazz for Serice Management irtualization and reporting serers by using the IBM WebSphere startserer command. You might need to restart the application serer after you complete a configuration task for an integration serice, or after you take the application serer down for maintenance. Stopping Jazz for Serice Management application serers You can stop any Jazz for Serice Management application serer by using the IBM WebSphere stopserer command. You might need to restart the application serer after completing a configuration task for an integration serice, or stop the application serer for maintenance. To start the serer again, use the startserer command. Starting Jazz for Serice Management application serers: You can start any Jazz for Serice Management irtualization and reporting serers by using the IBM WebSphere startserer command. You might need to restart the application serer after you complete a configuration task for an integration serice, or after you take the application serer down for maintenance. About this task The same procedure applies to any Jazz for Serice Management application serer. Procedure 1. On the releantjazz for Serice Management serer, open a command window. 2. Change to the JazzSM_WAS_Profile/bin directory. The default location for <JazzSM_WAS_Profile> is /opt/ibm/jazzsm/profile. 3. Run the following command:./startserer.sh serer_name Where serer_name Enter the name of the application serer that was specified when the application serer profile was created. For example, serer1. Related tasks: Starting Dashboard Application Serices Hub serices on page 18 Stopping Jazz for Serice Management application serers: You can stop any Jazz for Serice Management application serer by using the IBM WebSphere stopserer command. You might need to restart the application serer after completing a configuration task for an integration serice, or stop the application serer for maintenance. To start the serer again, use the startserer command. Procedure 1. On the releant Jazz for Serice Management serer, open a command window. 2. Change to the JazzSM_WAS_Profile/bin directory. The default location for <JazzSM_WAS_Profile> is /opt/ibm/jazzsm/profile. 3. Run the following command: Chapter 4. Special Eents Management 19

28 ./stopserer.sh <serer_name> -username <WAS_admin_user_name> -password <WAS_admin_password> Where serer_name Enter the name of the application serer that was specified when the application serer profile was created. For example, serer1. WAS_admin_user_name The default user name is smadmin. WAS_admin_password This is the password that is specified at the time of installation. Example stopserer.sh serer1 -username smadmin -password jazzsmpwd Related tasks: Starting Dashboard Application Serices Hub serices on page 18 Starting the Special Eent Management solution Before you begin Copy <package>/scripts/startsemserer.sh and <package>/scripts/ stopsemserer.sh to <TDI_HOME>/bin/ Change the permission of the script by using the following command: Chmod 755 startsemserer.sh stopsemserer.sh Procedure 1. Start the Jazz for Serice Management. See Starting Jazz for Serice Management application serers on page Start Tioli Directory Integrator Derby database by using these steps: a. Go to /opt/ibm/tdi/v7.1.1/bin. b. Start Tioli Directory Integrator by using the following command:./startsemserer.sh 3. Login to Dashboard Application Serices Hub. See Logging in to the reporting interface on page 25 Running the Special Eent Management dashboard reports Viewing the reports from Special Eent Management dashboard. About this task Special Eent Management package has these two reporting packages; Special_Eent_Management_Dash.zip and Special_Eent_Management_Cognos.zip. Special_Eent_Management_Cognos.zip file has a single Radio Capacity Report. For more information on how to open this report, see Running the Special Eent Management Cognos report on page Installing and Using Solution Packs

29 Procedure 1. Log in to Dashboard Application Serices Hub serer where you hae installed the package as admin user that you hae created at the time of installation. See Logging in to the reporting interface on page From the naigation bar, click Special Eent Management > Special Eent Monitoring Report. The Special Eent Management widget opens as shown in the following figure that shows the aailable Special Eents and the Cell Cluster. 3. Click any cell to see the reports. Eery cell has the following set of six reports: Cell Drop Cell Aailability Outgoing Inter-RAT HO Intra LTE HO DL Traffic Volume UL Traffic Volume 4. Right-click a selected cell from an eent to see the Radio Capacity report in Cognos. 5. You can add, edit, or remoe a special eent from the dashboard by following these steps: a. Click Special Eent Management > Special Eent Administration. b. Click Add to add the details of a new eent and enter the alues for the required fields: Option Special Eent Name Location Start Time Stamp End Time Stamp Description Description Name of the eent. For example, Rock Concert Location of the eent. For example, National Stadium, Kuala Lumpur Start time. This entry is for display purpose only and does not affect the report. End time. This entry is for display purpose only and does not affect the report. Description of the eent. For example, Rock Concert to accommodate 10,000 people. Chapter 4. Special Eents Management 21

30 Option Selected EutranCell Description Select the EnodeB and Eutrancell from the Select Cell dialog. c. Click Add. d. Optional: Click Edit to modify the eent details. e. Optional: Click Remoe to remoe an eent from the dashboard. Deploying the Special Eent Management Cognos solution Deploying the Special Eent Management solution on Dashboard Application Serices Hub for Wireless Component for Common Reporting. Before you begin Ensure that you hae the following software installed: Tioli Netcool Performance Manager 1.4 Wireless Component Latest ersion of the Vendor Neutral Common Pack ibm.tnpm.lte.n.2.zip Jazz for Serice Management Extract the report package Special_Eent_Management.zip and also the Special_Eent_Management_Cognos.zip files for this solution. Getting started with common reporting Proides instructions on how to work with reports using IBM Cognos Business Intelligence Reporting. You are guided through the basic reporting tasks, with particular emphasis on techniques that are unique to Performance Management. Before you begin Ensure that you hae installed the latest ersion of the Vendor Neutral Common Pack ibm.tnpm.lte.n.2.zip. About this task This is a simple reference instruction for creating, publishing, importing, and running your reports. Follow these steps to install the reports aailable in the package: Procedure 1. Logging in to the reporting interface on page Exporting Cognos report packages on page Importing Cognos report packages on page Installing and Using Solution Packs

31 Running the Special Eent Management Cognos report Procedure 1. Log in to the Dashboard Application Serices Hub reporting interface. 2. Open the Special Eent Management package in your Public Folders iew. You find the following report: Radio Capacity Report 3. Click on the report and open it in a new tab. 4. Select the required alues from the following fields: Option Network Region Market EutranCell Description Aailable networks that are monitored Aailable regions Aailable markets Aailable EutranCells 5. Click Finish and open the report. Note: Click Allow blocked content in Internet Explorer to iew the report. Chapter 4. Special Eents Management 23

32 24 Installing and Using Solution Packs

33 Chapter 5. 4G and Legacy Networks Interoperability This solution helps to assure customer experience by monitoring the 3G or 4G hand oer performance and seamless inter working with existing 3G or HSPA data network. Target persona NOC Engineers Radio Optimization Engineers Benefits Reduce the cost of managing networks Ensure the transparent user experience across 2G, 3G and 4G LTE Components LTE Vendor Neutral Technology Pack Cognos 10 model for LTE Vendor Neutral Technology Pack Cognos 10 reports Getting started with common reporting Proides instructions on how to work with reports using IBM Cognos Business Intelligence Reporting. You are guided through the basic reporting tasks, with particular emphasis on techniques that are unique to Performance Management. Before you begin Ensure that you hae installed the latest ersion of the Vendor Neutral Common Pack ibm.tnpm.lte.n.2.zip. Extract the report package 4G_and_Legacy_Networks_Interoperability.zip file for this solution. About this task This is a simple reference instruction for creating, publishing, importing, and running your reports. Logging in to the reporting interface Depending upon your organization s deployment of Tioli Common Reporting, you can access the reporting interface directly or through Dashboard Application Serices Hub. About this task With the Common Reporting interface, you can perform simple lightweight tasks as well as more adanced scalable reporting that is proided by IBM Cognos Business Intelligence Reporting. Create on-demand reports. Use the Web-based report authoring. reports Copyright IBM Corp

34 Access the reporting interface: Dashboard Application Serices Hub Log in to the reporting interface from the Dashboard Application Serices Hub login page. Both Dashboard Application Serices Hub and Tioli Common Reporting are installed in the same application sering enironment, and the reporting interface is integrated with Dashboard Application Serices Hub. Access is determined by user roles associated with user IDs. The role that you need to access Tioli Common Reporting is tcrportaloperator. See Authentication and authorization in Tioli Common Reporting. Procedure Access the reporting interface from Dashboard Application Serices Hub as follows: 1. Open a web browser and enter the following URL for the Jazz for Serice Management UI and reporting serer: For example: Where: host.domain is the fully qualified host name or IP address of the Jazz for Serice Management UI and reporting serer. When single sign-on (SSO) is enabled, ensure that you use the fully qualified host name in the URL of the Jazz for Serice Management reporting and UI serer. SSO requires that the browser pass LTPA cookies to the Jazz for Serice Management application serer, and these cookies contain the fully qualified host name. port is the secure HTTP port number that was specified during installation. The default alue is /DASH_context_root is the context root for the console that was specified during installation. The default alue is /ibm/console. 2. On the Dashboard Application Serices Hub login page, enter the user ID and password. Ensure that user ID has access to Tioli Common Reporting. Click Log in. The Dashboard Application Serices Hub Welcome page opens. 3. In the naigation bar, click Reporting > Common Reporting. The Common Reporting portal is displayed within a Dashboard Application Serices Hub portlet page. Access the reporting interface directly as follows: 1. Open a web browser and enter the following URL for the reporting interface: For example: Where: host.domain is the fully qualified host name or IP address of the Jazz for Serice Management reporting serer. Note: When single sign-on (SSO) is enabled, ensure that you use the fully qualified host name in the URL of the Jazz for Serice Management reporting serer. SSO requires that the browser pass LTPA cookies to the Jazz for Serice Management application serer, and these cookies contain the fully qualified host name. 26 Installing and Using Solution Packs

35 port is the non secure HTTP port number that was specified during installation. The default alue is Check with your organization s Jazz for Serice Management administrator if you are unsure of the URL. 2. On the Log on to IBM Cognos Software page, enter the user name and password. Click OK. The Common Reporting portal opens. Related tasks: Exporting Cognos report packages Export your report package to be able to use it for example, on a different Tioli Common Reporting instance. You can use this method for Cognos reports only. Importing Cognos report packages Import report packages to your workspace using the user interface and start using an existing report model and reports. This importing method can be used for Cognos reports only. Exporting Cognos report packages Export your report package to be able to use it for example, on a different Tioli Common Reporting instance. You can use this method for Cognos reports only. Procedure 1. Log in to the releant reporting interface in your enironment. 2. In the reporting interface, select Launch > Administration. 3. In the Configuration tab, select Content Administration in the naigation bar. 4. To export the report package click New Export icon. The New Export wizard opens. 5. Enter the name for the report package and click Next. 6. Accept the default settings and click Next on the subsequent pages. 7. Select Sae and run once, and then click Finish on the last page. The report content is archied. Related tasks: Logging in to the reporting interface on page 25 Depending upon your organization s deployment of Tioli Common Reporting, you can access the reporting interface directly or through Dashboard Application Serices Hub. Importing Cognos report packages Import report packages to your workspace using the user interface and start using an existing report model and reports. This importing method can be used for Cognos reports only. Before you begin Ensure that you hae installed Tioli Netcool Performance Manager 1.4. Ensure that you hae installed the Technology Pack. Download Solution Pack to your local file system. For more information, see Chapter 2, Downloading the Solution Pack , on page 5. Procedure 1. Extract the report package ibm.tnpm.lte.n.2.zip. Chapter 5. 4G and Legacy Networks Interoperability 27

36 2. Copy the reporting package in the Jazz for Serice Management serer in the following location: <c10_location>/deployment. Where, c10_location is the Cognos installation path. By default, /opt/ibm/jazzsm/reporting/cognos. 3. Log in to the releant reporting interface in your enironment. 4. In the reporting interface, select Launch > Administration. 5. In the Configuration tab, select Content Administration in the naigation bar. 6. On the toolbar, click New Import icon. The New Import wizard opens. 7. Select the deployed reporting package, and then click Next. 8. Use the default package name and click Next. 9. Select the check box next to the package that must be deployed and click Next. 10. Accept the default settings and click Next on the subsequent pages. 11. Select Sae and run once, and then click Finish on the last page. By default, the package is deployed to the Public Folders and the reports are aailable in content store. Related tasks: Logging in to the reporting interface on page 25 Depending upon your organization s deployment of Tioli Common Reporting, you can access the reporting interface directly or through Dashboard Application Serices Hub. Running the 4G and Legacy Networks Interoperability reports Viewing the 4G and Legacy Networks Interoperability reports Procedure Note: In a distributed enironment, ensure that timezone is in sync on all the serers. 1. Log in to the Dashboard Application Serices Hub reporting interface. See Logging in to the reporting interface on page Open the 4G Legacy Networks Interoperability package in your Public Folders iew. You find the following reports: Inter eran Handoer Graphical Report Inter eran Handoer Report by Cell Inter eran Handoer Report by RAT Inter eran Handoer Tabular Report 3. Click on the report and open it in a new tab. 4. Select the required alues from the following fields: Option Network Region Market Description Aailable networks that are monitored Aailable regions Aailable markets 5. Click Finish and open the report. 28 Installing and Using Solution Packs

37 Note: Click Allow blocked content in Internet Explorer to iew the report. What to do next You can export a report in HTML, PDF, CSV, Microsoft Excel 2007 formats, and XML. You cannot produce a report in CSV format if you hae more than one query that is defined in the report unless the additional queries are used for prompts. Chapter 5. 4G and Legacy Networks Interoperability 29

38 30 Installing and Using Solution Packs

39 Chapter 6. Network QoS Assurance This solution proides the capability to assess the Network QoS performance trends and identify worst performing cells by iewing the easily scheduled and interactie Cognos Actie Reports. Network Planner can analyze and reiew the QoS performance through the Quality channel indicator (QCI) - based traffic classes on the radio access network by iewing the offline Actie Report (Network QoS Report) scheduled weekly. Network Planner can assess the Network QoS performance and identify worst performing cells by iewing the weekly scheduled offline Actie Report. They can compare the current report with historical report, and easily analyze the performance of access network. You can iew the QoS contribution of the radio network from the worst-contributing resources and worst-trending resources. Target Persona Network Planner NOC Engineer Benefits Improe customer experience by ensuring that the network meets data growth, new serices and applications requirements. Enhance competitie positioning by helping the CSP retain customers, grow reenue through differentiated quality of serice and user experience. Components LTE Vendor Neutral Technology Pack For more information about this Technology Pack, see the Wireless Technology Pack Release Notes on IBM Knowledge Center for Tioli Netcool Performance Manager. Cognos 10 Model on LTE Vendor Neutral Technology Pack These are deliered under IBM COTS program and can also be used as custom extensions by using Tioli Netcool Performance Manager - Application Studio (NPM - AS). NPM - AS is bundled with TNPM 1.4 software. Cognos 10 Actie Reports Actie Report is an extension of the Cognos report that displays important KPIs from business point of iew. It leerages the existing and dashboard reports; conerts them to actie reports by adding interactie behaior, and proides end users with an easy-to-consume interface. Copyright IBM Corp

40 Getting started with common reporting Proides instructions on how to work with reports by using IBM Cognos Business Intelligence Reporting. You are guided through the basic reporting tasks, with particular emphasis on techniques that are unique to Performance Management. Before you begin Ensure that you hae installed the latest ersion of the Vendor Neutral Common Pack ibm.tnpm.lte.n.2.zip. Extract the report package Network_QoS_Assurance.zip file for this solution. About this task This is a simple reference instruction for creating, publishing, importing, and running your reports. Follow these steps to install the reports aailable in the package: Procedure 1. Logging in to the reporting interface on page Exporting Cognos report packages on page Importing Cognos report packages on page 27 Running the Network QoS Assurance reports Viewing the Network QoS Assurance reports. Procedure Note: In a distributed enironment, ensure that timezone is in sync on all the serers. 1. Log in to the Dashboard Application Serices Hub reporting interface. See Logging in to the reporting interface on page Open the Network QoS Assurance package in your Public Folders iew. You find the following reports: Network QoS Assurance Report for EnodeB This report helps the network planner to identify the maximum worst EnodeB in a region. This report empowers the customer to iew and analyze their network behaior of filtered worst behaing EnodeB. This report shows the important performance metrics like IP Throughput, Packet Loss Rate and Latency, which helps to analyze the behaior of the EnodeB and to take a proactie action to proide good user experience. Network QoS Assurance Report for EutranCell This report helps the network planner to identify the maximum worst performing Cells in a region. This report empowers the customer to iew their network behaior for up to 15 filtered worst behaing Cells in a region. This report shows the important performance metrics like IP Throughput, Packet Loss Rate and Latency which help them to analyze the behaior of the Cells and to take a proactie action to proide good user experience. 32 Installing and Using Solution Packs

41 3. Click the Network QoS Assurance Report for EutranCell report and open it in a new tab. Note: It might take sometime to open the report. 4. Select the required alues from the following fields: Option Network Region Market Worst Count Description Aailable networks that are monitored Aailable regions Aailable markets Number of worst performing cells to be monitored; 5, 10 or Click Finish and open the report. Note: Click Allow blocked content in Internet Explorer to iew the report. 6. Optional: Sae the report to your local file system as mhtml file and click OK. 7. You can follow the steps 3 through 6 to run the Network QoS Assurance Report for EnodeB report. 8. You can schedule and the actie reports. See Scheduling and ing an Actie Report on page 34. What to do next The report runs in IBM Cognos Viewer. You can send the Actie Reports to a configured and can be accessed offline with the same dashboard appearance. Filtering criteria for the reports Filtering is based on these parameters; Quality channel indicator (QCI) and traffic direction. QCI QCI traffic classes are used to specify the priorities and performance attributes for different serices offered to the customers. There are nine QCI classes. The details of each QCI class and its representation is as follows: QCI Serice Description 1 Conersational Voice 2 Conersational Video (Lie streaming) 3 Real Time Gaming 4 Non-conersational Video (Buffered streaming) 5 IMS Signalling 6 Buffered Video and TCP-based Serices 7 Voice, Lie Video, Interactie Gaming 8 Buffered Video and TCP-based Serices 9 Buffered Video and TCP-based Serices All Represents the total alue of performance metrics of all the QCI's at a time Traffic direction Chapter 6. Network QoS Assurance 33

42 An uplink is a connection from data communications equipment toward the network core. This is also known as an upstream connection. A downlink is a connection from data communications equipment towards data terminal equipment. This is also known as a downstream connection. Note: There is no Uplink traffic for Highest IP Latency chart. Scheduling and ing an Actie Report Scheduled reports run at specified times and can be automatically sent by to a user or a mailing list or posted to an FTP site. For Network QoS Assurance reports, the scheduling is done weekly. About this task The procedure here explains ing the reports automatically. You can the specific reports manually also. For more information, see ing reports. Procedure Log in to the reporting interface. Select the report that you want to schedule and . For example, select the Network QoS Assurance Report for EutranCell report. On the toolbar, click the Schedule button for the report entry you want to schedule. Under Frequency, select By Week, and then select Day. Under Start, select the last day of the current month as the day you want the monthly schedule to start. Under End, click End by and select the last day of the same month next year as the day you want the weekly schedule to end. Click OK. Click the Use my credentials link to make you the schedule owner. Under Credentials, the name of the current schedule owner appears. Note: If you are logged on as an anonymous user, information about the current schedule owner is not aailable. Under Options, click Oerride the default alues. Select the Send a link to the report by check box and click Edit the options. In the Set the options window, specify the required fields and select the Include a link to the report check box. Click OK. The Actie Report is sent to the recipient's address as an mhtml file to be iewed any time. Related information: Scheduling reports 34 Installing and Using Solution Packs

43 Chapter 7. Comprehensie Report Launchpad This solution proides the new capability for TNPM Users to naigate to a report of their interest from the installed Wireline Technology Packs by using the Dashboard Application Serices Hub feature that is introduced in Tioli Netcool Performance Manager 1.4. You can also add your most used reports to My Faorites on the Dashboard Application Serices Hub UI. Wireline technology packs can be grouped into seen main technologies: Deice Management Serice Management Access/Transmission MPLS Serice/Metro Ethernet SLA and QoS Cable IP Telephony Target Persona TNPM Users Benefits Easy naigation to a particular report of interest with just a few clicks Ability to sae the most used reports to My Faorites for repeated use Components Wireline Technology Packs Currently, the following packs are aailable for integrating into this Comprehensie Report Launchpad Solution: MIB-II Arris DOCSIS 3.0 ALU 5620 SAM Huawei U2000 Special Dashboard Application Serices Hub (DASH) pages that are integrated on Jazz for Serice Management serer Data integration by using Tioli Directory Integrator (TDI) on Jazz for Serice Management Deploying solution pack report launchpad on Dashboard Application Serices Hub for Wireline Component Ensure that you hae installed the following software: Tioli Netcool Performance Manager 1.4 Wireline Component Releant Database. For more information on Tioli Netcool Performance Manager Wireline Component requirements, see Configuration Recommendations. Jazz for Serice Management Wireline technology packs Copyright IBM Corp

44 Preparing the Tioli Directory Integrator enironment Install Tioli Directory Integrator Fix Pack 2 and oerwrite the OSGI plugins. Before you begin For more information about the requirements for Tioli Directory Integrator, see com.ibm.ibmdi.doc_7.1.1/adminguide11.htm?path=8_11_0_4_4_0#wq20 About this task The Tioli Directory Integrator installation media and fix pack are proided with the Jazz for Serice Management installation media. You can install Tioli Directory Integrator on the same serer on which Dashboard Application Serices Hub is installed. Procedure 1. Install Tioli Directory Integrator Version The Tioli Directory Integrator installation media is in the TDI7.1.1 subdirectory of the extracted Jazz for Serice Management installation image on your local file system. 3. Install Tioli Directory Integrator Version Fix Pack 2. For more information about applying the fix pack, see the TIV-TDI-FP0002.README file in the fix pack directory. The Tioli Directory Integrator fix pack is located in the TDI7.1.1FP2 subdirectory of the extracted Jazz for Serice Management installation image on your local file system. 4. Back up the following JAR files in the <TDI_HOME>/osgi/plugins directory. com.ibm.di.api.bind.jar com.ibm.di.api.rest.jar By default, <TDI_HOME> is/opt/ibm/tdi/v Copy the com.ibm.di.api.bind.jar and com.ibm.di.api.rest.jar files from the DASH_Home/installableApps to the TDI_HOME/osgi/plugins directory. 6. Stop the Tioli Directory Integrator serer or the Configuration Editor. Then, start the Tioli Directory Integrator serer by starting the Configuration Editor. For more information, see Introducing IBM Tioli Directory Integrator. Related concepts: Using Tioli Directory Integrator as a data proider on page 10 You can populate widgets with data from data sets proided by IBM Tioli Directory Integrator. Related information: IBM Tioli Directory Integrator, Version Information Center Integrating with Dashboard Application Serices Hub 36 Installing and Using Solution Packs

45 Installing Tioli Directory Integrator The Tioli Directory Integrator installer allows you to install Tioli Directory Integrator in its entirety, only those Tioli Directory Integrator components that you need, upgrade a preious ersion of Tioli Directory Integrator (ersions 6.0, 6.1, 6.1.1, 7.0, or 7.1), or add features to an existing Tioli Directory Integrator installation. About this task Installing Tioli Directory Integrator uninstalls a preious ersion; the uninstallation does not remoe any files that the user has created. User created files are still aailable after the new installation completes. Configuration files such as global.properties and am_config.properties are migrated to Tioli Directory Integrator 7.1.1, keeping any custom configuration changes that hae been made. The Tioli Directory Integrator installation continues to use the features aailable in preious ersions of Tioli Directory Integrator: Administration and Monitoring Console (AMC) Configuration Editor (CE) Examples IBM User Interface Help System built on Eclipse Jaa API Documentation Runtime Serer Procedure 1. Launch the installer directly by using the installation executable file as follows: Linux 64-bit install_tdi711_linux_x86_64.bin 2. Double-click the executable file, or type the executable file name at the command prompt. This launches the installer. The installer is launched. For information on how to use the installer, see Using the platform-specific TDI installer. Related information: Preparing the Tioli Directory Integrator enironment Importing Wireline Dashboard Application Serices Hub pages IBM Dashboard Application Serices Hub allows you to create custom dashboard pages. A page is an arrangement of one or more widgets in the work area of the console. A widget is a user interface component that displays information in a console dashboard. Dashboard Application Serices Hub proides a set of predefined widgets. Each widget is configured to retriee information from a data proider that has a connection defined in Dashboard Application Serices Hub. Each data proider diides its information into data sets. Before you begin For detailed information on predefined widgets, how to edit and customize each widget type, and how to create catalogs and pages with widgets, see the Dashboard Application Serices Hub online help or Jazz for Serice Management Integration Guide. Chapter 7. Comprehensie Report Launchpad 37

46 About this task Describes the steps to import the packaged Dashboard Application Serices Hub pages: Procedure 1. Import the following Dashboard Application Serices Hub data packages by running the consolecli commands: Note: The consolecli commands are entered from the DASH_HOME/bin directory../consolecli.sh Import --importfile <package>/dash_pages/dash_report_folder.zip --username <WAS_admin_user_name> --password <WAS_admin_password> --excludeplugins TCRImportPlugins./consolecli.sh Import --importfile <package>/dash_pages/dash_report_launch_pad.zip --username <WAS_admin_user_name> --password <WAS_admin_password> --excludeplugins TCRImportPlugins./consolecli.sh Import --importfile <package>/dash_pages/ DASH_Report_Category.zip --username <WAS_admin_user_name> --password <WAS_admin_password> --excludeplugins TCRImportPlugins./consolecli.sh Import --importfile <package>/dash_pages/dash_report_page.zip --username <WAS_admin_user_name> --password <WAS_admin_password> --excludeplugins TCRImportPlugins./consolecli.sh Import --importfile <package>/dash_pages/dash_report_launch_administration.zip --username <WAS_admin_user_name> --password <WAS_admin_password> --excludeplugins TCRImportPlugins 2. Extract the imported Dashboard Application Serices Hub data packages as follows: a. Go to DASH_Profile/installedApps/JazzSMNode01Cell folder. The default location for DASH_Profile is /opt/ibm/jazzsm/profile. b. Extract the custom pages by using the following command: tar xf <package>/custom_pages/dash_custom_pages.tar Related information: Integrating with Dashboard Application Serices Hub Special Tioli Directory Integrator tables definitions Special Tioli Directory Integrator tables must be created with these fields. These tables must be created in Derby database. UC4_REPORTLIST table definition CATEGORY_ID SUBCATEGORY_ID REPORT_ID TECHPACK_ID URL Creating and importing tables in Derby database Procedure 1. Create the Derby table by using the following steps: a. Go to the /opt/ibm/tdi/v7.1.1/bin folder and run the following command:./startnetworkserer.sh b. Set the CLASSPATH to the derbyclient.jar:derbytools.jar that is aailable in /opt/ibm/tdi/v7.1.1/jars/3rdparty/ibm by using the following command: 38 Installing and Using Solution Packs

47 export CLASSPATH=derbyclient.jar:derbytools.jar c. Run Derby by using the following command: jaa org.apache.derby.tools.ij d. Connect and create a new database called DASH_REPORT_LAUNCHPAD by using the following command: connect jdbc:derby://<serer.ibm.com>:1527/dash_report_launchpad;create=true ; e. Create UC4_REPORTLIST table by using the SQL command: CREATE TABLE UC4_REPORTLIST ( CATEGORY_ID VARCHAR(100) NOT NULL, SUBCATEGORY_ID VARCHAR(100) NOT NULL, REPORT_ID VARCHAR(100) NOT NULL, TECHPACK_ID VARCHAR(100) NOT NULL, URL VARCHAR(1024) NOT NULL ); 2. Update the table manually from CSV file with the following information: Import the report information based on the selected techpack. 1) ALU_5620_SAM.cs 2) Arris_CMTS_Docsis.cs 3) Huawei_U2000.cs 4) MIB_II.cs CALL SYSCS_UTIL.SYSCS_IMPORT_TABLE(null, UC4_REPORTLIST, <package>/report_list_cofiguration/<selected techpack>.cs,,,null,null,0); Starting Dashboard Application Serices Hub serices Procedure 1. Start Jazz for Serice Management. 2. Start Tioli Directory Integrator derby database by using these steps: a. Go to /opt/ibm/tdi/v7.1.1/bin. b. Start Tioli Directory Integrator from command line by using startsemserer.sh file. c. Optional: Stop Tioli Directory Integrator from command line by using stopsemserer.sh file. 3. Login to Dashboard Application Serices Hub from the following URL: For more information, see Logging in to the reporting interface on page 25. Related tasks: Starting Jazz for Serice Management application serers on page 19 You can start any Jazz for Serice Management irtualization and reporting serers by using the IBM WebSphere startserer command. You might need to restart the application serer after you complete a configuration task for an integration serice, or after you take the application serer down for maintenance. Stopping Jazz for Serice Management application serers on page 19 You can stop any Jazz for Serice Management application serer by using the IBM WebSphere stopserer command. You might need to restart the application serer after completing a configuration task for an integration serice, or stop the application serer for maintenance. To start the serer again, use the startserer command. Starting Jazz for Serice Management application serers: You can start any Jazz for Serice Management irtualization and reporting serers by using the IBM WebSphere startserer command. You might need to restart the Chapter 7. Comprehensie Report Launchpad 39

48 application serer after you complete a configuration task for an integration serice, or after you take the application serer down for maintenance. About this task The same procedure applies to any Jazz for Serice Management application serer. Procedure 1. On the releantjazz for Serice Management serer, open a command window. 2. Change to the JazzSM_WAS_Profile/bin directory. The default location for <JazzSM_WAS_Profile> is /opt/ibm/jazzsm/profile. 3. Run the following command:./startserer.sh serer_name Where serer_name Enter the name of the application serer that was specified when the application serer profile was created. For example, serer1. Related tasks: Starting Dashboard Application Serices Hub serices on page 18 Stopping Jazz for Serice Management application serers: You can stop any Jazz for Serice Management application serer by using the IBM WebSphere stopserer command. You might need to restart the application serer after completing a configuration task for an integration serice, or stop the application serer for maintenance. To start the serer again, use the startserer command. Procedure 1. On the releant Jazz for Serice Management serer, open a command window. 2. Change to the JazzSM_WAS_Profile/bin directory. The default location for <JazzSM_WAS_Profile> is /opt/ibm/jazzsm/profile. 3. Run the following command:./stopserer.sh <serer_name> -username <WAS_admin_user_name> -password <WAS_admin_password> Where serer_name Enter the name of the application serer that was specified when the application serer profile was created. For example, serer1. WAS_admin_user_name The default user name is smadmin. WAS_admin_password This is the password that is specified at the time of installation. 40 Installing and Using Solution Packs

49 Example stopserer.sh serer1 -username smadmin -password jazzsmpwd Related tasks: Starting Dashboard Application Serices Hub serices on page 18 Importing Tioli Directory Integrator configuration About this task For more information about this task, see infocenter/tiihelp/2r1/index.jsp?topic=%2fcom.ibm.ibmdi.doc_7.1.1 %2Fadminguide10.htm&path=7_4_4 Procedure 1. Click IBM Tioli Directory Intergrator > Start Configuration Editor. 2. Specify a workspace in your local file system. 3. Click Create IBM Tioli Directory Integrator Project and create a project by name DASH_REPORT_LAUNCHPAD. 4. Import the file from <package>/tdi_conf.xml into the project. 5. Drag and drop the project to running serer. The Serers panel displays the status of all configured Serers. You can see by the arrow icon next to 'Default.tdiserer' that this Serer has been started for you. This panel also proides buttons for defining new Serers, Starting and Stopping your Serers, as well as for refreshing the list and iew a Serer's log. 6. Click Finish. What to do next Refresh the Dashboard Application Serices Hub and Tioli Directory Integrator connection by using the following steps: 1. Login to Dashboard Application Serices Hub from the following URL: 2. Go to Setting > Connections. 3. Select Tioli Directory Integrator and click Edit. 4. Click the sae button on the Configure TDI connection page. Starting the Report Launchpad solution Before you begin Copy <package>/scripts/startrlpserer.sh and <package>/scripts/ stoprlpserer.sh to <TDI_HOME>/bin/ Change the permission of the script by using the following command: chmod 755 startrlpserer.sh stoprlpserer.sh Procedure 1. Start the Jazz for Serice Management. See Starting Jazz for Serice Management application serers on page Start Tioli Directory Integrator Derby database by using these steps: a. Go to /opt/ibm/tdi/v7.1.1/bin. Chapter 7. Comprehensie Report Launchpad 41

50 b. Start Tioli Directory Integrator by using the following command:./startwlpserer.sh 3. Login to Dashboard Application Serices Hub. See Logging in to the reporting interface on page 25 Running the reports from Report Launchpad Viewing the reports from the Comprehensie Report Launchpad. Procedure 1. Log in to Dashboard Application Serices Hub. See Logging in to the reporting interface on page From the naigation bar, click Report Launchpad > Report Launchpad. TNPM Report Launchpad that contains the report group categories opens as shown in the following figure: 3. Click a report group or technology of your choice. For example, click Deice Management to see the Report Category and the Reports under that category. 4. Click a report from the ReportList to see the report. The legacy DataView reports open in DataView and the Cognos reports open in IBM Cognos Business Intelligence. 5. Add the report to your faorites by following these steps: a. Click Report Launchpad > Report Launchpad Aministration. b. Click a report of your choice from the Aailable Report List and click Refresh. The selected report appears in the Faorite Report pane. Report List Configuration The Report List Configuration proides the mapping between wireline technologies and report content category under which a particular report falls into. Report grouping categorizes the performance measure into a few common areas within a technology, for example packet health and traffic, hardware performance or serice QoS that hae a few reports under them. The Report List Configuration Zip file contains CSV files that lists all the reports aailable out-of-the-box for each category. Currently, the Report List Configuration zip file contains four CSV files with the following mapping information: Wireline technology (Deice Management, Serice/Application Management, QoS, VoIP, Cable, Access and Metro Ethernet) 42 Installing and Using Solution Packs