Sie sind auf Seite 1von 166

V7.0.

cover

Front cover

IBM InfoSphere Information


Server Administration v9.1

(Course code KM502)

Student Exercises
ERC 1.0
Student Exercises

Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International
Business Machines Corp., registered in many jurisdictions worldwide.
The following are trademarks of International Business Machines Corporation, registered in
many jurisdictions worldwide:
DataStage DB2 IA
InfoSphere QualityStage WebSphere
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or
both.
Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other
countries, or both.
Other product and service names might be trademarks of IBM or other companies.

December 2012 edition


The information contained in this document has not been submitted to any formal IBM test and is distributed on an as is basis without
any warranty either express or implied. The use of this information or the implementation of any of these techniques is a customer
responsibility and depends on the customers ability to evaluate and integrate them into the customers operational environment. While
each item may have been reviewed by IBM for accuracy in a specific situation, there is no guarantee that the same or similar results will
result elsewhere. Customers attempting to adapt these techniques to their own environments do so at their own risk.

Copyright International Business Machines Corporation 2007, 2012.


This document may not be reproduced in whole or in part without the prior written permission of IBM.
Note to U.S. Government Users Documentation related to restricted rights Use, duplication or disclosure is subject to restrictions
set forth in GSA ADP Schedule Contract with IBM Corp.
V7.0.1
Student Exercises

TOC Contents
Exercises description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Exercise 1. Technical overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1

Exercise 2. Overview of Clients used for administration . . . . . . . . . . . . . . . . . . . . 2-1

Exercise 3. Authentication and Suite Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Exercise 4. Stopping and Starting Information Manager . . . . . . . . . . . . . . . . . . . . . 4-1

Exercise 5. Session Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

Exercise 6. Engine tier architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

Exercise 7. Engine tier configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

Exercise 8. Engine tier connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1

Exercise 9. Engine tier monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-1

Exercise 10. Metadata asset management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-1

Exercise 11. Information Services Console configuration . . . . . . . . . . . . . . . . . . 11-1

Exercise 12. Installation, deployment, and recovery . . . . . . . . . . . . . . . . . . . . . . . 12-1

Exercise 13. Serviceability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-1

Copyright IBM Corp. 2007, 2012 Contents iii


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

iv Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4.0.3
Student Exercises

pref Exercises description


This course includes the following exercises:
One lab for each unit.
The number of the exercise corresponds to the number of the unit.
For example, Exercise 1 applies to unit 1, Exercise 2 applies to unit
2, and so on.
A slide at the end of each unit lists the tasks in the exercise.

Copyright IBM Corp. 2007, 2012 Exercises description v


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

vi Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Exercise 1. Technical overview

What this exercise is about


This exercise tests your understanding of the technical overview
presented in this unit.

What you should be able to do


At the end of this exercise, you should be able to:
Identify Information Server functions and associated products

Introduction
These exercise check your understanding of the different products,
components, and functions of the Information Server product suite. As
you take this test feel free to review the Student Guide.

Requirements
None.

Copyright IBM Corp. 2007, 2012 Exercise 1. Technical overview 1-1


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Identify Information Server functions and associated


components
Check the correct answer.
__ 1. Which Information Server product performs data cleansing? Choose one.
__ a. Information Analyzer
__ b. QualityStage
__ c. DataStage
__ d. FastTrack
__ e. Metadata Workbench
__ 2. Which Information Server products can create business, user-oriented metadata?
Choose two.
__ a. Information Analyzer
__ b. QualityStage
__ c. DataStage
__ d. FastTrack
__ e. Metadata Workbench
__ 3. Which Information Server product performs data transformation? Choose one.
__ a. Information Analyzer
__ b. QualityStage
__ c. DataStage
__ d. FastTrack
__ e. Metadata Workbench
__ 4. Metadata Workbench profiles source data.
__ a. True
__ b. False
__ 5. Which Information Server layer is comprised of design and operational databases?
Choose one.
__ a. Services (Domain)
__ b. Metadata Repository
__ c. Server
__ d. Client

1-2 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 6. Which function does Information Server FastTrack perform? Choose two.
__ a. Creates business terms
__ b. Generates DataStage jobs
__ c. Runs metadata analysis reports
__ d. Creates data models
__ e. Creates mapping specifications for ETL jobs
__ 7. Which functions does Information Server Metadata Workbench perform? Choose
two.
__ a. Data lineage
__ b. Data cleansing
__ c. Cross-tool reporting
__ d. Data transformation
__ e. Data visualization
__ 8. Parallel processing can be scaled up by increasing what component? Choose one.
__ a. Network connections
__ b. SAN
__ c. DataStage jobs
__ d. Processors
__ 9. Which DataStage component specifies hardware and resources available to the
job? Choose one.
__ a. Domain layer
__ b. Configuration file
__ c. Parameter set
__ d. DataStage job links
__ 10. The Server layer for Information Server is certified on and can be deployed on which
platforms in the following list? Choose two.
__ a. Windows XP
__ b. Debian Linux
__ c. RedHat Linux
__ d. Windows 2003 server
__ 11. The client layer for Information Server is certified on and can be deployed on which
platforms? Choose two.
__ a. Windows XP

Copyright IBM Corp. 2007, 2012 Exercise 1. Technical overview 1-3


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ b. Debian Linux
__ c. RedHat Linux
__ d. Windows 2003 server
__ 12. You must run scripts to create the Information Server Repository if that Repository is
created on which two databases in the following list? Choose two.
__ a. DB2
__ b. Microsoft SQL Server
__ c. Sybase
__ d. Oracle
__ e. Teradata
__ 13. Which layer of the IS platform provides logging management? Choose one.
__ a. Engine
__ b. Repository
__ c. Common Services
__ d. Client
__ 14. The DataStage Multi-Client manager allows you to do which of the following?
Choose one.
__ a. Connect to multiple repositories
__ b. Connect to multiple servers
__ c. Install multiple client versions on a workstation
__ d. Install multiple repositories
__ 15. QualityStage cleanses data by using logic provided by which object? Choose one.
__ a. Rule Sets
__ b. Services
__ c. Connectors
__ d. Packs
__ 16. Which DataStage client is used to view logs from DataStage jobs? Choose one.
__ a. Administrator
__ b. Multi-Client Manager
__ c. Designer
__ d. Director

1-4 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 17. Where does Business Glossary Anywhere run? Choose one.
__ a. Server
__ b. Client
__ c. Services
__ d. Repository

Copyright IBM Corp. 2007, 2012 Exercise 1. Technical overview 1-5


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Answers
1. B
2. A, D
3. C
4. B (False)
5. B
6. B, E
7. A, C
8. D
9. B
10. C,D
11. A,D
12. B, D
13. C
14. C
15.A
16. D
17. B

1-6 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Exercise 2. Overview of Clients used for


administration

What this exercise is about


This exercise helps familiarize you with the Information Server clients
used for administration. Information Server hosts a complex array of
products. Although you do not need to acquire in-depth knowledge of
all of these products, you need to have some understanding of what
they do and how they are used.

What you should be able to do


At the end of this exercise, you should be able to:
Log into and explore the Information Server Web Console
Administration and Reporting tabs
Log into and explore the Metadata Asset Manager thin client
Log into and explore the WebSphere Application Server (WAS)
Integrated Solutions Console
Log into and explore the Information Server Console
Log into and explore DataStage client functionality
Log into and explore the DataStage and QualityStage Operations
Console
Log into and explore the FastTrack client
Log into and explore Metadata Workbench

Introduction
This exercise familiarizes you with the various Information Server
clients. You will not do much more in any particular client other than
just to log on. Later units will go into more detail.

Requirements
The steps presented in the lab exercises assume you are working
these labs on the course VMWare images. If this is not the case, you
may need to make some adjustments.

Copyright IBM Corp. 2007, 2012 Exercise 2. Overview of Clients used for administration 2-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Information Server must be up and running. If the login window for the
Information Server Web Console does not come up in the first task,
then check whether a network connection exists between the Client
and the Server images (ping edserver), and if so check whether
Information Server is running.
In order to view job activity in the Information Server Operations
Console, the AppWatcher.sh services must be running. This lab
assumes these services are not running. In a later unit, you will learn
how to start these services.

2-2 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Log into and explore the Information Server Web Console
Administration and Reporting tabs
__ 1. Log into your client operating system: student / student.
__ 2. On the Information Server client system, open Windows Internet Explorer and enter
the following IP address: http://edserver.ibm.com:9080/ibm/iis/console
__ 3. Enter an Information Server (IS) Administrator user ID and password: isadmin /
isadmin.

__ 4. Click the Administration tab.

Copyright IBM Corp. 2007, 2012 Exercise 2. Overview of Clients used for administration 2-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 5. Open and explore the available folders in the Navigation panel.

__ 6. When you are done exploring the Administration tab, click and explore the
Reporting tab. In particular, expand the Report Templates folder to view the
templates for the different types of reports that can be created and run.

2-4 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Log into and explore the Metadata Asset Manager thin
client
__ 1. In your web browser enter the address to open Metadata Asset Manager:
http://edserver.ibm.com/ibm/imam/console. Log in as student/student. Explore
the Repository Management and Import tabs. Notice that there are three types of
functionality available within Metadata Asset Manager: Importing metadata assets
into the Repository, searching and browsing metadata assets in the Repository, and
managing assets within the Repository.

Copyright IBM Corp. 2007, 2012 Exercise 2. Overview of Clients used for administration 2-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Log into and explore the WebSphere Application Server


(WAS) Integrated Solutions Console
__ 1. Open a Web browser. Enter the URL to connect to the Integrated Solutions Console:
http://edserver:9060/ibm/console.

Note

If you are using the course image, the browser may block the window from opening. If this
happens, click Continue to this website.

__ 2. Log in using a WAS Administrator ID and password (wasadmin/wasadmin).

__ 3. Click on the WebSphere Application Server link.

2-6 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 4. Review all available branches. In particular drill down in the Servers branch to view
the WebSphere application servers. Note server1, which is the IS Metadata Server
for the Services layer.

Copyright IBM Corp. 2007, 2012 Exercise 2. Overview of Clients used for administration 2-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Log into and explore the Information Server Console


__ 1. Click the Information Server Console icon on your desktop and log in to as
student/student. The host name is edserver.ibm.com:9080, as shown below. This
provides access to both Information Analyzer and Information Services Director.

2-8 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 2. Click the Home pillar icon (blue sphere in the upper left portion of the window) and
then click My Home.

__ 3. From the Home pillar icon, open the menu and explore the menu options, including
the Configuration>Information Services Connections and
Configuration>Sources options.

Copyright IBM Corp. 2007, 2012 Exercise 2. Overview of Clients used for administration 2-9
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Log into and explore DataStage client functionality


__ 1. Click the DataStage Administrator client icon on your desktop. Enter a DataStage
user ID and password (here, student / student). Select the host name of the
services tier (edserver.ibm.com), where the WAS is installed. Also select the host
name of the Information Server (DataStage) engine (edserver.ibm.com).

