IBM WebSphere Development Studio Client, Version 6.0, Installation Guide

Introduction

This installation guide applies to IBM^(R) WebSphere Development Studio Client, Version 6.0, which is available on CD and DVD, and can be installed on a PC workstation. To quickly get started with installing the product, follow these guidelines:

• See the Pre-installation notes to get more information before beginning the installation process. From here, you can follow the Workstation requirements to ensure your workstation will meet the specified requirements for using this product.
• For information on upgrading from a previous version, including upgrading from version 6.0 to version 6.0.1, see Migration, upgrade and coexistence issues and then Upgrades and Updates to learn how to go ahead with these updates.
• The WebSphere Development Studio Client Lite for iSeries technology preview is an optional feature of the WebSphere Development Studio Client and is made up of only the core development studio tools including edit, compile and debugging features. This results in a much faster application, with a smaller memory footprint. To install and learn about the Development Studio Client Lite technology preview, see Installing WebSphere Development Studio Client Lite for iSeries technology preview.

Figure 1. The IBM WebSphere Development Studio Client can be installed using 7 CDs or 1 DVD. Also included is a CD which includes the Classic Tools (CODE and VARPG), as well as one or more CDs for optional software.

The Readme file contains prerequisite information, limitations of the product, and information not included in the documentation. For information on migrating from WebSphere^(R) Development Studio Client Version 4.0, 5.0, 5.1, or 5.1.2, or from WebSphere Development Tools V5R1M0, see the Migration Guide before installing this product.

You might not have to read this installation guide if you want to do a typical installation on your workstation. The Read Me First booklet packaged with the CDs and DVD contains quick-start installation information. Read it before you install.

For the latest product information, see the Development Studio Client Web site.

This file is available in the following national languages:

Table 1. - National language availability for this install guide

You can find the latest version of this guide at ftp://ftp.software.ibm.com/as400/products/ad/wdt400/v601/manuals/install.html.

Contents

Introduction

Pre-installation notes

Workstation requirements

Migration, upgrade and coexistence issues

Installing WebSphere Development Studio Client

Starting Development Studio Client

Upgrades and Updates

Installing WebSphere Development Studio Client Lite for iSeries technology preview

Uninstalling WebSphere Development Studio Client

Notices

Pre-installation notes

Returning Users

If you already have WebSphere Development Studio Client installed and want to update to Version 6.0.1, it is not necessary to uninstall the existing software. The Rational Product Updater will update Development Studio Client to the current version on the Web. Consult Upgrades and Updates for details on using the Rational Product Updater. Otherwise, continue with this guide to follow the full installation process.

Installation Process

You need to log on as an administrator to install or uninstall the product on a workstation.

Your CD package contains a number of CDs and one DVD. The DVD contains our product, which contains the same functions as the Rational base product ( Rational Web Developer), adapted for the needs of iSeries programmers. There are other CDs in the package (for example, CODE and VisualAge RPG; DB2 Universal Database) that are not on the DVD. If you have a DVD reader and want to do a typical installation on your workstation, it is easier to install from the DVD.

Here is a brief summary of the installation process:

1. Ensure that your workstation meets the requirements described in the Hardware requirements and Software requirements sections below.
2. Insert Disk 1 (or the DVD) into the appropriate drive of your workstation.
3. If installation does not start automatically:
   1. Click Start, and then click Run.
   2. Type Y:setup, where Y is the CD or DVD drive letter. Press Enter.
4. Follow the on-screen instructions for WebSphere Development Studio Client, Version 6.0. If you are using the set of CDs, the InstallShield wizard periodically prompts you to switch disks. Depending on what optional components you select for installation, you might be asked to skip some disks; do not be alarmed. A typical installation should take about 40 minutes if you have the recommended hardware. It will take longer if you have less than the recommended memory or disk space.

   Note:

   Installation can take a long time because certain fix packs are installed automatically. Further fix packs might require Rational Product Updater. See Upgrades and Updates for more information.

5. If you have a workspace from a previous version of Development Studio Client, you will see a message saying "Please Wait...Completing the Install" when you start the product the first time.

Cooperative Development Environment (CODE) and VisualAge RPG are not included in this installation. If you want to install them, find the CODE and VisualAge RPG CD. You need to install CODE if you want to view your DDS source as it will appear on a screen. This enables you to see how Web settings will appear in your WebFacing applications before converting the source and running the application.

