IBM WebSphere Development Studio Client Advanced Edition for iSeries,
Version 5.1.2, Installation Notes

These installation notes apply to IBM^(R) WebSphere^(R) Development Studio Client for iSeries^(TM) Advanced Edition, Version 5.1.2. This version is designed to be installed only on a PC workstation, and is available only on CD and DVD.

The Readme file contains prerequisite information, limitations of the product, and information not included in the documentation. For information on migrating from Development Studio Client Version 4.0, Version 5.0, Version 5.1 or from WebSphere Development Tools V5R1M0, see the Migration guide.

General notes

You need Administrator privileges to install or uninstall the product on a workstation.

Here is a brief description of the installation process:

1. Ensure your workstation meets the requirements described in the Hardware requirements section below.
2. Choose to install the classic tools (CODE and VisualAge RPG) only, or the entire product.
3. Install WebSphere Development Studio Client Advanced Edition for iSeries^(TM) V5.1.2.
   • You must accept the License Agreement before you install.
   • You can select an Installation directory.
4. Reboot the workstation.
5. If you still 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.
6. After installation, from the Start Menu, you can choose Programs > IBM WebSphere Studio > Development Studio Client Advanced Edition for iSeries 5.1.2 > Check PTF. This sets up a connection to your iSeries server and verifies that the server has the required License Program Products and Program Temporary Fixes (PTFs).

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

Relationship to other products and versions

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

Development Studio Client can coexist with the following products:

• WebSphere Studio Enterprise Developer Version 5.1.1
• WebSphere Studio Application Developer Integrated Edition Version 5.1.1

The iSeries components do not extend those products.

WebSphere Development Studio Client Advanced Edition for iSeries includes WebSphere Studio Application Developer, in addition to the iSeries components.

National Language Support

The product installs one language according to the user locale. 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 from a workstation section, change the locale, and then install the product again.

Workstation requirements

Hardware requirements

Development Studio Client requires the following hardware:

• Processor - Intel^(TM) Pentium^(R) II (600 MHZ or faster processor recommended)
• Display - 1024x768 minimum resolution
• CD or DVD drive
• A mouse or other pointing device
• Appropriate communications adapters (like an Ethernet card; as supported by the workstation operating system) for TCP/IP communication
• The following memory and disk requirements:

	Minimum	Recommended
Memory	512 MB	768 MB (required when using the WebSphere Application Server test environment)
Disk	1.65 GB + 700 MB temporary space needed during product installation.	1.8 GB + 700 MB temporary space needed during product installation.

Temporary space

Because Development Studio Client needs minimum 512 MB, recommended 768 MB, of temporary space during installation, you can change the default drive for temporary space to another drive.

To move your temporary space:

1. Click Start > Settings > 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 as well.

Software requirements

WebSphere Development Studio Client Advanced Edition, Version 5.1.2 can be installed on Microsoft^(R) Windows^(R) 2000 and Windows XP. It cannot be installed on Windows 95, Windows 98, Windows NT^(R), or Windows Me. Also, Novell Netware and server versions of Windows are not supported (including Windows 2000 and XP Server, Windows 2000 and XP Advanced Server, or Windows 2003 Server).

If you are installing this product on Windows XP, you must install XP Service Pack 1 or later; otherwise, you will encounter installation problems. To see whether you have one of the Service Packs, right-click My Computer > Properties and look under System. You can download the latest service pack from the Microsoft XP download site.

Development Studio Client requires the following software:

Installing the product

Installing from CD-ROM

There are several numbered CD-ROM disks. To install WebSphere Development Studio Client Advanced Edition for iSeries:

1. Insert disk 1 into the CD-ROM drive.
2. If installation does not start automatically:
   1. Click Start, and then click Run.
   2. Type x:setup, where x is the CD-ROM drive letter.
   3. Press Enter.
3. Follow the on screen instructions for WebSphere Development Studio Client Advanced Edition for iSeries.
4. Reboot the workstation.
5. To make sure that prerequisite fixes have been applied to your iSeries system, click Start, and then select Programs > IBM WebSphere Studio > Development Studio Client Advanced Edition for iSeries 5.1.2 > Check PTF. This sets up a connection to your iSeries server and verifies that the server has the required License Program Products and Program Temporary Fixes (PTFs). We recommend that you do this now.

Installing from DVD

To install Development Studio Client:

1. Put the DVD disk into the DVD drive.
2. If installation does not start automatically:
   1. Click Start, and then click Run.
   2. Type x:setup, where x is the DVD drive letter.
   3. Press Enter.
3. Follow the on screen instructions for WebSphere Development Studio Client Advanced Edition for iSeries.
4. Reboot the workstation.
5. To check to ensure that prerequisite fixes have been applied to your iSeries system, click Start, and then select Programs > IBM WebSphere Studio > Development Studio Client Advanced Edition for iSeries 5.1.2 > Check PTF. This sets up a connection to your iSeries server and verifies that the server has the required License Program Products and Program Temporary Fixes (PTFs). We recommend that you do this now.

Optional installation steps

You can select optional components to install.

• Host Access Transformation Services (HATS)
• Portal Toolkit
• Enterprise Generation Language (eGL)

HATS installation is described at the end of the regular installation. HATS allows you to put a web interface on screens that do not use DDS (like system screens). It is a complement to the IBM WebFacing Tool. You can see information about this installation step by selecting the HATS check box. HATS is on a separate CD.

Portal Toolkit comes only with the Advanced Edition and is described at the end of the regular installation. Portal Toolkit provides the capability to produce web interfaces that split a browser window up into application areas, known as portlets. You can see information about this installation step by selecting the Portal Toolkit check box. Portal Toolkit is on a separate CD.