__ 2. Click Login and then select the Projects tab.

2-10 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 3. Select the DSProject project. Then click Properties to open the Administrator
Project Properties window. Explore each of the tabs.

Copyright IBM Corp. 2007, 2012 Exercise 2. Overview of Clients used for administration 2-11
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 4. Close DataStage Administrator. Use the same procedure to log into and explore
DataStage Designer and DataStage Director. For each of these you will be logging
on to a specific project. Log onto the project named DSProject.

2-12 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Log into and explore the DataStage and QualityStage
Operations Console
__ 1. Open Internet Explorer and then enter the following IP address:
http://edserver.ibm.com:9080/ibm/iis/ds/console.
__ 2. In the Login window, enter your user ID and password (student/student), and then
click Login. Since most of the services that support the Operations Console are
disabled by default, you will not be able to view job activities and system resources.
You will see how to do so in a later unit.

Copyright IBM Corp. 2007, 2012 Exercise 2. Overview of Clients used for administration 2-13
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Log into and explore the FastTrack client


__ 1. Double-click on the FastTrack icon on the desktop, and log into the FastTrack client
as student/student.
__ 2. Explore FastTrack. Here you might click Home, where new FastTrack projects are
created. You might also look at Metadata>Source Configuration and
Metadata>Metadata Repository.
__ 3. Close FastTrack.

2-14 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Log into and explore Metadata Workbench


__ 1. Open a web browser. Enter the URL to connect to Workbench,
http://edserver:9080/workbench. Log in as student/student.
__ 2. Browse some of the metadata using Workbench. You can for example, expand the
DSProject Engine folder to explore the contents of the DSProject DataStage
project.

Copyright IBM Corp. 2007, 2012 Exercise 2. Overview of Clients used for administration 2-15
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

2-16 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Exercise 3. Authentication and Suite Security

What this exercise is about


This exercise covers Information Server authentication. This involves
configuration in the IS Web Console, the WAS Console, and IS
product component clients.

What you should be able to do


At the end of this exercise, you should be able to:
View the user registry configuration in the Information Server Web
Console
View WAS user registry configuration
Create Information Server users
Review and create DataStage credentials

Introduction
In this lab you will see how IS authentication involves configuration in
the IS Web Console, the WAS Console, and IS product component
clients.

Requirements
No new requirements.

Copyright IBM Corp. 2007, 2012 Exercise 3. Authentication and Suite Security 3-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: View the user registry configuration in the Information


Server Web Console
__ 1. Log onto the Information Server Web Console using the isadmin / isadmin user ID
and password.
__ 2. Click the Administration tab and open the Domain Management folder.
__ 3. Click User Registry Configuration. Note that the Information Server User
Registry box is checked as Active Provider.

3-2 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 4. Select the Information Server User Registry option, and then click Open Provider
Configuration. This displays the attributes of this user registry. The contents are
read-only within the Information Server Web Console.

__ 5. Close down the IS Web Console.

Copyright IBM Corp. 2007, 2012 Exercise 3. Authentication and Suite Security 3-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: View WAS user registry configuration


__ 1. In a browser, log into the Integrated Solutions Console with access to the
WebSphere Application Server. The address is
https://edserver:9060/ibm/console.

Note

If you are using the course image, the browser may block the window from opening. If this
happens, click Continue to this website.

__ 2. Log in using your WAS administrator user ID and password (wasadmin /


wasadmin) to log in.

3-4 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 3. Expand the Security folder, and then click the Global security option. Notice the
entry in the Current realm definition box. The default IS registry is a standalone
custom registry.

Copyright IBM Corp. 2007, 2012 Exercise 3. Authentication and Suite Security 3-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 4. Open the Available realm definition list. Here you can change the registry that is
used to a local operating system registry or to a standalone LDAP registry. Then you
would click the configure button to configure it.

Note

If the Available realm definitions list is read-only, check which ID you used to log in at the
top of the window. You must be logged on as a WAS administrator (wasadmin). If
necessary, log out and log back in.

__ 5. Close the WAS Console without making any changes to anything.

3-6 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Create Information Server users


__ 1. Log into the Information Server Web Console as isadmin/isadmin, and then click
the Administration tab.
__ 2. Expand Users and Groups, and then click Users.
__ 3. Click New User. Define a new user named dsuser. For simplicity here, type dsuser
in all required fields (the fields with the asterisks).

__ 4. Expand the Suite Component role list. Select the DataStage and QualityStage
User role in addition to the Suite User role selected by default.

Copyright IBM Corp. 2007, 2012 Exercise 3. Authentication and Suite Security 3-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 5. Click Save and Close. Verify in the Users list that the new user has been created.

3-8 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Review and create DataStage credentials


__ 1. Open the Domain Management folder and click Engine Credentials. Select the IS
engine, here edserver.ibm.com, and then click Open Configuration. If you are
performing this lab on the course image, the default credentials have already been
specified. By default all users without credentials are mapped to dsadm. This
dsadm user ID has been created on the Engine operating system.

__ 2. Cancel this window to return to the Engine Credentials tab. Select the Engine
(edserver.ibm.com), and then click Open user Credentials.
__ 3. Browse for user dsuser and add dsuser to the Map User Credentials list.

Copyright IBM Corp. 2007, 2012 Exercise 3. Authentication and Suite Security 3-9
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 4. With dsuser selected, type in credentials for this user in the Assign User
Credentials area. Map dsuser to dsadm / dsadm, which is a valid OS user on the
DataStage Engine system.

__ 5. Click Apply. You should see dsuser mapped to dsadm after you click Apply.

Information

You may be wondering whether you can now log into DataStage using the dsuser ID, since
you have both created the user ID and given it DataStage credentials. The answer is that
you cannot, because you still need to be given authorization to log into DataStage from a
DataStage administrator. This will be explained in more detail in a later unit. For now, you
will just confirm that you cannot log into DataStage with that user ID.

__ 6. Try to log into the DSProject DataStage project in DataStage Designer using the
dsuser/dsuser ID. You will receive the error message: The current user does not
have the required DataStage roles set up.

3-10 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Exercise 4. Stopping and Starting Information


Manager

What this exercise is about


This exercise covers the stopping and starting of DataStage and the IS
Metadata Server.

What you should be able to do


At the end of this exercise, you should be able to:
Check for running engine processes
Stop engine services
Stop the ASB agent
Stop the Metadata Server (server1)
Start the IS Metadata Server
Start the ASB agent and DataStage engine
Check DataStage status

Introduction
Information Server is a complex product. Stopping and starting
Information Server involves stopping and starting several different
components and services. This unit discusses each. It also discusses
how you can check whether Information Server has indeed stopped or
started.

Requirements
No new requirements.

Copyright IBM Corp. 2007, 2012 Exercise 4. Stopping and Starting Information Manager 4-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Stopping Information Server

Task: Check for running engine processes


__ 1. On your client system, close down all Information Server clients.
__ 2. Log onto your Linux server machine as root/master.
__ 3. Open a terminal window, by clicking on the Terminal icon in the panel.
__ 4. Issue the following command from the command line: ps -ef | grep phantom
This command checks for running DataStage batch jobs. You should not see any
entries other than the message showing that root issued a grep command for
phantom.

Information

ps is a Unix command that displays the currently running processes. grep is a Unix
command that searches text for lines matching a regular expression (phantom in the
example above). In the above command, the output from the ps command (a list of
processes) is searched for a match with phantom.

__ 5. Each client connection to DataStage will initiate both a dsapi process and a dscs
process. To verify that you have no active DataStage connections you should search
for any dsapi or dscs processes. Issue the following command to see this: ps -ef |
grep dsapi, and ps -ef | grep dscs
Again, there should not be any entries other than root. If you see any, then return to
the client system and close any open clients.

__ 6. Now let us see what happens if a DataStage client is running. On the Information
Server client system log into DataStage Designer using student/ student.

4-2 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Afterwards, run the two previous commands again on the server system. Notice the
dsadm entries. These are the DataStage processes.

Information

Although you logged into DataStage Designer as student/student, the entry shown lists
dsadm, which is the DataStage administrator user ID specified when DataStage was
installed. The DataStage processes run under this user ID.

__ 7. Now, let us check if dscs is running by entering the command: netstat a | grep
dsrpc. Since the DataStage Designer client is running we should have an
established connection.

Information

The netstat command displays network related information.

__ 8. Close down DataStage Designer, and then run this command again. The
established network connection should disappear.

Copyright IBM Corp. 2007, 2012 Exercise 4. Stopping and Starting Information Manager 4-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Stop engine services


__ 1. Change to the DataStage home directory: cd
/opt/IBM/InformationServer/Server/DSEngine
__ 2. Verify that you are in the DSEngine directory by entering the pwd command.
__ 3. Set up the DataStage environment by running dsenv. Here, you type a period (.)
followed by a space, and then the word dsenv.
__ 4. Enter the command to stop the DataStage engine: ./bin/uv -admin -stop
__ 5. Check for memory segments for the DataStage engine tag ade. You should not
see any: ipcs | grep ade

Information

When Information Server is installed, the first DataStage engine installed is given the tag
ade. If additional engines are installed in the domain, they will be given other unique tags.

__ 6. Check for any dsrpcd port activity. You should not get any: netstat -a | grep dsrpcd

4-4 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Stop the ASB agent


The ASB agent establishes communication between the Engine system and the Services
system (where the WAS is running).
__ 1. Change to the ASB node bin directory: /opt/IBM/InformationServer/ASBNode/bin
__ 2. Stop the agent: ./NodeAgents.sh stop
__ 3. Check to confirm that the agent is stopped: ps -ef | grep agent

Copyright IBM Corp. 2007, 2012 Exercise 4. Stopping and Starting Information Manager 4-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Stop the Metadata Server (server1)


By default, the Metadata Server component of Information Server is named server1.
__ 1. Change to the ASBServer bin directory: cd
/opt/IBM/InformationServer/ASBServer/bin
__ 2. Issue a stop command: ./MetadataServer.sh stop. The server should shut down
gracefully with some messages.
__ 3. Check that there are no server1 processes running: ps -ef | grep server1

4-6 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Starting Information Server

Task: Start the IS Metadata Server


__ 1. If you are not there already, change to the ASBServer bin directory: cd
/opt/IBM/InformationServer/ASBServer/bin
__ 2. Issue the start command: ./MetadataServer.sh start

__ 3. It will take a while for Information Server to start. Change to the


/opt/IBM/WebSphere/AppServer/profiles/InfoSphere/logs/server1 directory and
then open the startServer.log file in a text editor: gedit startServer.log. The
message Server server1 open for e-business... indicates that the Metadata Server
has successfully started. If there are errors, other files in this directory will be helpful,
for example, SystemErr.log and SystemOut.log.