You cannot directly install the product to a LAN server. You can, however, copy the product files to a LAN server and launch the installation to a local machine. See Copying the product to a LAN server.

IBM Rational Software Development Platform

The IBM Rational^(R) Software Development Platform is a common development environment that is shared by the following products:

• WebSphere Development Studio Client for iSeries^(TM)
• WebSphere Development Studio Client Advanced Edition for iSeries
• Rational Application Developer
• Rational Web Developer
• Rational Software Architect
• Rational Software Modeler
• Rational Functional Tester
• Rational Performance Tester

If you install any of these products, the Rational Software Development Platform is automatically installed as part of the product. If you have more than one of these products installed, the development platform is installed only once. All of these products share the same workbench or integrated development environment, called the workbench, and each product adds function to the workbench by contributing plug-ins. A plug-in is a software module that adds function to an existing program or application.

Starting Rational and WebSphere software products

When you open the Start menu, regardless of what Rational or WebSphere product you have installed, the top-level menu entry will always be IBM Rational.

Depending on how many products you have installed, you will have a subfolder for each product under IBM Rational. If, for example, you have both Rational Functional Tester and Development Studio Client installed, you can see a subfolder for each of these. These subfolders contain links to product specific information (such as readme files), as well as a launchpoint for the workbench. The launchpoint has the name of the product (such as Development Studio Client), and it starts the workbench.

You can also start the workbench by clicking the Rational Software Development Platform option, under the IBM Rational menu.

Migration and coexistence

Be sure to read the section Upgrades and Updates if you already have at least one Rational or WebSphere product installed and you want to install Development Studio Client. It contains important information about release levels.

Table 2 illustrates what happens when you try to install more than one product that is built on the Rational Software Development Platform on the same machine. In the table, the vertical axis represents products already installed, while the horizontal axis represents products that you are attempting to install.

Products installed in sequence can either block, upgrade, or share with each other.

• Block: When you are blocked from installing a product (for example, if you have WebSphere Development Studio Client Advanced Edition installed, and you try to install Rational Web Developer or WebSphere Development Studio Client) you cannot install the second product while the first one is installed. This occurs when you try to install a product that offers less function than the one you currently have installed.
• Upgrade: When you install a product that contains all of the functional that your current product contains, as well as additional function (for example, if you have WebSphere Development Studio Client installed, and want to install WebSphere Development Studio Client Advanced Edition), you will be upgraded to the product with the higher functionality. The first product will be uninstalled, but the workspace that contains your work for the first product will remain in the same location.
• Share: When this occurs, more than one product shares the installation of the workbench. The second product extends the capabilities of an existing product without installing another copy of the workbench. So, for example, if you install Rational Performance Tester, and then you install WebSphere Development Studio Client, they will both share the same copy of the workbench, which will contain all the function that both Rational Performance Tester and WebSphere Development Studio Client offer. The help contains information about both products.

Table 2. The result of installing more than one product that is built on the Rational Software Development Platform.

Uninstallation

• Upgraded products: When a product is upgraded, it is removed and replaced by the higher-function product. If the newly upgraded product is subsequently uninstalled, the entire product is removed from the system. For example, if you install Rational Application Developer, then upgrade to Rational Software Architect, and later choose to uninstall Rational Software Architect, all plug-ins, including the common workbench, will be uninstalled - you will not revert back to Rational Application Developer. To use Rational Application Developer, you must reinstall it.
• Products that share: If you have two or more products installed in a sharing scenario, the workbench is left in place until the last product is uninstalled. For example, if you have Rational Application Developer and Rational Performance Tester installed, and you uninstall one of them, the other one (and the workbench) stay on your system.

The workbench is installed in the installation directory of the first product you install that uses the Rational Software Development Platform. It is not reinstalled with any other products, so if you upgrade your first product, you should not remove your first installation directory after the upgrade has completed, as it still contains the files for the workbench.

The Rational Software Development Platform Launchpad

When you run launchpad.exe or insert Disk 1 or the DVD into your disk drive, a launchpad opens from which you can install a number of products or components. These are located on the other CDs contained in the media package. Documentation (section in Figure 2) is located on Disk 1.

