You are on page 1of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

IBM InfoSphere
DataStage and
QualityStage
Fundamentals
Environment Setup
setup

Copyright IBM Corporation 2012

Page 1 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

Table of Contents
Table of Contents .......................................................................................... 2
How to set up the lab exercise environment............................................... 3
How to verify that Information Server is up and running ....................... 8
Debugging the Network Settings ............................................................... 10
Setting up ODBC Connection (QualityStage Fundamentals only) ......... 18
Setting up the Information Server / DataStage client programs ........... 20
How to Bring Up Information Server (when services are down) ............ 21
Starting the Metadata Repository Database (XMETA Database).................................... 21
Starting the Websphere Application Server...................................................................... 23
Start the ASB Agent........................................................................................................... 25

Copyright IBM Corporation 2012

Page 2 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

How to set up the lab exercise environment


Pre-requisites: DataStage/QualityStage Fundamentals SUSE VMWare image must
have been downloaded
1. Unzip the VMware image by running the .exe file to C:\ or another drive of your
choice. Make sure it has enough disk space.
2. Start VMWare Workstation or VMWare Player and point to the VMWare image.
The file you need to look for has .vmx extension.
3. The image will load in VMware Workstation or Player. The default settings should
look like this:

4. The network adapter should be set to Host-only. If it is set to anything else, you
must edit the virtual machine settings and select the Host-only option for the

Copyright IBM Corporation 2012

Page 3 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

network adapter.

5. You should reduce the memory setting to down to 2100 MB if your machine has
equal or less than 3 GB of physical memory installed.
6. In the VMware Workstation menu bar, open Edit > Virtual Network Editor

Copyright IBM Corporation 2012

Page 4 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

7. Highlight your VMnet1 Host-only adapter and set the Subnet IP to 192.168.26.0.
Click OK.

8. Power on the VMWare machine.


9. You should be prompted with the question if this VM was moved or copied.
Select I moved it.

10. The image will start to load. It will prompt for a license screen the first time you
boot up the image. You need to accept the license terms in order to continue to

Copyright IBM Corporation 2012

Page 5 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

boot the image.

11. Wait 5-8 minutes until the image and Information Server has fully started. The
services will start automatically.

Copyright IBM Corporation 2012

Page 6 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

12. Add a line in C:\WINDOWS\system32\drivers\etc\hosts file as follows:


192.168.26.10

infosrvr.bootcamp.image.com

infosrvr

This way you can use the host name infosrvr for host reference in addition to the
IP address.

Copyright IBM Corporation 2012

Page 7 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

How to verify that Information Server is up and running


1. Now you are ready to login to Information Serve (IS) Web Console and DS
clients from your host environment. Test that you can login successfully with all
the DS clients.
2. On your Client Machine (Windows host machine), open a new browser and go to
URL http://infosrvr:9080/ibm/iis/console/ to access the InfoSphere Information
Server Web Console. Then enter a Suite Administrator user ID and password. It
is also possible to use the SUSE machine IP address instead of the machine
name infosrvr.

Copyright IBM Corporation 2012

Page 8 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

3. Click Login. If you see the following window, Information Server is up and
running.

4. You can skip the next chapter Debugging the Network Settings if you can see
this window.

Copyright IBM Corporation 2012

Page 9 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

Debugging the Network Settings


1. Verify that you have configured the VMnet Adapter 1 (host-only) as described in
chapter 1.
2. Let SUSE start up until the login window appears.

3. Login as root and the password inf0sphere.


4. After the desktop appears, click Computer on the bottom left corner and select
Network Settings in the Recent Applications tab.

Copyright IBM Corporation 2012

Page 10 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

5. If the Network Settings are not part of the Recent Applications, click the Control
Center button.

6. Find Network Settings from the Hardware category.

Copyright IBM Corporation 2012

Page 11 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

7. If you see the screen below, go directly to Step 11. If you have a different IP or
only DHCP configured, continue on step 8:

8. If you see this screen below with IP address not configured, or setting of an IP
address different from 192.168.26.10, click the Edit button at the bottom.

Copyright IBM Corporation 2012

Page 12 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

9. Fill in the fields as shown here and click Next.

10. Click Next and OK to save configuration.


11. Now on your host OS (Windows XP), open Control Panel -> Network
Connections. Then open the Properties of VMWare Network Adapter VMNet1.

Copyright IBM Corporation 2012

Page 13 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

12. Select Internet Protocol (TCP/IP) and click the Properties button.

Copyright IBM Corporation 2012

Page 14 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

13. And you will see the window below and you need to set the fields as displayed
below. You need to choose an IP address in the same subnet as 192.168.26.10
but with a different IP address. For instance 192.168.26.100 in the picture below.