Copyright IBM Corp. 2007, 2012 Exercise 4. Stopping and Starting Information Manager 4-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Start the ASB agent and DataStage engine


__ 1. Change to the ASB node bin directory: cd
/opt/IBM/InformationServer/ASBNode/bin
__ 2. Start the agent: ./NodeAgents.sh start

__ 3. Change to the DataStage home directory: cd


/opt/IBM/InformationServer/Server/DSEngine
__ 4. Verify that you are in the DSEngine directory by entering the pwd command.
__ 5. Set up the DataStage environment by running the dsenv command: . dsenv
__ 6. Enter the command to start the DataStage engine: ./bin/uv admin start

4-8 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Check DataStage status


__ 1. From within the /DSEngine directory, issue the ./bin/uv admin info command.

__ 2. Issue the following command to check that the DataStage RPC service is listening:
netstat a | grep dsrpc
__ 3. Issue the following command to check the status of the dsrpcd daemon: ps ef |
grep dsrpcd
__ 4. Issue the following command to check the status of ASBNode: netstat a | grep
31531

Copyright IBM Corp. 2007, 2012 Exercise 4. Stopping and Starting Information Manager 4-9
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

4-10 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Exercise 5. Session Management

What this exercise is about


In this exercise you will perform a number of administrative tasks in the
Information Server Web Console. These include managing sessions,
managing logging, and managing reports.

What you should be able to do


At the end of this exercise, you should be able to:
Manage active sessions
Manage logging configurations
Create a log view
View the log
Create an administrative report
Clear abandoned locks

Introduction
The Information Server Web Console is a primary administrative tool.
In this lab you will use it to perform a number of different administrative
tasks, including managing sessions, managing logging, and managing
reports.

Requirements
No new requirements.

Copyright IBM Corp. 2007, 2012 Exercise 5. Session Management 5-1


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Session Management

Task: Manage active sessions


__ 1. Log into DataStage Designer DSProject as student / student. This will create one
session.
__ 2. Log into FastTrack as student / student. This will create another session.
__ 3. Log into the Information Server Web Console as isadmin / isadmin. This will create
a third session.
__ 4. On the Administration tab, click the Session Management>Active Sessions
folder. You should see the three sessions that were created when you logged into
DataStage Designer, FastTrack, and the Web Console.

__ 5. Select the session that is labeled as a Console type. This should be your FastTrack
session. Then click Open to view details about the session. Notice session details
such as the session duration as well as details about the user, including their
authentication roles and user attributes.

5-2 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 6. Click Close to close to return to the Active Sessions list.


__ 7. With the same session selected, click Disconnect and complete the process of
disconnecting the session.
__ 8. Outside of the Web Console, notice that the FastTrack session has been terminated.
You can tell when you try to click on something in FastTrack, for example, one of the
tabs.
__ 9. Back in the Web Console, click Global Session Properties. Increase the inactive
session timeout time to 180000 seconds.

__ 10. Click Save and Close. On the Active Sessions tab, select all sessions other than
the isadmin session you are in. Disconnect them all. Then log out of the IS Web
Console. After this no IS Sessions should be running.

Copyright IBM Corp. 2007, 2012 Exercise 5. Session Management 5-3


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Logging Management

Task: Manage logging configurations


__ 1. Log into the Information Server Web Console as an administrator (isadmin /
isadmin).
__ 2. On the Administration tab, click Log Management>Logging Components.
__ 3. Select Connector Access.

__ 4. Click on Manage Configurations.


__ 5. Select ConnectorAccess.WARN.

__ 6. Click Copy. This creates a copy of the existing configuration that can then be
modified.

5-4 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 7. Select all items and set the Severity Level to All for each item.

__ 8. Click Save and Close.


__ 9. Select the new configuration and click Set as Active to make it the active
configuration.

Information

If you do not see the new configuration in the list, click the Logging Components link to
refresh the list.

Copyright IBM Corp. 2007, 2012 Exercise 5. Session Management 5-5


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Create a log view


__ 1. Click Log Management>Log Views.
__ 2. Click New Log View.
__ 3. Type the name, CAS Log, and select All severity Levels.

5-6 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 4. Click the Browse button in the Categories section. Select the five categories that
begin with the string ISF-CAS', and then click OK. Then select them in the
Categories section:

__ 5. In Timestamp, select a range from your current date and time for 1000 events.

__ 6. Click Save and Close.

Copyright IBM Corp. 2007, 2012 Exercise 5. Session Management 5-7


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: View the log


__ 1. Select the CAS Log view created above, and click View Log.

__ 2. If any Connector Access activity has occurred you will see messages. However,
probably you will not see any messages at all, since no Connector Access activity
will have occurred.
__ 3. To generate some Connector activity, log into FastTrack. Click Metadata>Source
Configuration. Click New Connection. The Connection Editor window opens.
Click Cancel to close the editor without doing anything. This is enough activity to
generate some log messages.
__ 4. Return to the View Log tab in the Web Console. Click Refresh at the bottom of the
window. You should see a bunch of messages similar to what you see here.

__ 5. You can export any of the messages to a file. To do so, select the messages and
then click Export Log. You will be prompted for a file path on your client system.

5-8 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 6. Click Log Management>Logging Components. Select the


ConnectorAccess.WARN component, and then click Set as Active.

Copyright IBM Corp. 2007, 2012 Exercise 5. Session Management 5-9


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Reporting Administration

Task: Create an administrative report


__ 1. In the IS Web Console, click the Reporting tab.
__ 2. Open the Report Templates>Administration>Security category. Then click View
Report Templates. Select the List of users template.

__ 3. Click New Report to open a new report form.


__ 4. The output format is the only required option. Select HTML.

5-10 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 5. In the Report Settings section, select Product in the Role Type box and
DataStage and QualityStage in the Components box.

__ 6. Click Save and Close from the Finish menu in lower right portion of the window.
You will be returned to the Report Template to Work With window.
__ 7. With the List of Users radio button checked, click Open Reports.
__ 8. Select the List of users report.

Copyright IBM Corp. 2007, 2012 Exercise 5. Session Management 5-11


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 9. Click Run Now and then complete the process to run the report. View the report
when it is completed.

5-12 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Clear abandoned locks


__ 1. Log into the Server system as root/master.
__ 2. Open a terminal window.
__ 3. Change to the directory containing the cleanup_abandoned_locks.sh script: cd
/opt/IBM/InformationServer/ASBServer/bin
__ 4. Execute the script: . ./cleanup_abandoned_locks.sh. When prompted enter an
Information Server administrator ID and password (isadmin/isadmin).

Copyright IBM Corp. 2007, 2012 Exercise 5. Session Management 5-13


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

5-14 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Exercise 6. Engine tier architecture

What this exercise is about


The DataStage parallel engine (also known as the Information Server
engine) is used by several Information Server products and
components. In order to administer it effectively you need to have an
understanding of how it works and how it is configured.

What you should be able to do


At the end of this exercise, you should be able to:
Edit a configuration file
Run a DataStage job from the GUI using the non-default
configuration file
Examine the OSH and Score
Run a job from the command line
Administer the Engine from the command line
Use the DSXImportService command to list the contents of a
DataStage import (dsx) file
Use the DSXImportService command to import a DataStage import
(dsx) file

Introduction
Every parallel job run by the DataStage parallel engine runs under a
configuration file. The configuration file identifies the nodes the jobs
operators can run on, and the resources it can use. In the first task you
learn how to edit a configuration file, and to run a job using that
configuration file. You learn how to run the job from the DataStage
Designer GUI as well as from the DataStage Server command line.

Requirements
You have a DataStage project named DSProject.
DSProject contains a folder named _Training_ISAdmin.
The GenRows job exists in your _Training_ISAdmin>Jobs folder.

Copyright IBM Corp. 2007, 2012 Exercise 6. Engine tier architecture 6-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Configuration files and the Score

Task: Edit a configuration file


__ 1. Log onto DataStage Designer as student / student to the project named
DSProject.
__ 2. In DataStage Designer, click Tools>Configurations.
__ 3. From the Configurations list, select the default configuration file.

__ 4. Questions (Answers at the end of the lab):


a. What is the fastname for each? Why is the fastname the same for both
nodes?
b. Are there any node pools? Are there named node pools? Are there default
node pools?
c. Are there any resource pools? Are they named? Is there a default resource
pool?
__ 5. Create a copy of the default configuration file named Two_Node. To do this, click
Save>Save Configuration As.

6-2 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 6. Now, let us add a node pool to node2. At the end of the line with the pools keyword
for node2 add a pool named pool2.

__ 7. Click the Check button to check the syntax after the edit. Be sure to save any
changes.
__ 8. Click Close.

Copyright IBM Corp. 2007, 2012 Exercise 6. Engine tier architecture 6-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Run a DataStage job from the GUI using the non-default
configuration file
In this task, you will run a DataStage job from within the DataStage Designer client. In a
later task, you will do the same from the command line.
__ 1. Open the GenRows job in the _Training_ISAdmin>Jobs folder. (To do this, select
the job, right-click, and then click Edit.) Click File>Save As and save the job as
GenRows_Param.
__ 2. Click the Job Properties icon (fifth icon from the left in the toolbar).
__ 3. Click the Parameters tab.

__ 4. Click Add Environment Variable and then locate the $APT_CONFIG_FILE


environment variable. Select it to add it as a parameter to the job.

6-4 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 5. Open and then double-click in the Default Value cell for the job parameter and
select the Two_Node.apt file as the default value for this parameter.
__ 6. Click OK to return to the Job Properties window.
__ 7. Click the Generated OSH tab to view the OSH. Notice that there are two operators
corresponding to the two stages on the canvas.

__ 8. Click OK to close the Job Properties window.


__ 9. Click the Compile icon (just below Window menu). The job should compile without
errors.

Copyright IBM Corp. 2007, 2012 Exercise 6. Engine tier architecture 6-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 10. Click the Run icon (just to right of Compile icon). The Job Run Options window is
displayed. When prompted, select the Two_Node.apt configuration file (which
should be selected by default).

__ 11. Click Run. Notice that the link turns green and runtime statistics are displayed on
the canvas as the job runs.
__ 12. Click View>Job Log. This displays the jobs log messages in a window.

6-6 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 13. Double-click the message labeled main_program: APT configuration file This
identifies the configuration file the job ran under.

Copyright IBM Corp. 2007, 2012 Exercise 6. Engine tier architecture 6-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Examine the OSH and Score


__ 1. Double-click on the message labeled OSH script. The OSH shows up in the log as
well as in the Job Properties window.
__ 2. Double-click the message that is labeled main_program: This step has ...
datasets. This is the Score.

__ 3. Questions (Answers at the end of the lab):


- How many nodes did the RowGenerator operator run on?
- Did the RowGenerator operator (stage) run sequentially or in
parallel?
- Did the Peek operator (stage) run sequentially or in parallel?

6-8 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Run a job from the command line