Figure 2. Installation launchpad

Table 3 can help you decide which products to install. You must install WebSphere Development Studio Client first. The launchpad stays on the screen while you install Development Studio Client. Afterwards, you can install additional components one at a time. (You can also install them in parallel, but it might be hard on your system.)

The links in the third column are to sections in the Rational Web Developer Installation Guide.

Table 3. Launchpad items

Launchpad item	Description	Link to more information
Core (section in the picture)
Install IBM WebSphere Development Studio Client	WebSphere Development Studio Client is an integrated development environment for developing, testing, debugging, and profiling iSeries applications.	This guide.
Optional (section in the picture)
Install WebSphere test environment V5.x	(Optional) This test environment allows you to test J2EE applications in a local instance of WebSphere Application Server V5.x.	Installing WebSphere Application Server 5.x as an integrated test environment
Install Agent Controller	(Optional) Agent Controller is a daemon that provides application data to local or remote testing and profiling tools such as the Rational Developer products. Also helps with remote deployment.	Installing Agent Controller

National Language Support

The product installs one language according to the user locale setting in Microsoft Windows. If you change the locale after the installation is complete, product components and help screens might not display the correct language. To change languages, completely uninstall the product as described in the Uninstalling WebSphere Development Studio Client section, change the locale, and then install the product again.

Workstation requirements

Hardware requirements

Development Studio Client requires the following hardware:

• Processor: Intel Pentium III (800 MHz or faster processor recommended)
• Display: 1024 x 768 minimum resolution
• CD or DVD drive
• Mouse or other pointing device
• Appropriate communication adapters (like an Ethernet card; as supported by the workstation operating system) for TCP/IP communication
• The following memory and disk requirements:

Additional disk space is needed if the electronic image to install WebSphere Development Studio Client is downloaded. Also, additional disk space is required for the resources that you develop. Disk space requirements can be reduced if optional features and runtime environments are not installed. If your disk is formatted with a FAT32 file system instead of NTFS, more space is required. The many small files can use disk space inefficiently due to the disk blocking structure that FAT32 uses.

If you want to use the WebSphere Development Studio Client Lite for iSeries technology preview, a minimum of only 256 MB of RAM is necessary. However, it requires an additional 400 MB of disk space.

Table 4. - Hardware requirements

	Minimum	Recommended
Memory	768 MB for WebSphere Development Studio Client 256 MB for WebSphere Development Studio Client Lite for iSeries technology preview	1.0 GB (required when using the WebSphere Application Server test environment)
Permanent disk space	3.5 GB 3.9 GB for WebSphere Development Studio Client Lite for iSeries technology preview	4.5 GB for WebSphere Development Studio Client
Temporary disk space needed during product installation	1 GB in the installation directory 800 MB in a temporary directory	1 GB in the installation directory 800 MB in a temporary directory

Temporary space

Because the product needs extra temporary space during installation, you can change the default drive for temporary space to another drive.

To move your temporary space:

1. Open the Control Panel.
2. Double-click the System icon and go to Advanced > Environment Variables.
3. Under System Variables, select TEMP and click edit.
4. For the Variable Value field, enter D:\temp, or whichever drive you want to use for temporary storage.
5. Click OK.
6. Repeat steps 3-5 for the TMP variable.

Software requirements

WebSphere Development Studio Client, Version 6.0, can be installed on Microsoft Windows 2000 and Windows XP. It cannot be installed on Windows 95, Windows 98, Windows NT, or Windows Me.

The product requires one of the operating systems in Table 5 and the other software in Table 6.

Table 5. Operating system requirements

Table 6. Other software requirements

Migration, upgrade and coexistence issues

You can migrate from WebSphere Development Studio Client V4.x.x., 5.0.x, or 5.1.x to Version 6.0. Version 6.0 can also coexist with any of these versions. See the Migration Guide for more migration information.

See the IBM Rational Software Development Platform section for more information about coexisting with other Rational and WebSphere products that use the workbench.

If you have a beta version of IBM WebSphere Development Studio Client, or any version of WebSphere Development Tools, please remove it before installing Version 6.0.

If you have a previous version of Agent Controller or any software derived from the Hyades Data Collection Engine, you should stop it, uninstall it, and clean up any leftover files before installing this version of Agent Controller.

Installing WebSphere Development Studio Client