14. Click OK to save changes. And click OK on previous window to complete the
changes. You can close the Network Connections window.

Copyright IBM Corporation 2012

Page 15 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

15. To verify the network is set up correctly, first go to the SUSE Desktop and start
up a command line window by clicking on Computer and selecting GNOME
Terminal.

16. Execute command ping 192.168.26.100 to make sure you can communicate
with the Windows XP host. You should see the output of the ping command as
below.

Copyright IBM Corporation 2012

Page 16 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

17. Now go to the Windows XP host and open up a DOS command window and
execute command ping 192.168.26.10 to ensure the Windows XP host can
communicate with the SUSE VMWare image. You should see the output of the
ping command as below.

Copyright IBM Corporation 2012

Page 17 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

Setting up ODBC Connection (QualityStage Fundamentals only)


Execute the steps below for QualityStage Fundamentals only. This is not necessary
for DataStage Fundamentals.
1. Next, we need to set up an ODBC connection from the Windows host to the DB2
database QS for QualityStage labs. Click on Windows Start > Control Panel >
Administrative Tools > Data Sources (ODBC) > System DSN tab > Click Add

2. Select IBM DB2 Wire Protocol > Finish

Copyright IBM Corporation 2012

Page 18 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

3. Set the ODBC options as below, then click on the Test Connect button

4. Complete the fields User Name: db2admin / Password: inf0server

5. You must get the message Connection Established! before you click OK.
6. Do the same configuration under the User DSN tab.
7. Click OK in all the following screens to set and save the ODBC connection
settings.

Copyright IBM Corporation 2012

Page 19 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

Setting up the Information Server / DataStage client programs


Pre-requisites: The InfoSvr_Client_v8.7_Win.zip file containing Information
Server clients must have been downloaded.
If you have successfully completed all the steps to make your host and guest
systems communicating with each other, you can now install the IS 8.7 clients on
your Windows host.
1. Unzip the Information Server client package into C:\ or another drive of your
choice. Make sure it has enough disk space.
2. Go to the directory where the unzipped content is located and double click on
setup.exe.
3. Select the language and then login.
4. Run the installation following the instructions from the Installer until it finishes
successfully. Install only the necessary components/tools below:
- IBM InfoSphere DataStage
- IBM InfoSphere QualityStage

Copyright IBM Corporation 2012

Page 20 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

How to Bring Up Information Server (when services are down)


Starting the Metadata Repository Database (XMETA Database)
1. First, verify whether the DB2 database engine is up and running.
2. Click on Computer, and open GNOME Terminal

3. On the terminal type ps -fea |grep db2.


4. If you can see the process db2sysc then DB2 database is started.

Copyright IBM Corporation 2012

Page 21 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

5. If you cannot see the file db2sysc, it is necessary to start the database.
6. To do that, change the user to db2inst1 typing the follow command su db2inst1.
7. To start de DB2 Data base Type db2start.

8. When the process ends, type again ps -fea |grep db2 to verify you can see the
process db2sysc.

Copyright IBM Corporation 2012

Page 22 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

Starting the Websphere Application Server


1. First, verify whether WebSphere is up and running.
2. Click on Computer, and open GNOME Terminal
3. On the terminal type ps -ef | grep websphere.
4. If WebSphere is running, you will be able to see several processes as a result, as
below:

Copyright IBM Corporation 2012

Page 23 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

5. If WebSphere is down, this is the result you get:

6. In order to Start the WebSphere server, execute this command (This is a time
consuming process that takes more than a few minutes to complete):
/opt/IBM/WebSphere/AppServer/bin/startServer.sh server1
7. After initialization finishes successfully, verify again the result of this command: ps ef | grep websphere
8. In case you need to stop the WebSphere Application for some reason, execute the
command below:
/opt/IBM/WebSphere/AppServer/bin/stopServer.sh server1
9. The terminal will prompt you to enter user and password. Use the information below:
username: wasadmin
password: inf0server

Copyright IBM Corporation 2012

Page 24 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

Start the ASB Agent


1. First, on the Gnome terminal window, verify if the agent is running with the following
command : ps -ef | grep agent

2. If you see several processes with ASBNode as above, the agent is currently running

Copyright IBM Corporation 2012

Page 25 of 26

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

3. If you only see the statements below as a result, you need to execute the following
command to start ASBNode:
/opt/IBM/InformationServer/ASBNode/bin/NodeAgents.sh Start

4. In case you need to stop the ASBNode for some reason, execute the following
command:
/opt/IBM/InformationServer/ASBNode/bin/NodeAgents.sh Stop

Copyright IBM Corporation 2012

Page 26 of 26