__ 1. Without closing down DataStage Designer, log into the Server image as
root/master and open a terminal window.
__ 2. In the terminal change to the DSEngine directory:
/opt/IBM/InformationServer/Server/DSEngine
__ 3. Run dsenv to initialize the environment: . dsenv
__ 4. Run the dsjob command to list the projects: bin/dsjob -domain edserver.ibm.com
-user student -password student -server edserver.ibm.com -lprojects

Information

If you receive and error and the command syntax is displayed, then there is something
wrong with the syntax of the command you typed. If you receive a code of 80011, then the
syntax is OK, but there is a problem with one of the values entered for -domain or -user or
-password or -server.

__ 5. Run the dsjob command to list the jobs in DSProject: bin/dsjob -domain
edserver.ibm.com -user student -password -server edserver.ibm.com -ljobs
DSProject

__ 6. Run the dsjob command to run the GenRows_NumRows job. This is like the job
you ran earlier from the GUI, except that it has a parameter named NumRows
which determines how many rows are generated when the job runs. You will first run

Copyright IBM Corp. 2007, 2012 Exercise 6. Engine tier architecture 6-9
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

this command without specifying a value for the NumRows parameter. In this case,
the job will run with the default parameter value: bin/dsjob -domain
edserver.ibm.com -user student -password -server edserver.ibm.com -run
DSProject GenRows_NumRows

__ 7. Without closing anything down on the Server course image, return to Client image
and open the GenRows_NumRows job in DataStage Designer. Then click
View>Job log to open the job log for the job. Messages from the job run that you
initiated from the command line are displayed.

__ 8. Return to the Server image and then run the job again. This time specify a value for
the NumRows parameter, namely, 9999: bin/dsjob -domain edserver.ibm.com
-user student -password -server edserver.ibm.com -run -param
NumRows=9999 DSProject GenRows_NumRows. After you run the job, return to
the Client and look at the job log to verify that it ran. In particular, look for the
message that displays how many rows were output from the Row Generator stage:
Row_Generator_0,0: Output 0 produced 9999 records.
__ 9. Return to the Server image and run the dsjob -logsum command to retrieve the
messages from the job log to the command line: bin/dsjob -domain
edserver.ibm.com -user student -password student -server edserver.ibm.com
-logsum DSProject GenRows_NumRows. Be aware that the command may
return messages from more than one job run. The last run will be towards the end.

6-10 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 10. Run the command to generate a job report for the last run of GenRows_NumRows:
bin/dsjob -domain edserver.ibm.com -user student -password student -server
edserver.ibm.com -report DSProject GenRows_NumRows

Copyright IBM Corp. 2007, 2012 Exercise 6. Engine tier architecture 6-11
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Administer the Engine from the command line


__ 1. Run the dsadmin command to list the DataStage projects: bin/dsadmin -domain
edserver.ibm.com -user student -password student -server edserver.ibm.com
-listprojects
__ 2. Run the dsadmin command to list the environment variables in a specified
DataStage project: bin/dsadmin -domain edserver.ibm.com -user student
-password student -server edserver.ibm.com -listenv DSProject

6-12 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Use the DSXImportService command to list the contents


of a DataStage import (dsx) file
__ 1. On the Server image, open a terminal window and then enter the command to
change to the ASBNode/bin directory: cd
/opt/IBM/InformationServer/ASBNode/bin
__ 2. Enter the DSXImportService command to list the contents of the
ISAdminJobs.dsx file, which is in the /data/ISAdminFiles folder:
./DSXImportService.sh -List -DSXFile /data/ISAdminFiles/ISAdminJobs.dsx

__ 3. Optionally, run the same command from the Client system. The ISAdminJobs.dsx
file is in the c:\CourseData\ISAdminLabFiles directory. The
DSXImportService.bat file is in the c:\IBM\InformationServer\ASBNode\bin
directory.

Copyright IBM Corp. 2007, 2012 Exercise 6. Engine tier architecture 6-13
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Use the DSXImportService command to import a


DataStage import (dsx) file to another project
In this task, you will import the contents of the dsx file to a project named dstage1.
__ 1. Run the command to import the file whose contents you listed in the previous task:
./DSXImportService.sh -ISHost edserver.ibm.com -ISUser student
-ISPassword student -DSProject dstage1 -DSXFile
/data/ISAdminFiles/ISAdminJobs.dsx -Overwrite -Verbose. The -Overwrite
option is needed if the project contains the same objects that are in the import file.

6-14 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Answers to questions


Task: Examine the OSH and Score
Questions:
- What is the fastname for each? Why is the fastname the
same for both nodes? - Answer: Fastname is
edserver.ibm.com. It is the same because both nodes are on
the same computer system with the same network name.
- Are there any node pools? Are there named node pools?
Are there default node pools? - Answer: There are no named
node pools. Each node has a default node pool ().
- Are there any resource pools? Are they named? Is there a
default resource pool? - Answer: There are disk and scratch
disk resource default pools (). None are named.
Task: Examine the OSH and Score
Questions:
- How many nodes did the RowGenerator operator run on? -
One node.
- Did the RowGenerator operator (stage) run sequentially or
in parallel? - Sequentially, since it only ran on only one node.
- Did the Peek operator (stage) run sequentially or in
parallel? - The Peek operator ran in parallel, since it ran on two
nodes.

Copyright IBM Corp. 2007, 2012 Exercise 6. Engine tier architecture 6-15
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

6-16 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Exercise 7. Engine tier configuration

What this exercise is about


This exercise discusses Engine tier project configuration and data set
management. It also discusses how to configure DataStage jobs to
generate operational metadata.

What you should be able to do


At the end of this exercise, you should be able to:
Configure a DataStage project
View a data set using the Data Set Management tool
Manage data sets from the command line
Configure the Engine for operational metadata collection
Generate operational metadata
View an operational job run report
Use Multiple-Job Compile tool

Introduction
A DataStage administrator sets project defaults using the DataStage
Administrator client. These defaults can be overridden at the job level.
These include database, logging, and operational metadata collection
defaults.
Data sets are temporary files used temporarily landing data to disk.
These files are partitioned to support the parallel processing of data.
This unit discusses how to manage these files.

Requirements
A DataStage user ID named dsuser has been created. This user
ID was created in an earlier lab.

Copyright IBM Corp. 2007, 2012 Exercise 7. Engine tier configuration 7-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Configure DataStage projects

Task: Configure a DataStage project


__1. Log into DataStage Administrator as student/student.
__ 2. Click the Projects tab, and then select the DSProject project.
__ 3. Click Properties.
__ 4. On the General tab, enable job administration in Director, enable RCP but not for
new links, and set the project default to generate operational metadata for jobs.

__ 5. Click the Environment button. We have previously looked at a number of


environment variables. Here, we will look at the Reporting variables. This
determines what information goes into the job log when a job runs. Here, enable the

7-2 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty APT_STARTUP_STATUS variable to add extra startup messages in the log. Also
ensure that the APT_DUMP_SCORE variable is enabled.

__ 6. Click OK, and then go to the Permissions tab. Here you will add a DataStage user
named dsuser.

__ 7. Click the Add User or Group button.

Copyright IBM Corp. 2007, 2012 Exercise 7. Engine tier configuration 7-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 8. Select dsuser and then click Add.

__ 9. Click OK.
__ 10. Select the DataStage and QualityStage Developer role for dsuser.

7-4 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 11. Click the Sequence tab. Select all options.

__ 12. Click OK to save the changes.

Copyright IBM Corp. 2007, 2012 Exercise 7. Engine tier configuration 7-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Data Sets

Task: View a data set using the Data Set Management tool
In this task you will compile and run a job that creates a data set. Then you will use the
Data Set Management tool to view the data in the data set.
__1. In DataStage Designer, open the GenRows_DataSet job. This job writes rows of
test data to a persistent data set.

__ 2. Double-Click on the target stage to open it. Notice that it writes to a data set named
Testdata.ds in the ISAdminFiles directory.

__ 3. Click OK to close the stage.

7-6 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 4. Click the Compile button.


__ 5. Click the Run button, and complete the process to run the job.
__ 6. Click Tools>Data Set Management. Open the Testdata.ds data set file in your
/data/ISAdminFiles folder. Notice that it displays the number of rows of data
partitioned on each node.

__ 7. Click the Schema icon (second from left) to show the format of the data.

Copyright IBM Corp. 2007, 2012 Exercise 7. Engine tier configuration 7-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 8. Click the Data icon (third from left) to view the actual data. You can view all of the
data or view the data in just one of the partitions.

7-8 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Manage data sets from the command line


In this task you will manage the data set you examined in the previous task from the
system command line.
__1. In a terminal window on the Server image, change to the $DSHOME directory, that
is, /opt/IBM/InformationServer/Server/DSEngine.
__ 2. Enter gedit dsenv to open the dsenv file in a text editor. At the end of the file, notice
the line:
APT_CONFIG_FILE=/opt/IBM/InformationServer/Server/Configurations/default
.apt; export APT_CONFIG_FILE. This line has been added to the default dsenv
file. When the dsenv file is run, this line will initialize the $APT_CONFIG_FILE
environment variable.

__ 3. Run the dsenv file to initialize the DataStage environment: . dsenv


__ 4. Run the orchadmin command to get help about the command:
/opt/IBM/InformationServer/PXEngine/bin/orchadmin -help This will also verify
that the environment is correctly initialized.
__ 5. Run the orchadmin command to get information about a specified data set:
/opt/IBM/InformationServer/PXEngine/bin/orchadmin II
/data/ISAdminFiles/Testdata.ds

Copyright IBM Corp. 2007, 2012 Exercise 7. Engine tier configuration 7-9
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 6. View the output from the command. Notice the number of partitions in the data set
(2) and the number of records in each partition.

7-10 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Operational metadata

Task: Configure the Engine for operational metadata collection


__1. In an earlier task, you enabled the generation of operational metadata in DataStage
Administrator.
__ 2. On the Server image, open File Browser, and then change to the
/opt/IBM/InformationServer/ASBNode/conf directory.
__ 3. Locate the runimport.cfg file, and rename it to runimport.cfg.backup.
__ 4. Make a copy of the runimport.cfg.unix file, and rename the copy to runimport.cfg.
__ 5. Open the runimport.cfg file in a text editor using, for example, either gedit. Edit the
settings for User (student), Password (student), and
HostNameForAuthentication (edserver.ibm.com). Note the setting for
PortNumber.

__ 6. Examine the settings for LogDirectory and XSDdirectory. If necessary, change


them both to /opt/IBM/InformationServer/ASBNode/conf.
__ 7. Examine the setting for #SessionSucceededAction=rm -f $FILE. This action
removes the XML operational data files after they have been processed.
__ 8. Save the file and close the editor.

Copyright IBM Corp. 2007, 2012 Exercise 7. Engine tier configuration 7-11
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Generate operational metadata