You can install the product from the DVD or CD-ROM, or copy the product files to a LAN server and install it from the server to a local machine. See Copying the product to a LAN server. An installation wizard is provided, but you can also install from a command prompt.

Installing from the CD-ROM

Figure 1 contains a diagram showing product names and CD distribution. To install the product from CDs, follow these steps:

1. Check that you have enough space. In addition to the permanent space required to install the product,
   • Your installation directory must have at least 500 MB free space.
   • Your TEMP or TMP environment variable must point to a valid temporary directory with at least 500 MB free space.
2. Read Migration, upgrade and coexistence issues before you begin the installation procedure.
3. Ensure that your user ID does not contain double-byte characters, such as Chinese characters.
4. Insert disk 1 into your CD drive.
5. If autorun is enabled on your system, the launchpad automatically opens. If autorun is disabled on your system, run launchpad.exe from the root of the first installation CD to display the Rational Software Development Platform launchpad.

   Tip: You can bypass the launchpad and go straight to the installation wizard by running setup.exe from the \setup directory on Disk 1.

6. From the launchpad, select the first item, Install IBM WebSphere Development Studio Client V6.0.
7. Wait for the installation wizard to open, then click Next to continue the installation.
8. Follow the on-screen instructions for tasks such as reading the license agreement and specifying the target installation directory.
   • The default target installation directory is X:\Program Files\IBM\Rational\SDP\6.0 (where X is the hard drive where Windows is installed).
   • The installation program checks to see if any other Rational Software Development Platform products are installed. See IBM Rational Software Development Platform for more details.
9. In the Features window, you can select the Development Studio Client features that you want to install. You can return to the installation wizard and install the optional features later.
   1. By default, the installation program installs the integrated development environment (the workbench).
   2. If you want to install the user interface and documentation for supported national languages other than English, select Language Pack. By default, this feature is not selected by default unless your system locale is a supported national language other than English.

      Supported national languages are Brazilian Portuguese, French, German, Italian, Japanese, Korean, Simplified Chinese, Spanish, and Traditional Chinese.

      Note: If you select the optional Language Pack feature and then cancel the installation shortly afterwards while files are being copied, subsequent installations will show some anomalies. On a subsequent installation, the status of the language pack will show as installed on the Feature panel. You can reinstall the Language Pack feature to copy the proper files to your disk. In this situation, at the end of the installation you might receive a message stating that One or more errors occurred during replacement of files. You can safely ignore this error message.

   3. By default, the Enterprise Generation Language (EGL) feature is not installed. EGL is a powerful, high-level language for creating complex business applications. It handles the complexities of underlying technologies (such as, database access, message queues, and J2EE) so application developers can focus on their business logic. EGL allows you to program productively with a higher level of abstraction, ultimately producing Java code. To install the EGL plug-in, select the Enterprise Generation Language (EGL) check box. To install the EGL for iSeries plug-in, select the Enterprise COBOL Generation for iSeries check box. The iSeries component can be installed only if the base EGL component is installed.
   4. The examples for Eclipse plug-in development are for developers who want to extend the workbench by creating their own plug-in tools. To install these examples, select the Examples for Eclipse Plug-In Development check box.
10. Click Next to display summary information for your installation. The disk space requirement shows only what you need for the files. The actual disk space needed can be considerably greater, especially if your disk is formatted with a FAT32 file system.
11. Click Next to install the product.
12. If you receive a warning about a problem with registering the license towards the end of the install, follow these steps:
    1. In the \logs subdirectory in your installation directory, open license.log with a text editor.
    2. If license.log contains either of the following lines, ensure that your system clock is set correctly, and then start the product.

       486604803  The requested license has expired
       486604805  The start dates for all licenses have not yet occurred
       

13. The installation program takes some time to set up the development environment and initialize Eclipse. Eventually you will see a message confirming that the installation is complete. Click Next.

Other installation choices

Additional features can be installed from the CD or DVD following the initial installation of the product.