eGL can be selected as an option near the beginning of the installation. eGL allows you to program productively with a higher level of abstraction, ultimately producing Java or COBOL code. If you select this option during that part of the installation, all Development Studio Client items related to eGL are automatically installed.

After installation

• Although environment variables should be set by the installation program, various things can prevent this from happening. We recommend that you make sure the system environment variables described in the table below are set. You can access the list of environment variables from the Windows System Properties dialog box on the Advanced tab. In the table, x: refers to the drive where the product is installed.

  System variable name	must include this entry
  CLASSPATH	x:\WDSC\JAVA
  HELP	x:\wdsc\help
  IPF_PATH32	x:\wdsc\system
  LOCPATH	x:\wdsc\system
  PATH	x:\wdsc

• You must reboot the workstation after the variables are set.
• Log in as a Power User or an Administrator to use the product.

Upgrading to the Advanced edition

WebSphere Development Studio Client for iSeries is packaged with WebSphere Studio Site Developer. The Advanced Edition of Development Studio Client is packaged with WebSphere Studio Application Developer. Therefore, if you want to upgrade to the Advanced Edition of our product, you need to first uninstall WebSphere Development Studio Client for iSeries, and then install the Advanced Edition.

1. Click Start > Settings > Control Panel > Add/Remove Programs.
2. Click IBM WebSphere Development Studio Client for iSeries Version 5.1, then click Change/Remove for Windows 2000 and Windows XP.
3. Select Remove product.
4. Reboot your machine after uninstalling.

Copying the product to a LAN server

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

To copy from DVD to a server:

1. Create a directory to store product files. At least 1.7 GB are required.
2. Insert the installation DVD in the DVD-ROM drive. Ensure that the installation setup does not execute.
3. Copy all files from DVD to the storage directory with the following command:xcopy X:*.* y:\wdscimage /e /q where X is the DVD-ROM drive letter and Y:\wdscimage is an existing destination drive and path.

Installing from a LAN server to a workstation

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

1. Open a Command Prompt window on the workstation.
2. Enter a net use command to connect the LAN server drive where the product was copied to. Ensure that at least 1.7 GB are available on the workstation.
3. Enter the command X:\wdscimage\setup (where X is the LAN server drive) and follow the installation instructions.

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

Copying the product to an iSeries server

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

To copy the DVD on to an iSeries server, perform the following steps:

1. On the iSeries server, ensure that NetServer is running:
   1. Sign on to the iSeries server.
   2. At the command line type STRTCPSVR *NETSVR.
2. Using Client Access, create a folder on your Integrated File System called wdsc, and share it.
3. Map a network drive to your iSeries server:
   1. On the workstation, start Explorer by choosing Start > Programs >Accessories > Windows Explorer.
   2. On the Explorer window, choose Tools > Map Network Drive to bring up the Map Network Drive window.
   3. On the Map Network Drive window:
      • Select an available drive in the Drive field ("m" in this example), and specify \\iSeriesname\wdsc in the Folder where iSeriesname is the name of your iSeries server. iSeriesname can also be the TCP/IP address of the iSeries server. Due to a path length limitation, we recommend that you install the product no more that two levels beyond the root level of the file system. For example, use m:\wdsc which maps to \\iSeriesname\wdsc\wdsc.
      • Select Reconnect at Logon if you want to reconnect to this drive the next time you reboot the workstation.
      • Click OK or Finish. The network drive to iSeries server should now be "m".
4. Copy the files to the iSeries server:
   1. Insert the DVD into the CD-ROM drive. Ensure that the installation setup.exe file does not run.
   2. Copy all files from the disk to the directory you created and shared on your iSeries server (in step 2).

Installing from an iSeries server to a workstation

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

1. Map the network drive to the iSeries drive where you copied the product files. See step 3 above. Ensure that at least 1.6 GB are available on the workstation.
2. Double-click the m:\ directory
3. Double-click setup.
4. Follow the installation instructions.

Uninstalling from a workstation

In the Add/Remove Programs list in the Control Panel, only the products you can uninstall are listed, but if you separately installed either WebSphere Studio Site Developer or Application Developer, you also need to remove it separately.

To uninstall all of Development Studio Client:

1. Click Start > Settings > Control Panel > Add/Remove Programs.
2. Click IBM WebSphere Development Studio Client, then click Change/Remove.
3. Select Remove product.
4. Always reboot your machine after uninstalling the product.

Troubleshooting: problems and workarounds

If you have trouble with installation, check the following things.

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:

IBM Director of Licensing
 IBM Corporation 
North Castle Drive
Armonk, NY 10504-1785 
U.S.A.

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

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

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:

Lab Director
IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham, Ontario, Canada L6G 1C7

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. 1992, 2002. 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:

* AIX	* DB2 Extenders	* Operating System/400
* AIX windows	* DB2 Universal Database	* OS/2
* Application System/400	*	* Open Class
* AS/400	* IBM	* OS/390
* AS/400e	* IBMLink	* OS/400
* C Set ++	* Integrated Language Environment	* RPG/400
* COBOL/2	* iSeries	* SQL/400
* COBOL/400	* Language Environment	* VisualAge
* DB2	* MQSeries	* WebSphere

InstallShield is a trademark of InstallShield Corporation.

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

Java 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, in the United States, other countries or both.

ActiveX, Microsoft, SourceSafe, Visual C++, Visual SourceSafe, Windows, Windows NT, Win32, Win32s and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group.

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

Copyright IBM Corporation 1992, 2004. All Rights Reserved.