__1. In DataStage Designer, open the GenRows_DataSet job.
__ 2. Click Run. In the Job Run Options window, click the General tab. Verify that the
Generate operational metadata box is checked.

__ 3. Click Run.
__ 4. In the Server image, in a terminal window change to the /ASBNode/bin directory:
cd /opt/IBM/InformationServer/ASBNode/bin
__ 5. Execute the RunImportStart.sh script: ./RunImportStart.sh. Notice that it
processes the XML file for the DataStage job that you ran.

7-12 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: View an operational job run report


__1. In the IS Web Console, click the Reporting tab. Then click Report
Templates>DataStage>View Report Templates.
__ 2. Select the JobRunInformation for selected JobRun template and then click New
Report.
__ 3. In the Report Settings, select the project (DSProject), the job run (last run for
GenRows_DataSet) and the output format (HTML).

__ 4. Click Save and Run Now.

Copyright IBM Corp. 2007, 2012 Exercise 7. Engine tier configuration 7-13
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 5. After it finishes running, view the report result.

7-14 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty DataStage batch compile

Task: Use Multiple-Job Compile tool


__1. In DataStage Designer, click Tools>Multiple Job Compile.
__ 2. On the Selection Criteria window, you can specify what types of jobs to compile
and other options.

Copyright IBM Corp. 2007, 2012 Exercise 7. Engine tier configuration 7-15
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 3. Click Next. Here you can add and remove specific jobs from the compile. (Note: the
specific jobs you see on your system may not match exactly what you see here.)

7-16 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 4. Click Next a couple of times to move to the Compile Process window. Here you
can see the jobs that are queued up to be compiled. We would click the Start
Compile button to begin the batch compile. However, here we will just cancel out.

__ 5. Click Cancel.

Copyright IBM Corp. 2007, 2012 Exercise 7. Engine tier configuration 7-17
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

7-18 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Exercise 8. Engine tier connectivity

What this exercise is about


Database connectivity for Information Server hosted products is
established and configured in the Engine. This includes native
database connectivity as well as ODBC connectivity. This unit
discusses how to set up this connectivity.

What you should be able to do


At the end of this exercise, you should be able to:
Enable a DataStage project to access DB2
Globally enable access to DB2
Setup ODBC data source connections
Test ODBC connectivity using the dssh command on the Server
Test ODBC connectivity using DataStage Designer client import
utility

Introduction
In order to establish connectivity to DB2 it is necessary to set the
LD_LIBRARY_PATH environment variable to point to the DB2 library.
This can be done for a DataStage project using DataStage
Administrator, but it is necessary to edit the dsenv file to establish
these settings globally for all Information Server products and
components.
ODBC connectivity is also established and configured in the Engine.
This involves editing two files: .odbc.ini and uvodbc.config.

Requirements
No new requirements.

Copyright IBM Corp. 2007, 2012 Exercise 8. Engine tier connectivity 8-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Enable a DataStage project to access DB2


__ 1. Log into DataStage Administrator, and then click the Projects tab.
__ 2. Select DSProject, and then click Properties.
__ 3. Click the Environment button.
__ 4. Select the General folder.
__ 5. Examine the LD_LIBRARY_PATH variable. Notice that it contains a path to the DB2
library. Although this is something that has already been done for you, this setting is
necessary for native DB2 access.

__ 6. Select the Operator Specific folder. Examine APT_DB2INSTANCE_HOME and


APT_DBNAME. These variables are specific to DB2. The former identifies the DB2
instance home directory. The latter specifies a default DB2 database for access in
DataStage jobs.

8-2 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Globally enable access to DB2


__ 1. Log into the Server image as root/master.
__ 2. In File Browser or a terminal window, move to the $DSENGINE directory, namely,
/opt/IBM/InformationServer/Server/DSEngine.
__ 3. Open dsenv in a text editor, for example gedit.
__ 4. Locate the $LD_LIBRARY_PATH setting. Notice the DB2 library path that has been
added. This is the same as what was added in the DataStage Administrator client,
but this setting applies universally across all DataStage projects and for other
Information Server products that use these settings when defining database
connections, such as FastTrack.

Copyright IBM Corp. 2007, 2012 Exercise 8. Engine tier connectivity 8-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Setup ODBC data source connections


__ 1. Open a terminal window.
__ 2. Change to the DataStage home directory: cd
/opt/IBM/InformationServer/Server/DSEngine
__ 3. Enter gedit .odbc.ini to open the .odbc.ini file in the gedit text editor.
__ 4. Copy and paste the DB2 Wire Protocol sample entry. Modify it to connect to the DB2
SAMPLE database. Name it SAMPLE2 to distinguish it from the existing SAMPLE
data source name. Modify the attributes as shown. Here, we have edited the
Database (SAMPLE), IpAddress (EDSERVER.IBM.COM), LogonID (db2inst1),
Password (db2inst1), and TcpPort (50000) attributes. Also remove the Location
and Collection entries, which are not used for DB2 UDB. Also leave the Package
value blank.

__ 5. Scroll to the top of the file and add an entry for SAMPLE2: SAMPLE2=DB2
SAMPLE database
__ 6. Save and close.
__ 7. Change to the /opt/IBM/InformationServer/Server/Projects/DSProject project
directory. Open the uvodbc.config file in a text editor, for instance gedit.

8-4 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 8. Create an entry for SAMPLE2.

__ 9. Save and close the file.

Copyright IBM Corp. 2007, 2012 Exercise 8. Engine tier connectivity 8-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Test ODBC connectivity using the dssh command on the


Server
__ 1. Change to the DataStage /opt/IBM/InformationServer/Server/DSEngine directory.
__ 2. Run the dsenv file to initialize the DataStage environment: . ./dsenv
__ 3. Run the dssh command: ./bin/dssh

__ 4. At the dssh prompt, log into DSProject: LOGTO DSProject


__ 5. At the dssh prompt, enter DS_CONNECT to retrieve a list of data sources from
uvodb.config. Verify that SAMPLE2 is included.

__ 6. See if you can connect to the SAMPLE2 data source: DS_CONNECT SAMPLE2.
You can connect using db2inst1 / db2inst1 If the SAMPLE2 prompt is returned,
then you are connected..

8-6 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 7. Enter quit to quit the SAMPLE2 connection to move to the SQL prompt. Enter
Ctrl-C followed by Q to return to the system prompt.

Copyright IBM Corp. 2007, 2012 Exercise 8. Engine tier connectivity 8-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Test ODBC connectivity using DataStage Designer client


import utility
__ 1. In the Client system, log into DataStage Designer.
__ 2. Click Import>Table Definitions>ODBC Table Definitions.
__ 3. Select SAMPLE2 in the DSN list. (If it does not show up, there may be an issue with
your ODBC setup.)
__ 4. Specify the user name and password (db2inst1 / db2inst1), and then click OK. If
you get a list of tables, then your ODBC setup is working.

8-8 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Exercise 9. Engine tier monitoring

What this exercise is about


This exercise covers the monitoring of running DataStage jobs in
Director, and the monitoring of DataStage jobs in the DataStage and
QualityStage Operations Console. It also discusses how to monitor the
performance of jobs using the Performance Analyzer, and monitoring
job resource usage using the Resource Estimator tool.

What you should be able to do


At the end of this exercise, you should be able to:
Monitor jobs in DataStage Director
Start the Operations Console services
Monitor jobs using the DataStage Operations Console
Explore Workload Manager
Use Performance Analyzer to analyze the performance of a job
Estimate the resources of a job

Introduction
There are several ways to monitor DataStage jobs as they are
running. The DataStage Designer and Director clients can be used to
view the logs and status of running jobs and to display performance
statistics.
The DataStage and QualityStage Operations Console can be used to
monitor running DataStage jobs across all projects and engines. You
can also use it to monitor system resources (memory, CPU) while the
jobs are running.
Workload Manager enables you to control the maximum number of
jobs running at one time, and to prioritize which jobs run when the
maximum is reached.

Requirements
No new requirements.

Copyright IBM Corp. 2007, 2012 Exercise 9. Engine tier monitoring 9-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Monitor jobs in DataStage Director


__ 1. Log into the DataStage Director client. The procedure is the same as for logging into
DataStage Designer. Select the DSProject>_Training_ISAdmin>Jobs folder. In
the Status window, select the job sequence named seqJobs.

__ 2. Click the Run Now icon in the toolbar (triangle facing to the right). When prompted,
enter 100,000 (without the commas) for each of the RecCount job parameters.
These values are passed to the individual jobs running in the sequence. Then click
Run.
__ 3. Watch the status of seqJobs change to Running and then to Finished. Also notice
the status changes for each of the individual jobs running in the sequence:
seqJob1, seqJob2, seqJob3.
__ 4. With seqJobs selected, click the Log icon in the toolbar (fifth from the left). This
displays the messages from the job sequence, but not the individual jobs running in

9-2 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty the sequence. Examine the messages in the log that indicate when each job in the
sequence starts, when it finishes, and what its status is when it finishes.

__ 5. Open the message near the end labeled Summary of sequence run. This gives a
summary of what happens during the sequence run.
__ 6. Click the Status icon (third from the left) to return to the Status View window. Select
seqJob1 and then click the Log icon. This displays the messages for seqJob1
when it is run by the sequence.

Copyright IBM Corp. 2007, 2012 Exercise 9. Engine tier monitoring 9-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Operations Console

Task: Start the Operations Console services


__ 1. Log into the Server image as root/master. Open a terminal window. Then change to
the /opt/IBM/InformationServer/Server/DSODB directory. Open the
DSODBConfig.cfg file in a text editor, for example, gedit. Notice the setting for
DSODBON towards the top of the file. This should be set to DSODBON=1, meaning
that data collection is enabled. After exploring this file, close it.
__ 2. Change to the DSODB/bin directory. This directory contains the DSAppWatcher.sh
script.
__ 3. Run the DSAppWatcher.sh status command: ./DSAppWatcher.sh -status
__ 4. If the services are stopped, start them up: ./DSAppWatcher.sh -start

__ 5. Run the -status command again to verify that the services are running.

9-4 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty Task: Monitor jobs using the DataStage Operations Console


__ 1. On the Windows Client, open Internet Explorer and then enter the following IP
address: http://edserver.ibm.com:9080/ibm/iis/ds/console/login.html
__ 2. Log into the Console as student/student. The Dashboard tab is displayed. Explore
the different sections of the Dashboard.
__ a. The Job Activity section monitors job activity: Jobs running within the current
time range and summaries of jobs recently completed. Notice that you can click
on the Last: N minutes links to specify the time range.
__ b. The Operating System Resources section displays the CPU usage and the
amount of available memory during the specified time range.
__ c. The Engine Status section specifies the status of the Operations Console
services (all should be running), and general properties of the engine.
__ d. To the right of each section heading is a refresh icon. Use it to refresh the display
for the most current information.
__ 3. Click on the Projects tab. This displays information about each of the DataStage
projects on the Engine.
__ a. Notice in the top right corner that the projects displayed are for the
EDSERVER.IBM.COM engine. If there is more than one engine in the domain,
you can select the engine here.
__ b. Notice in the top right corner there is a Project Filter button. Click on this button
to select the projects you want displayed. For now continue to display all
projects.
__ 4. Click on the DSProject folder in the Navigation section. This displays information
about that project. This information includes values for the environment variables.
__ 5. Expand the DSProject folder and then select seqJobs. This displays information
about the job sequence, including information about its previous job runs.