• If you plan to develop applications that will run on other application servers, you can optionally select to install additional legacy run-time test environments with Development Studio Client. For more information, refer to Installing WebSphere Application Server 5.x as an integrated test environment
• Before you can use the profiling, runtime analysis and logging features of Development Studio Client to collect data remotely, you must install Agent Controller on both the local and remote host. Refer to Installing Agent Controller for details.
• At any time after installing Development Studio Client, you can add optional features by rerunning setup.exe from the \setup directory on the installation CD. The Development Studio Client installation program is launched so you can then select the optional features that you want to add. (Previously installed features will have installed listed next them in parentheses on the feature selection panel.) You must use the same user ID that you used to install the required features.
• If you rerun the installation program to add additional features and select to cancel the modification before it finishes, you may receive the following error:

  Errors occurred during the installation - User cancelled installation
  

  When you attempt to uninstall the product in this state, you may receive the following error:

  A suitable JVM could not be found. Please run the program again using
  the option -is:javahome <JAVA HOME DIR>.
  

  To work around this, you must rerun the installation program to complete the previously canceled modification, and then proceed to uninstall the product.

Installing from DVD

The installation from the DVD is very similar to the installation from CDs, except that there is only one DVD. Follow the instructions under Installing from the CD-ROM, except use the supplied DVD instead of the set of CDs. When using the DVD, you do not have to switch disks. You still have to use the CDs for the other options on the launchpad, however.

Installing from a command prompt

If you want to install the product from a command prompt without using the graphical interface, run the following command from the \setup directory on the first installation CD:

 setup.exe -console

Canceling the installation through the console mode is limited. You can cancel the installation during the preparation steps of the installation process, but there is not a supported method of canceling the installation after files have begun to be copied to the hard drive. Pressing Ctrl+C will force the installation process to quit, but this is not recommended, and you will have to do some cleanup.

Invoking a silent installation

The Development Studio Client installation program can be run silently if you do not want to interact with the installation wizard.

Setting up your local copies

Prior to silently installing the product, you must set up your local copies:

1. Read Migration, upgrade and coexistence issues before you begin the installation procedure.
2. Ensure that the user ID that you are using does not contain double-byte characters, such as Chinese characters.
3. Create a network installation image (copy) as described in Copying the product to a LAN server. If you only want to install Development Studio Client, you only need to copy the information from the first three CDs.

Silently installing the default features to the default directory

The following features are installed by default when silently installing WebSphere Development Studio Client:

• Integrated development environment
• Language pack (if your system locale is non-English)

To install WebSphere Development Studio Client silently with only the default selected features to the default directory system_drive:\Program Files\IBM\Rational\SDP\6.0:

1. Set up your copies as described in Setting up your local copies, if you have not done so already.
2. From the command line, change to the \disk1\setup directory in the temporary directory (for example, network_drive:\install_image\disk1\setup) that you created in a previous section.
3. Run the following command:

   setup.exe -silent 
   

4. Silently installing WebSphere Development Studio Client may take a while to complete. To determine when the installation completes, you may monitor the \logs directory in the default installation directory periodically. If the license.log file appears, then the silent installation has completed.

Silently installing to a different directory

By changing the installLocation parameter, you can install WebSphere Development Studio Client to a different directory. For example, if you want "d:\my softdev" to be your installation directory, follow the same steps that were just described, but run the following command:

setup.exe -silent -P installLocation="d:\my softdev"

(In this example, only the default features are installed.)

Silently installing additional WebSphere Development Studio Client features

WebSphere Development Studio Client provides you with a sample response file that silently installs all the default features. This response file is called responsefile.txt and it is located in the \disk1\util directory. If you want to change the response file to install other features, it is recommended that you first make a backup copy of responsefile.txt.

You can update the response file to install one or more optional WebSphere Development Studio Client features. The following table shows the response file options and their corresponding entries in the response file.

Table 7. Response file options

To silently install any of the optional features:

1. Copy responsefile.txt to a new file, for example myresponsefile.txt.
2. Edit your copy of the response file.
3. Locate the line containing the installation feature shown in Table 7. For example, if you want to install the examples for Eclipse plug-in development, locate the following line in the response file:# -P feature_examples_win32.active=<value>
4. Make the following changes:
   1. Remove the # in the first column.
   2. Change <value> to true.

   In this example, the revised line shows the changes:

      -P feature_examples_win32.active=true
   

