Test 922: IBM Tivoli Netcool/Webtop V2.0

Section 1 - Planning

1. Given a IBM Tivoli Netcoo/Webtop V1.3.1 (Webtop) deployment is required, define all necessary setting, so that that the Webtop architecture is planned.
   

With emphasis on performing the following steps:

1. Determine Webtopprerequisitesequisites.
2. Determine web browser supportability.
3. Obtain License keys.
4. Identify all data sources.
5. Determine desktop architecture.
6. Determine WAAPI requirements.
7. Determine ObjectServer architecture.
8. Determine location of server.
9. Determine ObjectServer details.
10. Determine security settings.


2. Given a list of users and security requirements, define users and groups for Webtop deployment, so that User details and groups are defined.
   

With emphasis on performing the following steps:

1. Define users.
2. Determine roles. (Read only, Read/Write, Admin)
3. Define groups.


3. Given a customer requires Webtop to be deployed, define all GUI elements necessary to address the customers' requirements, so that the dashboard requirements are defined.
   

With emphasis on performing the following steps:

1. Determine user filters.
2. Determine user views.
3. Define entities.
4. Define views.
5. Dcustomer custoemr dashboard requirements.
6. Determine chart requirements.
7. Define maps.
8. Define resources.
9. Define pages.
10. Define workflows.
11. Define tools.
12. Define menus.

Section 2 - Installing

1. Given a license server is installed, setup Webtop licensing, so that Webtop license keys are available.

With emphasis on performing the following steps:

1. Obtain license files from IBM download software site.
   
2. Place file in /etc.
3. Read new license keys by: (UNIX) running /bin>nc_read_license, (Windows) using Imtools.
4. Verify Webtop keys using: (UNIX) /bin/nc_print_license, (Windows) Imtools.


2. Given Webtop software is available and the license and ObjectServer details, install Webtop, so that Webtop software is installed.
   

With emphasis on performing the following steps:

1. Read installation instructions in ReadMe file.
2. On UNIX run install_webtop. On Windows run setup.exe to start the Webtop installation.
3. Review license agreement.
4. Specify Webtop installation location and click next.
5. Specify license server and port. Select next.
6. Enter Object Server details: host, port, ObjectServer name, user name, and password. Select next.
7. Select Complete or Custom installation.
8. For Custom install select components: Webtop server, WAAPI, licensing. Select next.
9. Install software.


3. Given the Tivoli Netcool/GUI Foundation is installed, licensed, configured, start the NGF server and verify operational status, so that NGF is determined to be operational.
   

With emphasis on performing the following steps:

1. Start the NGF server by running NCHOME/bin/ngf_server start on UNIX or using the Windows Services GUI.
2. Start web browser and go to http://:.
3. Login as Webtop user with administrator rights.
4. Check Webtop demo pages by selecting the Webtop Desktop from the --Pages-- drop down box.
5. Check Webtop admin pages are available by selecting the Webtop Administration from the --Pages-- drop down box.
6. Logout of the NGF server.
7. Check WAAPI is working by running lt;NCHOMEgt;/webtop/bin/webtop_osresync.

Section 3 - Configuring

1. Given WAPPI is installed, make changes to the WAPPI configuration as defined in the statement of work, so that the WAPPI configuration is updated.
   

With emphasis on performing the following steps:

1. Open WAAPI configuration file /waapi/waapi.init in a text editor.
2. Modify property waapi.port to a different value.
3. Modify property waapi.host to a different value.
4. Modify user and password details in waapi.init (waapi.user, waapi.password).
5. Modify SSL connection details in waapi.init (waapi.secureport, waapi.ssl).


2. Given the ObjectServer connection details, modify the Webtop configuration, so that the datasources are updated.
   

With emphasis on performing the following steps:

1. Stop Webtop server using
2. Open datasources definition file (/config/datasources/newdatasources_definitions.xml) in a text editor.
3. Change default ObjectServer connection details: host, port, user, password.
4. Add a backup ObjectServer (host, port).
5. Add a second ObjectServer datasource. (name, host, port, user, password).
6. Configure a dual server ObjectServer cluster. (name, upassword paswword, host (primary), host (backup), read cloud).
7. Save file.
8. Start Webtop server using /bin/server on UNIX or the Windows Services GUI.


3. Given NGF is installed and running, change the configuration, so that NGF is running in SSL mode.
   

With emphasis on performing the following steps:

