Setting Up the VMWare Image

DataStage/QualityStage Fundamentals - Lab Exercise Environment Setup

Copyright IBM Corporation 2012 Page 1 of 26

IBM InfoSphere DataStage and QualityStage

Fundamentals Environment Setup

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



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



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



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



boot the image.

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



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.



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.



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.



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.



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.



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.



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.



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



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.



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.



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.



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



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.



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



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.



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.



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:



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



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



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

Setting Up the VMWare Image

Documents

vmware machine

vmware player

ibm infosphere datastage

network adapter

network settings

vmware workstation menu

virtual machine settings

memory setting