5. Save your changes.
6. Set up your copies as described in Setting up your local copies, if you have not done so already.
7. From the command line, change to the \disk1\setup directory in the temporary directory (for example, network_drive:\install_image\disk1\setup) that you created in a previous section.
8. When you run the response file, add the -options parameter and the fully qualified name of your response file as shown below:

   setup.exe -silent -options "Your_directory\myresponsefile.txt"
   

   Your_directory is the fully qualified directory name of where your response file resides.

   Note:

   To verify that your response file is being used, run this command first (that is, before you run a silent install) without the -silent option, and verify that your settings are being registered in the installation wizard. If they are not, there is a problem with your response file settings or command syntax.

9. Silently installing WebSphere Development Studio Client may take a while to complete. To determine when the installation completes, you can monitor the \logs subdirectory in your installation directory periodically. When the license.log file appears, then the silent installation is finished.

Upgrading to WebSphere Development Studio Client Advanced Edition

Upgrading to WebSphere Development Studio Client Advanced Edition is a true upgrade, not a merge. When you upgrade to the Advanced Edition, all the plug-ins for the standard edition are deleted.

Important:

You do not lose any of your projects if you upgrade to the Advanced Edition. All you have to do is to use the same workspace that your projects are in.

Installing from a LAN server

In addition to installing by CD or DVD, you can also copy the contents of the CD to a LAN server, and then users can install the product from the server to their workstations.

Copying the product to a LAN server

Although you cannot install the product on a LAN drive, as an administrator you can copy all the files from the DVD or CDs onto a LAN server. Your users can then install the product from the server to their workstations.

Figure 3. A LAN installation flow from DVD to LAN to workstations

You need approximately 7.5 GB of disk space to store CD or DVD content on the disk.

To copy the files from the CDs:

1. Log in as root/administrator user.
2. Create a directory (for example, install_image) on a network drive where you want to store the files.
3. Insert the first Development Studio Client installation CD into your CD drive.
4. Under the temporary directory, create a subdirectory called disk1. This subdirectory must be called disk1 and it must be in lower case.
5. Copy all the files and directories on the first installation CD to the disk1 subdirectory in the temporary directory.
6. Repeat steps 3, 4, and 5 to copy the contents of the other six CDs to subdirectories called disk2, disk3, . . . disk7.

These are all the core installation files. If you want the installation files for any of the following optional features, copy the contents of the appropriate CDs into your temporary directory.

• Agent Controller
• Embedded messaging client and server
• Rational ClearCase LT
• WebSphere legacy test environments
• WebSphere Portal test environment V5.0
• Crystal Enterprise V10 Professional Edition
• Crystal Enterprise V10 Embedded Edition

To copy from DVD to a server:

1. Create a directory to store product files.
2. Insert the installation DVD in the DVD-ROM drive. Ensure that the installation setup file does not run. If it does, click Exit on the launchpad when it displays.
3. Copy all files from DVD to the storage directory with the following command: xcopy Z:*.* Y:\wdscimage /e /q where Z is the DVD-ROM drive letter and Y:\wdscimage is an existing destination drive and path.

After the product is copied to a LAN server, it can be installed onto a workstation from the server. The installation must be done from the workstation.

Installing from a LAN server to a workstation

To install from the LAN server to a workstation:

1. Open a Command Prompt window on the workstation.
2. Enter a net use command to connect to the LAN server drive where the product was copied. Ensure that at least 4.5 GB disk space is available on the workstation.
3. On the drive that is mapped to the LAN server, navigate to the Disk1 folder.
4. Double-click launchpad.exe and follow the installation instructions.

You can also run this command from Windows Explorer. Click Tools > Map Network Drive.

Installing from an iSeries server

The product can be copied from the CDs or DVD to an iSeries server, which can then be installed by users on their workstations.

Copying the product to an iSeries server

An administrator or user can copy all the files from the DVD to an iSeries server. This allows users to install from the iSeries server to a workstation.

To copy the DVD or the CDs to an iSeries server, follow the instructions given under Copying the product to a LAN server. See Figure 3 for an illustration.

After the product is copied to the iSeries server, it can be installed onto a workstation from the server. The installation must be done on the workstation.

Installing from an iSeries server to a workstation

To install from the iSeries server to a workstation:

1. Map a network drive to the iSeries drive where you copied the product files. Ensure that at least 4.5 GB disk space is available on the workstation.
2. Double-click the directory.
3. On the drive that is mapped to the LAN server, navigate to the Disk1 folder.
4. Double-click launchpad.exe and follow the installation instructions.