Copyright IBM Corp. 2007, 2012 Exercise 9. Engine tier monitoring 9-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 6. Click on the View Job Design button towards the top of the window to view the job
design.
__ 7. Click the Run button. The Run Job window is displayed. Here, you can edit the
values of the job parameters. Here, accept the defaults.
__ 8. Click Run to start the job sequence. Then click the Dashboard tab.
__ 9. Click on the Refresh icons in the Job Activity section. You should see information
about the last run of the seqJobs job sequence you ran earlier. Notice that four jobs
finished. And notice that job run activity and CPU usage spiked at the time the jobs
ran.

9-6 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 10. Click on the Finished: 4 link. This lists the jobs that ran: The job sequence
(seqJobs) and the three jobs running in the job sequence (seqJob1,
seqJob2,seqJob3).

__ 11. Return to the Projects tab. Click the Refresh icon. Notice that the last run of
seqJobs is listed. Select the last run, and then click View Details. The Run Details
window is displayed.
__ 12. Click the Log Messages tab. Select the Full Messages box. This displays all the
messages in the job log for this run.
__ 13. Click on the Activity tab. Notice that this displays information about the recent job
activity.

Copyright IBM Corp. 2007, 2012 Exercise 9. Engine tier monitoring 9-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Explore Workload Manager


__ 1. Log into the Server image as root/master. Open a terminal window. Then change to
the /opt/IBM/InformationServer/Server/DSODB directory. Open the
DSODBConfig.cfg file in a text editor, for example, gedit. Notice the setting for
WLMON towards the end of the file. The setting is WLMON=1, meaning that
workload management is enabled.
__ 2. Log into DataStage Administrator. On the Projects tab, select DSProject and then
click Properties.
__ 3. Notice the Workload management section at the bottom of the General tab. The
default workload queue is set to the default: WLM default (Medium PriorityJobs).
__ 4. Log into the Operations Console as student/student.
__ 5. Click the Workload Management tab. Set the Job Count parameter to 1. This is, of
course, a very low number. It restricts the number of running jobs to 1. Then click
Apply.
__ 6. On the Projects tab, select and run seqJob1, then seqJob2, then seqJob3 in the
DSProject>_Training_ISAdmin>Jobs folder. For the first, set the RecCount
parameter to 1000000.
__ 7. Click the Activity tab. Refresh. Notice your queued and running jobs. seqJob2 and
seqJob3 are queued, waiting for seqJob1 to finish. This is because we set the Job
Count parameter to run only one job at a time.

9-8 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 8. Click on the Workload Management tab. Notice that there are jobs waiting in the
Medium Priority Jobs queue.

__ 9. Change the Job Count parameter to 20, and then click Apply.

Copyright IBM Corp. 2007, 2012 Exercise 9. Engine tier monitoring 9-9
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Performance Analysis

Task: Analyze the performance of a job


__ 1. In DataStage Designer, open the admin_RunPerf job.

__ 2. Click on the Job Properties in the toolbar. Then the Execution tab. Select Record
job performance data (if it has not been selected already).

__ 3. Click the Compile icon in the toolbar (just under the Window menu). It should
compile without errors.