1. Stop NGF.
2. Create a self-signed certification using: @$NCHOME/platform/arch/jre_version/bin/bin/keytool -certreq -keyalg RSA -alias ngf -file certreq.csr -keystore
3. Enter password for keystore which must be the same as previous password; enter organization details, enter hostname of the NGF server, accept details, enter key password.
4. Modify NCHOME/guifoundation/conf/server.xml by uncommenting section with key details (keystore file and keystore password).
5. Start NGF.
6. Verify the NGF server is working correctly by logging into https://:8443 and logging into server as user.


4. Given that the Webtop 2.0 is installed and running and you are signed in as an NGF administrator, create a user that authenticates against a Netcool Omnibus objectserver as defined in the Statement of Work.
   

With emphasis on the following steps:

1. Select Security tab within the NGF Administration page.
2. Select the Users page within the Security tab.
3. Select the User Details tab.
4. Assign the same user name as assigned within the Object Server.
5. Put a check in the checkbox next to ‘Authenticate externally’.


5. Given that Webtop 2.0 is installed and running and you are signed in as an NGF administrator, modify users, so that users have been modified.
   

With emphasis on performing the following steps:

1. Select the Security Tab within the NGF Administration page.
2. Select the Users page within the Security tab.
3. Click on the Edit User icon next to the user you wish to modify.
4. Modify user details.
5. Click on Save.


6. Given that Webtop 2.0 is installed and running and you are signed in as an NGF administrator delete users as defined in the Statement of Work, so that users are deleted.
   

With emphasis on performing the following steps:

1. Select the Security Tab within the NGF Administration page.
2. Select the Users page within the Security tab.
3. Put a check in the checkbox next to each user that you wish to delete.
4. Click the delete button.
5. Click on OK when asked for confirmation to delete the user.


7. Given Webtop is installed and running and you are signed in as administrator, create a view as defined in the Statement of Work, so that a view is created.
   

With emphasis on performing the following steps:

1. Launch View Builder from AEL or Desktop view.
2. Click Add View button.
3. Enter: view name, fields, sort order, column titles, ObjectServer.
4. Save View.


8. Given Webtop is installed and running and you are signed in as administrator, create a filter as defined in the SOW, so that a filter has been created.
   

With emphasis on performing the following steps:

1. Lauch filter Builder from Active Event List (AEL) or Desktop view.
2. Click Add Filter button.
3. Enter: filter name, ObjectServer datasource, filter criteria, metric).
4. Save Filter.


9. Given Webtop is installed and running and you are signed in as administrator, create a new ACL and define users which are members of the ACL, so that an ACL has been created.
   

With emphasis on performing the following steps:

1. From Webtop Admin pages select Access and Utilities.
2. Select Users and ACLs.
3. Select ACLs.
4. Select Create ACLs.
5. Enter ACL name.
6. Save ACL.
7. Modify created ACL.
8. Add/Remove Users from ACL.
9. Return to ACL Editor.


10. Given that NGF is installed and running, create Groups, using NGF, for Webtop users.
    

With emphasis on performing the following steps:

1. Login to NGF as a user with NGF Administrator privileges.
2. Access the Administration pages.
3. Select the Security Tab.
4. Select the Groups Menu.
5. Click on “Add Group” button.
6. Under Group Properties tab:


--Provide a Group name.

--Add a Display Name, if required.

--Add External Authentication Name, if required.

--Make Group inactive, if required.

--Add Group members as necessary.
7. Under Group Roles tab:


--Select roles appropriate for the Group.


11. Given Webtop is installed and running and you are signed in as administrator, create an entity as defined in the SOW, so that an entity is available for use.
    

With emphasis on performing the following steps:

1. From Webtop Admin page select Entities from the Content tab.
2. Click Add Entity button.
3. Enter Entity details: name, type (filter, dependent), group, view, metric, label.
4. Click Add this Entity.
5. If filtered enter filter SQL. If dependent select current dependencies.
6. Click Modify This Entity.


12. Given Webtop is installed and running and you are signed in as administrator, create an entity view as defined in the SOW, so that a new entity view is available.
    

With emphasis on performing the following steps:

1. From Webtop Admin page select Entity Views.
2. Click Create Entity View.
3. Enter view name.
4. Select ObjectServer name, select Group Name and click OK.
5. In the Entity View Editor, select: fields, column titles, sort order, layout. Click Apply.


13. Given Webtop is installed and running, create a chart configuration, so that a chart template is available for use.
    

With emphasis on performing the following steps:

1. Login to Webtop server host as the Netcool Administrator.
2. Change directory to $NCHOME/etc/webtop/charts/definitions.
3. Copy a chart definition XML file which best matches the type of chart you require.
4. Open the copy of XML file and change variable to be the same as the file name without the .xml extension.
5. Define Chart Title by entering name in <header text> field.
6. Set x Scale Element Title value to represent the x- Axis label.
7. Set y Scale Element Title value to reflect y axis label.
8. Define colors to use for chart in Chart Renderer section.
9. Define Chart DataSet in DataConfig section.
10. Save file.
11. Verify chart configuration works as required:


--Login to NGF as a Webtop Administrator with page customization permissions.

--Create a new page or customize an existing one

--Add a Viewpoint (type ChartView) to the page.

--Click “Save and Return” button to get back to the page.

--Customize the default ChartView and select the required chart to display.

--Verify that the chart renders as expected.


14. Given Webtop is installed and running and you are signed in as administrator, create a new map, so that a map is available for use.
    

With emphasis on performing the following steps:

1. Go to the Webtop Admin page and select Maps.
2. Select Create Map and ensure Java Editor is selected.
3. Enter name of map.
4. Define map properties: Access Control (Groups), height/width, background color/image. (Note: The heading in the Java Editor still has "Access Control" in the GUI but the drop down fills with Groups from NGF.)
5. Add components to the map as defined in the SOW: buttons, active buttons, lava lamp/monitors, icons, active icons, lines, text.
6. Right click on added elements and bring up the properties dialogue box.
7. Define required properties for selected icons.
8. For Active icons define: action, URL, Entity, Datasource, target.
9. Save the map.
10. Preview map to verify the configuration is correct.


15. Given Webtop is installed and running, create a new tool, so that the tool is available to be added to a menu.



With emphasis on performing the following steps:

1. Login to NGF as Webtop Administrator.
2. From the Webtop Admin page, select the Tools menu.
3. Click on “Create Tool” button.
4. Enter tool name and select tool type (CGI/URL, SQL, Command Line).
5. Click OK.
6. For a CGI/URL tool: enter URL, select Groups, select method, select open in new window or specific window, select fields to be passed.
7. For SQL enter the SQL statements, select Groups, and enter Journal text.
8. For Command Line select Groups, select platform for command, enter command line to run and select fields to pass. Click OK.


16. Given Webtop is installed and running, create and register a new CGI program, so that it is available for use in Webtop tools.
    

With emphasis on performing the following steps:

1. Place the CGI script in the NCHOME/etc/webtop/cgi-bin/ directory.
2. Select Webtop Admin from the Pages drop-down list.
3. Select the CGI Registry menu item.
4. Click Register. The Register CGI pop-up window is displayed. In the CGI Name field, enter a name for the CGI script.
5. If the output of the CGI script is HTML data that contains Netcool/Webtop SmartPage commands, select the Use Smart Commands check box.
6. Enter the filename of the script in the File Name text field.
7. If you want to make the CGI script available, click the Groups button and select the groups to which you want to allow access.
8. Click Register.


17. Given Webtop is installed and running, create a new menu item and make it available for use, so that the new menu is available.
    

With emphasis on performing the following steps:

1. The user has been added to the Webtop User and Webtop Admin roles (this is required in order for the user to have access to the webtop admin utils).
2. Select Webtop Admin from the drop the menu.
3. Select Menu.
4. Select Create Menu.
5. Enter a name and label.
6. Add existing tools to new menu.
7. Arrange new separator if required.
8. Save menu change.


18. Given that Webtop 2.0 is installed and running and you are signed in with Webtop administration rights, add a new resource to a given map, so that it is available for use in the Map Editor.
    

With emphasis on performing the following steps:

1. Navigate to the Webtop Admin page within the NGF.
2. Select Map Resources .
3. Select the map that you wish to add a resource to from the list.
4. Click the Add Map Resource button.
5. Enter a resource filename or browse for a file to upload.
6. Click on the Add Resource button.


19. Given Webtop is installed and running, create a new directory and upload HTML files, so that they are available for use.
    

With emphasis on performing the following steps:

1. Login to NGF as Webtop Administrator.
2. From the Webtop Admin page, select the Tools menu.
3. Select File Manager menu.
4. Enter name for new sub directory and click "Create Sub Directory".
5. Select the sub directory that was just created.
6. Click “View Dir” button.
7. Click “Browse” button to select file to upload.
8. Click “Add file to Dir” button.


20. Given Webtop is installed and running, create a new HTML page, so that the new page is available.
    

With emphasis on performing the following steps:

1. Open a text editor to create new HTML file.
2. Ensure appropriate HTML syntax is followed:


Enter HTML commands as required.
3. Enter Smart Page commands as defined in the SOW:


4. Save file.
5. From the Webtop Admin page, select File Manager
6. Change directories to the appropriate location for the new file or create new subdir
7. Browse for the file created above
8. Select Add file to Dir
9. Validate file by selecting the file added, click View File and then "link to file"


21. Given Webtop is installed and running and you are signed in as administrator, check who is logged in to Webtop and revoke user sessions, so that selected users are logged out of Webtop.
    

With emphasis on performing the following steps:

1. navigate to the Webtop Admin page.
2. Select 'Sessions' tab
3. A list will be provided showing logged in users.
4. To revoke a given user click on the 'Revoke' button next to the user
5. User will be logged out of Webtop.

Section 4 - Performance Tuning and Peformance Determination

1. Given Webtop is installed and running, determine the cause of Webtop Performance issues, so that the cause of the issues are determined.
   

With emphasis on performing the following steps:

1. From the Webtop Admin page click on 'Sessions' tab to determine how many users are logged in.
2. If the number of users is very high revoke user sessions.
3. Click on 'System Information -> Server Runtime' to determine how much memory is being used.
4. Check the number of events in the ObjectServer using nco_sql.
5. Check response times when using Native Desktop.
6. Determine if there is a performance problem for all Webtop components.
7. Determine if all users experiencing slow responses.
8. Determine if other application are running on the Webtop server host.
9. Check Webtop log files NCHOME/log/webtop.log.


2. Given NGF is installed and running, determine the reason for user login failure, or failure to access Webtop, so that the cause of the failures is determined.
   

With emphasis on performing the following steps:

1. Determine if Security Manager is running.
2. Determine if the user has an NGF account.
3. Determine if the user has an active NGF account.
4. Determine if the user has an appropriate Webtop Role.
5. Determine if the user is using the correct password.
6. Determine if the user has an accessible Home-Page.
7. Determine if the ObjectServer is running and if Webtop can connect to it.


3. Given that Webtop 2.0 is installed, identify the cause of startup problem so that the cause is known.
   

With emphasis on performing the following steps:

1. Log into the Webtop server machine.
2. Check the environment variables: NCHOME
3. Look in $NCHOME/log/webtop.log and $NCHOME/log/guifoundation/ logs for indication about the cause of the problem.
4. Types of problems to look for: licenses not available, ports already in use, unable to connect to the Object Server.


4. Given Webtop is installed and running, verify the cause of Webtop's inability to connect to the ObjectServer, so that the cause of the problem is known.
   

With emphasis on performing the following steps:

1. Login to Webtop server machine.
2. Verify that you can login to the ObjectServer.
3. Verify that the correct ObjectServer is configured for Webtop.


--$NCHOME/etc/webtop/datasources/ncwDataSourceDefinitions.xml.
4. Verify that the user and passwords are correct.


--$NCHOME/etc/webtop/datasources/ncwDataSourceDefinitions.xml.
5. Confirm that the Webtop server can connect to the ObjectServer host and port.


5. Given Webtop is installed and running, create a backup copy of the Webtop configuration, so that copies have been made.
   

With emphasis on performing the following steps:

1. Stop Webtop.
2. Make copies of the following files and directories: $NCHOME/etc/webtop/, $NCHOME/webtop/waapi/etc/, $NCHOME/guifoundation/webapps/.
3. Start Webtop.


6. Given NGF Installed, troubleshoot NGF issues, so that NGF is running and users are able to login to Webtop.
   

With emphasis on performing the following steps:

1. Login to the machine where NGF is installed
2. Check the status of NGF server by running: $NCHOME/bin/ngf_server status (on UNIX) or by checking the status of the appropriate service (on Windows)
3. If NGF server is not running, start it using $NCHOME/bin/ngf_server start (on UNIX) or by starting the service (on Windows)
4. Check the NGF log files at $NCHOME/log/guifoundation for possible causes for startup issues and resolve them if any.
5. If users are unable to login to Webtop at http://:, check to make sure that Security Manager is running.


7. Given that Security Manager is installed, determine the cause of Security Manager Performance issues, so that the cause of the issues are determined.
   

With emphasis on performing the following steps:

1. Determine if Security Manager is running.


-- From Command Line, with appropriate permissions, run the script $NCHOME/security/bin/ncsm_status.

-- From a browser window, attempt to connect to Security Manager HTTP port (default 8077).
2. Determine if the authentication source is available


-- Specified authentication source - NGF Security tab, Domain menu
Check available
Check access credentials
$NCHOME/etc/sm/server.props
3. Change authentication source


--$NCHOME/security/install/ncsm_config
4. Check Security Manager log files


--$NCHOME/security/log/SM_server.log