You do not need to reboot your workstation after installing the product.

Starting Development Studio Client

Because the product is part of the Rational Software Development Platform, it will be in a folder in the Start menu called IBM Rational. This is different from previous versions. Your work in the product is stored in a directory called a workspace. You can set it to whatever you want.

To start the product:

1. Select Start > Programs > IBM Rational > WebSphere Development Studio Client > WebSphere Development Studio Client to start the product.
2. The first time that you start the product, a dialog box opens, specifying the default workspace directory. The default directory is C:\Documents and Settings\youruserid\IBM\rationalsdp6.0. You can change the name and location of the workspace.
3. By default, the Use this as the default and do not ask again check box is cleared. If you leave it like this, you can switch workspaces whenever you start the product.

   Tip: If you select the Use this as the default and do not ask again check box, the software will use the workspace from the previous session. You might want to indicate your workspace each time you start the product if you maintain different workspaces for different projects. You can change the default value after you have started the product by selecting File > Switch Workspace and browsing to (or creating) a folder on your local system.

4. Click OK. There is a one-time delay while the workspace structure is created.

The workbench first opens to a series of welcome pages that provide a product overview and information about what's new, plus links to tutorials, samples, and external Web resources. Spend some time exploring these options, and be sure to scroll. Notice as well the sources of information that are available from the Help menu. To display the help, click Help > Help Contents.

Upgrades and Updates

Updating to WebSphere Development Studio Client > WebSphere Development Studio Client Version 6.0.1

1. Install Development Studio Client from the CDs or DVD.
2. Start Rational Product Updater, then install Development Studio Client Version 6.0.1 Refresh Pack.
3. (Optional) Start Rational Product Updater, then install WebSphere Development Studio Client Lite for iSeries technology preview from the Optional Features tab.

In order to update WebSphere Development Studio Client for iSeries to Version 6.0.1, first install Version 6.0. From here, Rational Product Updater can be used to install the Version 6.0.1 Refresh Pack.

The Rational Product Updater is a tool that keeps track of all Rational Software Development Platform products installed on your system and searches for and installs product updates and optional new features. This new tool replaces Update Manager.

The Product Updater is installed automatically when you install the first Rational software development product on your system. All subsequent Rational software development products that you install are automatically registered with this tool. You can search for and automatically install updates to each product:

• Upgrading from a previous version.
• Product updates, such as fix packs, refresh packs and interim fixes.
• Optional features that provide new functionality.

Any dependencies between updates are automatically enforced. The Product Updater allows you to manage updates to all of your Rational software development products from a single location. It even updates itself when needed.

The Product Updater also enables you to perform these tasks:

• Produce a detailed listing of your installed Rational software development products, including information on what fixes and optional features are installed.
• Create one or more local (proxy) product update sites, so users in your organization do not need to install updates from the Internet.

To start the Product Updater on your workstation and find information on using the tool:

1. Select Start > Programs > IBM Rational > Rational Product Updater (see Figure 5)
2. An alternate method of accessing the Rational Product Updater is within Development Studio Client, select from the main menu Help > Software Updates > IBM Rational Product Updater (see Figure 5)
3. To access more detailed information about the Rational Product Updater, select Help > Help Contents.

Figure 4. Accessing the Rational Product Updater from the Start Menu

Figure 5. Accessing the Rational Product Updater from the Help menu

If you have other Rational products installed and you want to install Development Studio Client, the existing products must be at the correct fix pack level first. If they are not, a dialog box asks you to update both Rational Product Updater and the existing products before you install Development Studio Client.

1. Cancel the installation of Development Studio Client.
2. Update Rational Product Updater to Version 6.0.0.4.
3. Run Rational Product Updater to update the existing Rational products to the levels shown in Table 8.
4. Install Development Studio Client.

The following table shows the correct fix pack levels for Rational products:

Table 8. Fix pack levels for Rational products

If you are not sure which Rational products you have installed, check Start > Programs > IBM Rational.

Installing WebSphere Development Studio Client Lite for iSeries technology preview