9-10 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty __ 4. Close the Compile Job window and then click the Run icon in the toolbar (next to
the Compile icon. Pass 2000000 to the NumRows job parameter (the default).
Then click Run. As the job runs, the links on the canvas will change colors, and
runtime statistics will be displayed.
__ 5. Click on the Performance Analysis icon in the toolbar (third icon after the compile
icon). A message is displayed indicating that the operational metadata is being
harvested. Afterwards, the Performance Analysis window is opened and
displayed.
__ 6. Open the Charts folder and select Job Timeline (the default chart). Click on the
Partition 0 tab (the default tab) and view the timeline in partition 0. Notice which
stages ran for the duration of the job (or almost to it) and those that finished earlier.

__ 7. Click on the Partition 1 tab. Notice that the Row Generator stages are not displayed
because, since Row Generators run sequentially, they are not running in Partition 1.
__ 8. Click on the Partition 0 tab. Open the Stages folder. Select just the first Generator,
the Sort, and the Transformer stages.

Copyright IBM Corp. 2007, 2012 Exercise 9. Engine tier monitoring 9-11
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 9. Open the Filters folder. Deselect each box one at a time and examine the effect on
the chart. Shown below is the effect of deselecting the Hide Startup Phases box.
This shows the startup phases includes the deletion of any existing data sets that
will be overwritten.

__ 10. Open up the Charts folder. Click on the Record Throughput chart. Each line
represents the throughput (rows/second) of a particular stage in the job. Place the

9-12 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty mouse cursor over a line at a particular point to display the name of the stage and
the throughput at that point.

__ 11. Click on the Percentage CPU Time By Stage chart in the CPU Utilization folder.
Notice that the Generator and Funnel stages use very little CPU compared to the
other stages in the job.

__ 12. Explore other charts. When you are done, close the Performance Analyzer window.

Copyright IBM Corp. 2007, 2012 Exercise 9. Engine tier monitoring 9-13
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Estimate the resources of a job


__ 1. Open the admin_Resouce_Est_03 job in Designer. Compile the job.
__ 2. Click on the Resource Estimation icon (next to Performance Analysis icon).
When prompted, click Run. Some preprocessing occurs and then the Job Run
Options window opens a second time.
__ 3. Click Run again to generate the static model. The Resource Estimation window is
displayed. In the left hand Models section you see the existing models. Notice the
static model that is automatically generated for your job when you open the
Resource Estimation window. Notice that the sampling type for the static model is
Auto.

__ 4. Click on the Input Projections folder. This displays the total input for each of the
three Row Generator stage inputs.

__ 5. Click on the Job Tree folder. This displays the resource utilization of the various
stages in the job. Notice in particular the scratch usage for the Sort stage, the input

9-14 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V5.4
Student Exercises

EXempty data size for the Row Generator stages, and the disk space for the Data Set stages
(DataSetOut1.ds, DataSetOut2.ds).

Information

Do not confuse DataSet1 and DataSet2 in the previous graphic with the output data sets
created in the ISAdminFiles directory. The former are in memory data sets used to move
data between DataStage operators.

__ 6. Click on the Stages folder. Select a few of the stages, one at a time. Shown below is
the Sort stage. Notice the estimate of scratch disk usage and the size of the data
going in and out of the stage.

Copyright IBM Corp. 2007, 2012 Exercise 9. Engine tier monitoring 9-15
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 7. Click on the Charts folder. Select a few of the charts, one at a time. Shown below is
the Disk Requirements chart. This estimates the amount of disk space needed for
the output data sets.

__ 8. Close the Resource Estimation tool.

9-16 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty Exercise 10.Metadata asset management

What this exercise is about


This exercise covers metadata asset management. The Metadata
Repository contains metadata produced and consumed by Information
Server products. A number of tools exist for managing these
metadata. The istool command-line interface can be used to import,
export, and package metadata assets produced by Information Server
products. Information Server Manager provides a GUI interface with
respect to DataStage metadata.
Metadata Asset Manager can be used to import and manage BI
metadata consumed by Information Server products.

What you should be able to do


At the end of this exercise, you should be able to:
Export DataStage assets using istool
Import assets using istool
Export security assets using istool
Create, build, and deploy a package using Information Server
Manager
Export assets using Information Server Manager
View the DataStage assets in an existing archive
Import metadata assets using Metadata Asset Manager
View metadata assets using Metadata Asset Manager
Manage duplicates

Introduction
In this lab, you will export metadata assets using istool. You will then
package and deploy DataStage assets using Information Server
Manager. You will import and explore BI metadata using Metadata
Asset Manager.

Copyright IBM Corp. 2007, 2012 Exercise 10. Metadata asset management 10-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Requirements
Your ISAdminFiles directory on the Client contains the RTGS.xml
file.

10-2 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty Asset interchange using istool

Task: Export DataStage assets using istool


__ 1. On the client system, click the desktop icon to open the IS Command Line Interface.

__ 2. Build an istool command to export all the DataStage parallel jobs in the
_Training_ISAdmin/Jobs folder in the DSProject DataStage project to a file named
DSProject_Training.isx in the CourseData\ISAdminFiles folder on the client
system. The completed command is: istool export -domain edserver:9080
-username student -password student -archive
c:\CourseData\ISAdminFiles\DSProject_Training.isx -datastage
edserver.ibm.com/DSProject/_Training_ISAdmin/Jobs/*.pjb In the command
you will need the following:
a. istool export command
b. domain parameter: edserver:9080
c. username and password parameters
d. archive parameter to specify the path to the exported archive
file

Copyright IBM Corp. 2007, 2012 Exercise 10. Metadata asset management 10-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

e. datastage parameter in which you specify the objects to


export

Information

It may be easier to build the command if you open a text document, build the command in
the text document, and then paste the command into the istool command window. Also, be
aware that the exported contents displayed in the graphic here, and in future graphics, may
differ somewhat from your exported contents.

10-4 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty Task: Import assets using istool


__ 1. Import the file you created in the previous task into another DataStage project
named dstage1. The completed command is: istool import -domain
edserver:9080 -username student -password student -archive
c:\CourseData\ISAdminFiles\DSProject_Training.isx -replace -datastage
edserver.ibm.com/dstage1 Here you will need:
a. Istool import command
b. domain parameter: edserver:9080
c. username and password parameters
d. archive parameter to specify the path to the archive file
e. replace option to overwrite existing assets
f. datastage parameter in which you specify the DataStage
project (dstage1) to import the assets into

Copyright IBM Corp. 2007, 2012 Exercise 10. Metadata asset management 10-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Export security assets using istool


__ 1. Export the roles and credentials of user student to a file named IS_Users.isx:
a. Istool export command
b. domain parameter: edserver:9080
c. username and password parameters. Use isadmin /
isadmin
d. archive parameter to specify the path to the exported archive
file
e. security parameter in which to specify the user and
parameters. Within the -security quotes use the
-securityUser, -userident, -includeCredential, and
-includeRoles parameters.

Information

The Common Metadata Importer Suite role is required to execute this command. Recall
that student has all Suite roles. The command will fail if isadmin is used, because
isadmin does not have the Common Metadata Importer Suite role.

10-6 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty Information Server Manager

Task: Create, build, and deploy a package using Information


Server Manager
__ 1. Click the desktop icon to open Information Server Manager. The edserver domain is
displayed in the left, Repository panel.

Information

If for some reason, the domain is not displayed, you can add it. To do so, right-click in the
Repository panel and then click Add Domain. In the Add Domain window, select the
edserver:9080 domain and specify an IS Administrator user ID and password (isadmin /
isadmin).

__ 2. In the Repository panel, expand the folders to expose the contents of the
_Training_ISAdmin>Jobs folder.
__ 3. Right-Click over the Packages icon towards the bottom of the Repository panel,
and then click New>Package to open a new package.

Copyright IBM Corp. 2007, 2012 Exercise 10. Metadata asset management 10-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 4. Drag the jobs from the _training_ISAdmin>Jobs folder to the package window.
Also drag the objects in the Metadata folder to the package window.
__ 5. Click Save. Name the package ISAdminPack.

__ 6. Click Build. Name the build ISAdmin_Build1.


__ 7. Remove one of the jobs in your package (your choice). This implies a change to the
package.
__ 8. Click Save and then Build again, and then complete the process to create a new
build named ISAdmin_Build2.
__ 9. Click on the History tab to view the different builds.
__ 10. Click Deploy to open the Deploy Package window. Select
EDSERVER.IBM.COM/dstage1 and your latest build.
__ 11. Click Cancel. We do not really want to deploy these assets.
__ 12. On the History tab, select your latest build. Then click your right mouse button, and
then click Compare with Previous Build.

10-8 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty Task: Export assets using Information Server Manager


__ 1. Select some of the jobs and metadata in your _Training_ISAdmin>Jobs folder.
__ 2. Right-click and then click Export. This creates an export archive in Information
Server Manager.

__ 3. Click Export. Save the archive in a file named ISAdmin_Archive1.isx in your


ISAdminFiles directory.

Copyright IBM Corp. 2007, 2012 Exercise 10. Metadata asset management 10-9
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: View the DataStage assets in an existing archive


__ 1. Select the DataStage folder in the Repository panel. Right-click and then select
Import.
__ 2. Select the DSProjectTraining.isx file you created in an earlier task. (Alternatively,
select the isx file you created in the previous task.)
__ 3. View the contents of the archive file in the Import Archive panel.

10-10 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty Task: Import metadata assets using InfoSphere Metadata Asset


Manager (IMAM)
__ 1. Open Internet Explorer and enter the IMAM address:
http://edserver.ibm.com:9080/ibm/imam/console
__ 2. Log into IMAM with a user ID that has Common Metadata Administrator role,
namely, student/student. Note that isadmin does not have this role.
__ 3. In Metadata Asset Manager, click on the Administration tab. Notice that two
metadata interchange servers are defined: EDCLIENT and edserver.ibm.com.
EDCLIENT is the host name of the course client image.
__ 4. Click Import Settings in the Navigation panel. Here you can configure the settings
for import. Notice that the Allow imports that contain duplicate assets to be
shared to the repository setting is not enabled. For now, leave these settings
unchanged.
__ 5. Click the Import tab. Then click New Import Area.
__ a. Type ISAdmin in the Import area name box.
__ b. Select EDCLIENT in the Metadata interchange server box.
__ c. Expand the CA Technologies folder and then select the CA ERwin 4 Data
Modeler bridge.

__ 6. Click Next to move to the Import Parameters window. Select the RTGS.xml file in
the c:\CourseData\ISAdminFiles directory.

Copyright IBM Corp. 2007, 2012 Exercise 10. Metadata asset management 10-11
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 7. Click Next to move to the Identity Parameters window. Type RTGS in the Model
namespace box.
__ 8. Click Next to move to the Create New Import Area window. Select Managed
Import. Then click Import.

__ 9. Click OK to view the results in the staging area. Expand and view the imported
assets in the right panel.

__ 10. Notice that the Share to Repository button is disabled. Click the Analyze button to
find out why. According to the analysis, the metadata cannot be shared or previewed
because it contains duplicates. Recall that the import settings prevented the import
of duplicates.
__ 11. Return to the Administration tab and then click Import Settings. Select Allow
imports that contain duplicate assets to be shared to the repository. Then click
Save.
__ 12. Return to the Import tab and then click the Reimport button. Move through the
windows as you did before. When you reach the end, click the Analyze button. You
get the same warning about duplicates, but you are not prevented from sharing the
metadata.

10-12 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty __ 13. Click Preview.

__ 14. Click Share to Repository.

Copyright IBM Corp. 2007, 2012 Exercise 10. Metadata asset management 10-13
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: View metadata assets using Metadata Asset Manager


__ 1. Click the Repository Management tab.
__ 2. Expand the Browse Assets folder. Then click the Implemented Data Resources
folder. A single Host named EDSERVER.IBM.COM is shown. When you expand the
folder you will notice that it does not own any databases in the Repository. Select
the Host to display information about it in the right panel.

__ 3. Click on the Logical Data Models folder. Then select and expand the Basic folder.
Notice the information displayed about it in the right panel. Explore the data model
by expanding its contained data models and subject areas.

__ 4. Click on the Physical Data Models folder. Explore the Basic physical data model
and a couple of its design tables.

10-14 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty Task: Manage duplicates


__ 1. Expand the Manage Potential Duplicates folder in the Navigation panel. Then
select Logical Data Models.
__ 2. Click the View Potential Duplicates link next to the Logical relationship icon.
__ 3. Expand the contains - is part of folder. You can select items that appear to be
duplicates to get additional information. For now, do not delete any of these assets.

Copyright IBM Corp. 2007, 2012 Exercise 10. Metadata asset management 10-15
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

10-16 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty Exercise 11.Information Services Console


configuration

What this exercise is about


This exercise covers product configuration for Information Analyzer
and Information Services Director, which are both accessible through
the Information Server Console.

What you should be able to do


At the end of this exercise, you should be able to:
Configure Information Analyzer settings
Configure an Information Analyzer data source
Import table definitions for source data tables
Create an Information Analyzer project
Configure an information services application

Introduction
In the first few tasks you will configure Information Analyzer, which
involves creating an Information Analyzer project and configuring the
Engine and data source settings. In the remaining tasks you will
configure Information Services Director, which involves creating an
information services project and creating an information services
application.

Requirements
No new requirements.

Copyright IBM Corp. 2007, 2012 Exercise 11. Information Services Console configuration 11-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Configuring Information Analyzer

Task: Configure Information Analyzer settings


__ 1. Log into the Information Server Console as student/student.
__ 2. Click Home>Configuration>Analysis Settings.
__ 3. In the Analysis Engine tab configure the DataStage Credentials settings. The
DataStage user ID and password to use are dsadm / dsadm.

__ 4. Click the Validate Settings button to check whether the setting is configured
properly.
__ 5. On the Analysis Database tab, note the settings that were configured during
installation.
__ 6. Click Validate Client Connection to check the client connections settings.

11-2 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty __ 7. Click Validate Engine Connection to check the engine connection settings.
__ 8. Click the Analysis Settings tab. There is no need to change any of these settings.
__ 9. Click the Save All button in the lower right portion of the screen.

Copyright IBM Corp. 2007, 2012 Exercise 11. Information Services Console configuration 11-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Configure an Information Analyzer data source


__ 1. Click Home>Configuration>Sources.
__ 2. Select the EDSERVER.IBM.COM host, and then click New Data Store. In the data
store Name box type SAMPLE. In the data connection Name box type SAMPLE. In
the Connector box, select ODBCConnector. In the Connection String box select
SAMPLE. The user name and password is db2inst1 / db2inst1.

__ 3. Click Connect. This checks the connection.


__ 4. Click Save and Close, and Close again to return to the Sources tab. You should
now see your new data store listed under the EDSERVER.IBM.COM host.

11-4 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty Task: Import table definitions for source data tables


__ 1. Click Home>MetaData Management>Import Metadata. Select the SAMPLE
database.

__ 2. Click the Identify Next Level option a couple of times, until you expand the
DB2INST1 tables.
__ 3. Select the EMPLOYEE table. Then click Import.
__ 4. After the import, you should see current dates in the Last Imported cells next to the
table.

Copyright IBM Corp. 2007, 2012 Exercise 11. Information Services Console configuration 11-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Create an Information Analyzer project


__ 1. Click HOME>My Home.
__ 2. Click New Project.
__ 3. Select Information Analyzer as the type of project. In the Name box, type
IAProject. Then click OK. This opens up a set of Project Properties sub-tabs.
__ 4. Click the Data Sources tab.

__ 5. Click the Add button (lower right).


__ 6. Expand the EDSERVER.IBM.COM host folder and then select SAMPLE.
__ 7. Click OK. This adds SAMPLE as one of IAProjects data sources.
__ 8. Click the Save All button. This initiates data source registration and generates
tables in the Information Analyzer database which will hold profiling data when
source column analysis jobs run.

11-6 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty __ 9. Click the Users tab. On this tab you can add additional users to your project. For this
lab, you do not need add any additional users.

__ 10. For any user, you can optionally add additional IA roles. In this lab, add the
Information Analyzer Data Steward and Information Analyzer Drill Down User
roles to student.

__ 11. Click Save All.

Copyright IBM Corp. 2007, 2012 Exercise 11. Information Services Console configuration 11-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Information Services Director configuration

Task: Configure a services application


__ 1. Log into the Information Server Console as student/student.
__ 2. Click Home.
__ 3. Click New Project to display the New Project window.
__ 4. Select Information Services in the Type box.
__ 5. Type ISDProject in the Name box, and then click OK.
__ 6. Click the Users tab. Select both project roles for the users.

__ 7. Click Develop>Information Services Application.


__ 8. On the Information Services Application tab, click New.

11-8 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty __ 9. In the Name box type ISDApp.

__ 10. Click Save Application.


__ 11. Click Home>Configuration>Information Services Connections. Select the
DSServer connection.

Copyright IBM Corp. 2007, 2012 Exercise 11. Information Services Console configuration 11-9
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 12. Click Open. Click Edit in the lower right corner. Type student in the User Name
box. Type student in the password box.

__ 13. Click Test to test the connection to the DataStage Server system.
__ 14. Click Save, Enable and Close from the Save menu in the lower right corner. ISD
application services can now use DataStage as a service provider.
__ 15. On the Information Services Connections tab, click New.
__ 16. Type DB2Server in the Connection Name box.
__ 17. Select DB2 or Federation Server in the Information Provider Type box.
__ 18. Select edserver.ibm.com in the Agent Host box.
__ 19. Type edserver.ibm.com in the Database Host box.
__ 20. Type 50000 in the Port box.

11-10 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty __ 21. Click Add in the Databases box. Type SAMPLE in the database name box. Type
db2inst1/db2inst1 for the user name and password. Afterwards, click OK.

__ 22. Click Test to check the connection.


__ 23. Click Save, Enable and Close from the Save menu in the lower right corner. ISD
application services can now use DB2 as a service provider.

Copyright IBM Corp. 2007, 2012 Exercise 11. Information Services Console configuration 11-11
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

11-12 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty Exercise 12.Installation, deployment, and recovery

What this exercise is about


This lab focuses on backup and recovery using the IS Recovery tool.

What you should be able to do


At the end of this exercise, you should be able to:
Put Information Server into maintenance mode
Use IS Recovery to backup Information Server
Use IS Recovery to restore Information Server
Take Information Server out of maintenance mode

Introduction
In this lab you backup Information Server and then learn how to
restore Information Server from the backup. Part of the process of
backing up Information Server involves first putting it in maintenance
mode. You will also learn how to do this, and will learn how to take
Information Server out of maintenance mode.

Requirements
No new requirements.

Copyright IBM Corp. 2007, 2012 Exercise 12. Installation, deployment, and recovery 12-1
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Put Information Server into maintenance mode


__ 1. Close any open Information Server clients.
__ 2. Log into DataStage Designer DSProject as student/student. This creates one
Information Server session.
__ 3. Log into the Information Server Web Console as isadmin/isadmin. This creates
another Information Server session.
__ 4. On the Administration tab, click Session Management>Active Sessions. You
should see two sessions: your current Web Console session and your DataStage
session.
__ 5. Log into the Linux Server image as root/master. Then open a terminal window.
__ 6. Enter the command to change to the /ASBServer/bin directory: cd
/opt/IBM/InformationServer/ASBServer/bin
__ 7. Enter the command to get the current maintenance mode: ./SessionAdmin.sh
-user isadmin -password isadmin -get-maint-mode

__ 8. Enter the command to close all user sessions: ./SessionAdmin.sh -user isadmin
-password isadmin -kill-user-sessions
__ 9. Return to the client image to confirm that the DataStage and Web Console sessions
were terminated.
__ 10. Enter the command to put Information Server in maintenance mode:
./SessionAdmin.sh -user isadmin -password isadmin -set-maint-mode ON

__ 11. Return to the client image and try to log into DataStage Designer as
student/student. If you are in maintenance mode, you will be unable to. You will
receive a message saying that the maximum number of sessions has been
reached...
__ 12. Try to log into the Information Server Web Console as isadmin/isadmin. You
should be able to. You can also log in as student/student, since student is also an
Information Server administrator.

12-2 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty Task: Use IS Recovery to backup Information Server


__ 1. In a terminal window, enter the command to change to the /Recovery/bin directory:
cd /opt/IBM/InformationServer/Recovery/bin
__ 2. Enter the isrecovery command: ./isrecovery.sh

__ 3. Open the link displayed in a browser. (You can right-click over the link and then click
Open Link.)

__ 4. Click the Get Started link under Backup. The Backup Wizard window is displayed.
Read the information provided under First Steps.

Copyright IBM Corp. 2007, 2012 Exercise 12. Installation, deployment, and recovery 12-3
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 5. Click Next to move to the Archive and Work Directories window. Examine the
default paths provided.

__ 6. Click Next to move to the InfoSphere Information Server Administrator


Credentials window. Specify the credentials for the IS administrator:
isadmin/isadmin.

__ 7. Click Next to move to the Metadata Repository Database Options window. Select
the Manual option to generate scripts for backing up the XMETA database.

12-4 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty __ 8. Click Next to move to the Information Analyzer Database Options window. Select
the Back up the InfoSphere Information Analyzer analysis database option and
Manual. We will let the program create the scripts for backing up this database.

__ 9. Click Next to move to the Engine Tier Credentials window. Enter the credentials
for the operating system user that owns the engine: dsadm/dsadm.

Copyright IBM Corp. 2007, 2012 Exercise 12. Installation, deployment, and recovery 12-5
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

__ 10. Click Next to move to the Additional Files to Back Up window. Temporarily select
the Back up additional files box. If this were an actual backup, you could then
select a text file that lists complete paths to the files to be backed up.

__ 11. Remove the check you made in the Back up additional files box. Then click Next
to move to the Response File window. Make a note of the name and location of the
response file that will be created.

__ 12. Click Next to create the response file.


__ 13. Click Finish.
__ 14. In a terminal window, enter the command to change to the /Recovery/bin directory:
cd /opt/IBM/InformationServer/Recovery/bin.

12-6 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty __ 15. Enter the command to backup Information Server using the recovery response file
you created: ./isrecovery.sh -resp
/opt/IBM/InformationServer/Recovery/recovery_backup.xml

__ 16. Explore the output from the ISRecovery command as it runs. Be aware that it will
take several minutes for this command to run.
__ 17. In the file browser, open up the /opt/IBM/InformationServer/Recovery folder. Then
open the todo.log file in a text editor.

__ 18. Open up the /Recovery/DatabaseSupport folder. Explore the database backup for
the Repository (in the Metadata/bin folder), but do not execute the script.
__ 19. Explore the IADB database backup (in the IA/bin folder), but do not execute the
script.

Copyright IBM Corp. 2007, 2012 Exercise 12. Installation, deployment, and recovery 12-7
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Use IS Recovery to restore Information Server


__ 1. Using File Browser, delete the contents of the
/opt/IBM/InforamationServer/Recovery/DatabaseSupport/Metadata and
/opt/IBM/InforamationServer/Recovery/DatabaseSupport/IA folders. These
folders need to be empty before you run the restore wizard.
__ 2. In a terminal window, enter the command to change to the /Recovery/bin directory:
cd /opt/IBM/InformationServer/Recovery/bin
__ 3. Enter the isrecovery command: ./isrecovery.sh

__ 4. Open the link displayed in a browser.

__ 5. Click the Get Started link under Restore. The Restore Wizard window is displayed.
Read the information provided under First Steps. It lists the major prerequisites for
performing a restore.
__ 6. Click Next to move to the Archive and Work Directories window. Here you identify
the archive and work directories you specified during the backup. Since you
accepted the defaults during the backup, you can accept the defaults during the
restore.
__ 7. Click Next to move to the Metadata Repository Database Options window. This is
the empty folder where the restore scripts for XMETA will be generated.
__ 8. Click Next to move to the Information Analyzer Database Options window. This is
the empty folder where the restore scripts for IADB will be generated.

12-8 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty __ 9. Click Next to move to the Engine Tier Credentials window. Type dsadm in the
User Name and Password boxes.
__ 10. Click Next to move to the InfoSphere DataStage Project Directories window.
Here you specify where the DataStage project directories are to be restored. In this
instance, accept the default.
__ 11. Click Next to move to the Response File window.
__ 12. Click Next to generate the response file and complete the process.
__ 13. Click Finish. Close down the web browser and terminal windows. Do not attempt to
execute the restore script.

Copyright IBM Corp. 2007, 2012 Exercise 12. Installation, deployment, and recovery 12-9
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Take Information Server out of maintenance mode


__ 1. Enter the command to change to the /ASBServer/bin directory: cd
/opt/IBM/InformationServer/ASBServer/bin
__ 2. In a terminal window, enter the command to take Information Server out of
maintenance mode: ./SessionAdmin.sh -user isadmin -password isadmin
-set-maint-mode OFF
__ 3. On the client image, verify that you can log into DataStage Designer as
student/student.

12-10 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty Exercise 13.Serviceability

What this exercise is about


ISA Lite is the primary tool you will use to provide IBM service
technicians with information about your Information Server system and
how it is configured.

What you should be able to do


At the end of this exercise, you should be able to:
View audit trace files on the Server
View audit trace files on the Client
Generate an ISA Lite Basic System summary Report
Generate an ISA Lite PX Engine Configuration Test Report

Introduction
In the first couple of tasks, you will view audit trace files available on
both the Server and Client systems. The information in these files
involves the Engine tier. In the remaining tasks you will learn how to
generate ISA Lite reports. You will generate two different types as
examples.

Requirements
No new requirements.

Copyright IBM Corp. 2007, 2012 Exercise 13. Serviceability 13-1


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: View audit trace files on the Server


__ 1. On the Server image, open a terminal window and then execute the command to
change to the /opt/IBM/InformationServer/Server/DSEngine directory: cd
/opt/IBM/InformationServer/Server/DSEngine
__ 2. Enter a command to open the DSAuditTrace.log file in a text editor: gedit
DSAuditTrace.log
__ 3. Scroll through the file. Notice that it contains messages about project creation and
deletion. The following shows the kind of information you will see.

13-2 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty Task: View audit trace files on the Client


__ 1. On the Client image, in Windows Explorer, open the Documents and
Settings>student>ds_logs folder. The folder contains a number of log files.
__ 2. Open the last few log files in Notepad and scroll through the messages. Notice in
this example that messages about compiled jobs are displayed.

Copyright IBM Corp. 2007, 2012 Exercise 13. Serviceability 13-3


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Generate an ISA Lite Basic System summary Report


__ 1. On the Server, open a terminal.
__ 2. Execute the command to change to the /opt/IBM/InformationServer/ISALite
directory: cd /opt/IBM/InformationServer/ISALite
__ 3. Execute the runISALite.sh script: ./runISALite.sh

__ 4. In the IBM Support Assistant Lite window, select the Basic System Summary
problem type from the Additional Collectors folder. In the Filename for saving
collected data box, specify the ISALite_BasicSystemSummary file in the
/data/ISAdminFiles directory.

__ 5. Click Collect Data. The IBM Support Assistant Lite Tool Input Dialog window is
displayed.
__ 6. Click OK in the IBM Support Assistant Lite Tool Input Dialog window. No need to
specify any values for these optional parameters.
__ 7. A window is displayed for entering the Information Server installation directory. You
can accept the default: /opt/IBM/InformationServer
__ 8. A window is displayed asking if you want to rename the file to the recommended
name. Click OK to accept the recommendation.

13-4 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1
Student Exercises

EXempty __ 9. A window is displayed when the summary analysis is complete. Click OK.
__ 10. A window is displayed asking you how the script should proceed. Select Do Not
Transfer the Logs and then click OK.
__ 11. In a file browser, open up the /data/ISAdminFiles directory. Right click over the
results .zip file and then click Extract Here.
__ 12. Open up the results folder, and then double-click on the SYSTEM-SUMMARY.html
file.

__ 13. Explore the information contained in the report. Include the following in your
exploration:
__ a. Version and Tiers installed
__ b. InfoSphere Information Server Products installed
__ c. Installation Variables

Copyright IBM Corp. 2007, 2012 Exercise 13. Serviceability 13-5


Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
Student Exercises

Task: Generate an ISA Lite PX Engine Configuration Test


Report
__ 1. Following the same procedure, generate a PX Engine Configuration Test report. It
is in the Additional Diagnostic Tools folder.

13-6 Information Server Administration v9.1 Copyright IBM Corp. 2007, 2012
Course materials may not be reproduced in whole or in part
without the prior written permission of IBM.
V7.0.1

backpg
Back page