Configuring the environments

sgc030


The EJB CICS sample application task guide

Set up WebSphere Application Server 3.5 for Windows NT

WebSphere Application Server (WAS) Advanced Edition 3.5 for Windows NT provides the application environment used to develop and test enterprise bean applications on your workstation. WAS also provides the JNDI server capability required by the CICS TS 2.1 EJB server, and is required for the Web component of the CICS EJB Development Deployment tool.

The default installation of WAS provides all the function required to support the CICS TS 2.1 EJB server, but several preparatory tasks need to be completed to achieve a correctly working configuration. Prior to installing WAS for Windows NT you might need to:

  1. Configure a disconnected machine with a pingable IP address
  2. Create a user for WebSphere and DB2 UDB

Configure a disconnected machine with a pingable IP address

If you wish to use WebSphere Application Server on a workstation while it is not attached to a network, for example, on a notebook computer, you need to ensure that the MS Loopback Adapter is installed. This allows processes on a disconnected computer to communicate via TCP/IP in the absence of a network connection, and is required by WebSphere. You also need to install the Loopback Adapter if you are working with a computer which is connected to a network but which does not use a statically defined IP address.

If you are not able to ping your computer IP address successfully when disconnected from a network you need to install the MS Loopback adapter and configure TCP/IP for the adapter. You might need to have your Windows NT installation CD or drive available during this procedure.

    Install the MS Loopback adapter

  1. Choose Settings>Control Panel from the Start menu
  2. Open the Network control panel
  3. Choose the Adapters tab and click Add...
  4. Select MS Loopback Adapter from the network adapter list and click OK
  5. Click OK to accept the default Frame Type
  6. Follow instructions concerning any files that need to be read

    Configure TCP/IP for the MS Loopback Adapter

  7. Select MS Loopback adapter in the network components list on the adapters
  8. Select the Protocols tab and click on strong>Update
  9. Select TCP/IP from the Network Protocols list and click on Properties
  10. Choose MS Loopback Adapter from the Adapter drop down list and set the IP addresses:
    1. Select Specify an IP Address
    2. Set IP address to 10.0.0.1 (which is reserved for private use)
    3. Set Subnet Mask to 255.255.255.0
    4. No value is required for Default Gateway
    5. Click OK
  11. Restart your computer

    Verify the private IP address

  12. Start a Command Prompt
  13. Type ping 10.0.0.1 or ping hostname
  14. You should get a timed response from your pinged address even if you are not connected to any network

Create a user for WebSphere and DB2 UDB

The WebSphere, webserver and DB2 processes need to run under the permissions of a given user. It is recommended that you use the same user ID for your WebSphere installation as your workstation's logon password. This should contain 8 or fewer characters in order to avoid any possible compatibility issues with DB2 UDB. It is also recommended that the user name used to set up and run the CICS EJB sample application should have Adminstrator privileges. If your computer does not have a user defined which matches these requirements you need to to create one that does:
  1. From the Start Menu select Programs > Adminstrative Tools (Common) > User Manager
  2. Choose menu User->New User. Fill in the fields:
    Username: wsuser
    Full Name: WebSphere user
    Description: WebSphere user
    Password and Confirm Password: as you choose
    Ensure that only the Password Never Expires field is ticked.
  3. Click on Groups
  4. Select Administrators in the right hand list, press Add then OK
  5. Press OK on the User Manager panel
  6. Log off the user name you have been using
  7. Log on to Windows NT using the user name: wsuser

Install WebSphere Advanced Edition 3.5 for Windows NT

On completion of the preparations you are ready to install WAS AE 3.5. A typical installation of WAS AE 3.5 provides all the support you require, including the IBM HTTP Server and DB2 Universal Database, which are required to create the single node required to run the CICS EJB sample application. The IBM WebSphere InfoCenter is your first point of reference for any further information about Installing WebSphere Application Server.