The technology preview requires less system memory than the standard product and includes a set of core development tools, for editing, compiling, and debugging. This is an ideal product for RPG and COBOL programmers looking for a way to work with their code without having to load the full workbench. As a result of the decreased memory requirements, WebSphere Development Studio Client Lite for iSeries technology preview will perform much quicker than the standard Development Studio Client.

System Requirements for WebSphere Development Studio Client Lite for iSeries technology preview:

• The same Workstation requirements as WebSphere Development Studio Client for iSeries
• 256 MB of RAM instead of 768 MB for the standard edition
• 400 MB of additional disk space (Compile, edit, and debug standalone functionality)

In order to install WebSphere Development Studio Client Lite for iSeries technology preview, follow these steps:

1. Start the Rational Product Updater (see Upgrades and Updates for instructions on accessing the Rational Product Updater).
2. Select the Optional Features tab, as shown in Figure 6.

   Figure 6. The Optional Features tab
   
   
   

3. Select the IBM WebSphere Development Studio Client Lite for iSeries technology preview (version 6.0.1) check box. The Detailed information pane displays the Release Notes, which provide additional information on installing, using, and uninstalling the product.
4. Click the Install Features button to begin the installation process.
5. Read the license agreement. These terms are identical to those for the WebSphere Development Studio Client for iSeries.
6. After agreeing to the license agreement, the product downloads the necessary files, and extracts essential development tools to the installation directory.
7. Click Finish to complete the installation.

To start the product, click Start > Programs > IBM Rational > WebSphere Development Studio Client Lite for iSeries technology preview > Launch WebSphere Development Studio Client Lite.

Uninstalling WebSphere Development Studio Client

Important:

A user with administrator authority must uninstall the product.

To uninstall Development Studio Client:

1. Close the product.
2. Open the Control Panel, then open the Add/Remove Programs window. Select IBM WebSphere Development Studio Client 6.0 and click Change/Remove.
3. Select Remove product.
4. Follow the uninstallation instructions.

You do not need to reboot your workstation after uninstalling the product.

All files in any plug-ins or features directories are automatically deleted, including your data and third-party plug-ins that reside in any of these directories. Your workspace directory, which contains your work, is not deleted. Some other directories remain:

• The \eclipse\configuration directory is left in case you uninstalled Development Studio Client because of a problem and plan to reinstall to the same directory.
• The \eclipse\links directory may be left if third-party plug-ins were linked to your product, in case you uninstalled Development Studio Client because of a problem and plan to reinstall to the same directory.
• The \logs directory is left to preserve a history of any installation-generated log files. The directory might contain information that can be used to troubleshoot installation-related issues.

If you try to partially uninstall one or more of the Development Studio Client required features, you receive an error message similar to this:

Invalid selection:
Unable to uninstall ide_required: root is not set for uninstall

To work around this problem, select the Product Uninstallation check box. The uninstallation page of the wizard is reinitialized so that you can now uninstall the product entirely, or clear the selection of features that you do not want to uninstall.

Notices

Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this Documentation in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this Documentation. The furnishing of this Documentation does not give you any license to these patents. You can send license inquiries, in writing, to:

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this Documentation and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples may include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

COPYRIGHT LICENSE

This information contains sample application programs in source language, which illustrates programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces.

Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:

(C) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (C) Copyright IBM Corp. 2000, 2005. All rights reserved.

Programming interface information

Programming interface information is intended to help you create application software using this program.

General-use programming interfaces allow you to write application software that obtain the services of this program's tools.

However, this information may also contain diagnosis, modification, and tuning information. Diagnosis, modification and tuning information is provided to help you debug your application software.

Warning: Do not use this diagnosis, modification, and tuning information as a programming interface because it is subject to change.

Trademarks and service marks

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

• ClearCase^(R)
• Crystal
• 
• IBM
• iSeries
• MQSeries^(R)
• OS/400^(R)
• VisualAge^(R)
• WebSphere

InstallShield is a trademark of InstallShield Corporation.

Intel^(R) and Pentium^(R) are trademarks of Intel Corporation in the United States, other countries, or both.

Java^(TM) and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Rational is a trademark of International Business Machines Corporation and Rational Software Corporation^(R), in the United States, other countries or both.

Microsoft^(R), Windows^(R), Windows NT^(R), and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

Other company, product, and service names may be trademarks or service marks of others.

Copyright IBM Corporation 1992, 2005. All Rights Reserved.