Before using this information and the product it supports, read the information in Notices.
This edition applies to version 1.2 of IBM Data Studio Developer and to all subsequent releases and modifications until otherwise indicated in new editions.
This installation guide provides instructions for installing and uninstalling IBM(R) Data Studio Developer.
For the most up to date version of this information, see the Data Studio information center.
An HTML copy of this Installation Guide is available in the documentation directory of the product DVD.
IBM Installation Manager is a program that helps you install the Data Studio Developer product package on your computer. It also helps you update, modify, and uninstall any package that you install. A package can be a product, a group of components, or a single component that is specifically designed for Installation Manager to install.
IBM Installation Manager offers several time-saving features, which you can use to complete the following tasks:
For more information about IBM Installation Manager and how to use it to install and update Data Studio Developer, visit the Installation Manager Information Center at http://publib.boulder.ibm.com/infocenter/install/v1m0r0/index.jsp.
This section details hardware, software, and user privilege requirements that must be met in order to successfully install and run your software.
For the most up-to-date, detailed system requirements, refer to The Data Studio Developer product Web site.
Before you can install the product, verify that your system meets the minimum hardware requirements.
Before you can install the product, verify that your system meets the software requirements.
The following operating systems are supported for this product.
You must have a user ID that meets the following requirements before you can install Data Studio Developer.
Read all the topics in this section before you begin to install any of the product features. Effective planning and an understanding of the key aspects of the installation process can help ensure a successful installation.
There are a number of scenarios that you can follow when installing Data Studio Developer.
The following are some of the factors that might determine your installation scenario:
These are the typical installation scenarios you might follow:
Note that in the latter three scenarios you can choose to run the Installation Manager program in silent mode to install Data Studio Developer. For details on running Installation Manager in silent mode, see Installing silently.
In this installation scenario, you have the DVDs that contain the product package files, and typically you are installing Data Studio Developer on your own workstation. Refer to Installing Data Studio Developer from DVDs: task overview for an overview of the steps.
In this scenario, you have downloaded the installation files from IBM Passport Advantage or another IBM Web site and you will install Data Studio Developer on your own workstation. Refer to Installing Data Studio Developer from an electronic image on your workstation: task overview for an overview of the steps.
In this scenario, you will place the electronic image on a shared drive so that users in your enterprise can access the installation files for Data Studio Developer from a single location. Refer to Installing Data Studio Developer from an electronic image on a shared drive: task overview for an overview of the steps.
This scenario represents the fastest method for installing the product across a network. This scenario differs from the shared-drive installation. In order to place product package files for Data Studio Developer on an HTTP Web server, you must use this utility application - IBM Packaging Utility. This utility is provided with Data Studio Developer to copy the installation files in a format - a package - that can be used for installing Data Studio Developer directly from a HTTP Web server. The directory on the HTTP Web server that contain the package is called a repository. Note that, in this scenario, the installation files for only Data Studio Developer are placed in the package. Refer to Installing Data Studio Developer from a repository on a HTTP Web server: task overview and Placing Data Studio Developer on an HTTP Web server: task overview for an overview of the steps.
You can customize your software product by selecting which features of Data Studio Developer to install.
When you install the Data Studio Developer product package using IBM Installation Manager, the installation wizard displays the features in the available product package. From the features list, you can select which to install. A default set of features is selected for you (including any required features). Installation Manager automatically enforces any dependencies between features and prevents you from clearing any required features.
The following table shows the features of Data Studio Developer that you can choose to install. Default selections of features to install may vary. If a feature already exists in your shared resources directory, it will not be selected by default and will not be installed again.
Some features contain license checking. If you do not have a valid trial or permanent license installed, these features will show an error message if you attempt to use them.
Feature | Description |
---|---|
Data Studio Core Features | Includes support for connecting to and browsing data sources and the objects contained in a connection, and creating, running, and tuning SQL statements and XML queries. |
SQL Routine Development | Provides tooling for developing, testing, and deploying SQL stored procedures and user-defined functions, including wizards, editors, and an integrated stored procedure debugger. |
Database Object Management | Provides tools for database administration, including an editor for creating and altering data objects and data object privileges. |
XML Development | Provides tooling for XML application development, including wizards for creating and registering XML schema documents and inserting XML data into XML columns, editors for XML, XSD, and DTD files, and a graphical mapping editor that allows you to annotate XML schemas for shredding. |
Java(TM) Routine Development | Provides tooling for developing, testing, and deploying Java stored procedures, including wizards, editors, and an integrated stored procedure debugger. |
SQLJ Development | Provides tools for building SQLJ applications, including an SQLJ editor with built in syntax highlighting, an SQLJ translator that translates SQLJ files to pure Java files and produces SQLJ serialized profiles, and an SQLJ debugger that enables you to debug SQLJ files directly. There are also built-in customization features that are available when you are developing SQLJ applications for DB2(R). |
Data Web Services | Provides support for creating and deploying Web services that allow client applications to access data in DB2 databases by means of database operations, such as SQL SELECT and DML statements, as well as calls to stored procedures. |
WebSphere(R) Application Server Community Edition Installer | WebSphere Application Server Community Edition is a free J2EE server for building and managing Java applications. Select this option to copy the installer for WebSphere Application Server Community Edition into the <install dir>\dwb\bin directory on your computer for later installation. You must run the *.exe file from this location to install WebSphere Application Server Community Edition on your computer. |
ClearCase(R) Enablement | The Rational(R) ClearCase SCM Adapter provides support for sharing data projects by using Rational ClearCase. After installation, you must enable this functionality on the Capabilities page of the Preferences window. This feature can only be used if you have a ClearCase client and a configured ClearCase server. |
Development Center Project Migration | Provides tooling for Development Center project migration. Install this feature if you have artifacts, such as stored procedures, that you want to migrate from a Development Center project. |
pureQuery for Java | Provides tools that make it easy to develop Java applications that access databases or in-memory data. The tooling enhances the Java editor with complete assistance for building, validating, and running SQL statements. You can also use the tooling to build pureQuery applications around existing code, SQL, or databases. |
If you have a previous version of the product, or if you plan to install multiple IBM Eclipse-based products on the same workstation, review the information in this section.
Some products are designed to coexist and share function when they are installed in the same package group. A package group is a location where you can install one or more software products or packages. When you install each package, you select whether you want to install the package to an existing package group, or whether you want to create a new one. IBM Installation Manager will block products that are not designed to share or do not meet version tolerance and other requirements. If you want to install more than one product at a time, the products must be able to share a package group.
For more information about which products are compatible in this release, refer to Compatibility with other products
Any number of compatible products can be installed to a package group. When a product is installed, its function is shared with all of the other products in the package group. If you install a development product and a testing product into one package group, when you start either of the products, you have both the development and testing functionality available to you in your user interface. If you add a product with modeling tools, all of the products in the package group will have the development, testing, and modeling functionality available.
If you install a development product and later purchase a development product with increased functionality and add that product to the same package group, the additional function will be available in both products. If you uninstall the product with the greater functionality, the original product remains.
If you have a previous version of the product, or if you plan to install multiple IBM Software Development Platform products on the same workstation, review the information in this section.
Data Studio Developer Version 1.2 can share a package group with other compatible products that have been installed with Installation Manager.
Before you can share a package group with Rational Software Architect or Rational Application Developer, you must upgrade to Installation Manager Version 1.1.1. See the "Installation limitations" section of the release notes for more details.
The following products have been tested with Data Studio Developer Version 1.2. Other products have not been tested and you should not attempt to install Data Studio Developer with them in a shared package group.
If you have installed other Eclipse 3.2.2 based products using a mechanism other than Installation Manager, you can attempt to install Data Studio Developer into the same Eclipse IDE, using the Extend an existing Eclipse IDE option in Installation Manager. However, be aware that this type of installation will fail if the Eclipse environment is not compatible with Data Studio Developer Version 1.2.
See the Data Studio Developer support page for additional technotes about extending an Eclipse 3.2.2 IDE.
When you install the Data Studio Developer package with IBM Installation Manager, you must choose a package group and a shared resource directory.
During the installation process, you must specify a package group for the Data Studio Developer package. A package group represents a directory in which packages share resources with other packages in the same group. When you install the Data Studio Developer package with Installation Manager, you can create a new package group or install the packages into an existing package group. (Some packages might not be able to share a package group, in which case the option to use an existing package group will be disabled.)
If you have products on your computer that were previously installed with Installation Manager, sharing a package group is the method that you use to enable shared installations.
Note that when you install multiple packages at the same time, all the packages are installed into the same package group.
A package group is assigned a name automatically; however, you choose the installation directory for the package group.
After you create the package group by successfully installing a product package, you cannot change the installation directory. The installation directory contains files and resources specific to the Data Studio Developer product package installed into that package group. Resources in the product package that can potentially be used by other package groups are placed in the shared resources directory.
You can install Data Studio Developer into an existing package group only if the product and version in the existing package group is compatible with Data Studio Developer. In most cases, if the existing product is not compatible, you will see an error and the shared installation will fail. However, in some cases Installation Manager will not block the shared installation of incompatible products, which can cause unpredictable installation results. For more information about which products are compatible in this release, refer to Compatibility with other products.
The shared resources directory is the directory where installation artifacts are located so that they can be used by one or more product package groups.
When you install the Data Studio Developer product package, you can choose to extend an Eclipse integrated development environment (IDE) already installed on your computer by adding the functions that the Data Studio Developer package contains.
If you have products on your computer that were previously installed with the Eclipse update mechanism, extending an Eclipse IDE is the method that you use to enable shared installations. This type of installation should be attempted with caution, since installing product combinations using this method can cause unpredictable installation or product behavior.
The Data Studio Developer package that you install with IBM Installation Manager is bundled with a version of the Eclipse IDE or workbench; this bundled workbench is the base platform for providing the functionality in the Installation Manager package. However, if you have an existing Eclipse IDE on your workstation, then you have the option to extend, that is, add to the IDE the additional functionality provided in the Data Studio Developer package - that Eclipse instance.
To extend and existing Eclipse IDE: in the Location page of the Install Packages wizard, select the Extend an existing Eclipse IDE option.
You might extend your existing Eclipse IDE, for example, because you want to gain the functionality provided in the Data Studio Developer package, but you also want to have the preferences and settings in your current IDE when you work with the functionality from the Data Studio Developer package. You also might want to work with plug-ins you have installed that already extend the Eclipse IDE. However, be aware that if you have previously extended an Eclipse IDE by installing any other features or plugins, or if you are trying to extend an Eclipse product (that is, there are additional features and plugins in your installation other than just base Eclipse), it is possible that these features might not be compatible with Data Studio Developer. If they are not compatible, you will see error messages indicating that features need to be updated to a different version. To fix these incompatibilities, you must locate the appropriate versions and update each incompatible feature as indicated by the error messages.
Your existing Eclipse IDE must be the correct version to be extended. See Software requirements for details. In addition, Installation Manager checks that the Eclipse instance you specify meets the requirements for the installation package, and the installation will not proceed if the requirements are not met.
IBM Installation Manager retrieves product packages from specified repository locations.
If the launchpad is used to start Installation Manager, the repository information is passed to Installation Manager. If the Installation Manager is started directly, you must specify an installation repository that contains the product packages that you want to install. See Setting repository preferences in Installation Manager.
Some organizations bundle and host their own product packages on their intranet. For information about this type of installation scenario, see Installing from a repository on an HTTP server. Your system administrators will need to provide you with the correct URL.
By default, Installation Manager uses an embedded URL in each product to connect to a repository server over the Internet. Installation Manager then searches for the product packages as well as new features.
When you start the installation of Data Studio Developer from the launchpad program, the location of the repository that contains the product package you are installing is automatically defined in Installation Manager when it starts. However, if you start Installation Manager directly (for example, installing Data Studio Developer from a repository located on a Web server) then you must specify the repository preference (the URL for the directory that contains the product package) in Installation Manager before you can install the product package. Specify these repository locations on the Repositories page of the Preferences window. By default, Installation Manager uses an embedded URL in each product to connect to a repository server through the Internet and search for installable packages and new features. Your organization may require you to redirect the repository to use intranet sites.
To add, edit, or remove a repository location in Installation Manager:
Before you install the product, complete these steps:
The following sections provide an overview of the installation scenarios that are described in the section Installation scenarios. You can access detailed instructions from links in the main steps.
In this installation scenario, you have the DVDs that contain the installation files, and typically you are installing Data Studio Developer on your own workstation.
The following are the general steps for installing from DVDs:
If Installation Manager is not detected on your workstation, you are prompted to install it and then the installation wizard starts. Follow the on-screen instructions in the wizard to complete the installation of Installation Manager. See Installing Installation Manager on Windows for details.
When the installation of Installation Manager completes, or if it is already on your computer, Installation Manager starts and automatically begins the Install Packages wizard.
The following are the general steps for installing Data Studio Developer from an electronic installation image.
If Installation Manager is not detected on your workstation, you are prompted to install it and then the installation wizard starts. Follow the on-screen instructions in the wizard to complete the installation of Installation Manager. See Installing Installation Manager on Windows for details.
When the installation of Installation Manager completes, or if it is already on your system, Installation Manager starts and automatically begins the Install Packages wizard.
In this scenario, you will place the electronic image on a shared drive so that users in you enterprise can access the installation files for Data Studio Developer from a single location.
The following steps are performed by the person who places the installation image on a shared drive.
To install Data Studio Developer from the installation files on the shared drive:
To prepare Data Studio Developer for installation from a repository located on an HTTP Web server:
In this scenario, the product packages are retrieved by Installation Manager from an HTTP Web server.
These steps assume the repository containing the package for Data Studio Developer has been created on the HTTP Web server.
To install the Data Studio Developer package from a repository on an HTTP server:
The Launchpad program provides you with a single location to view release information and start the installation process.
Use the launchpad program to start the installation of Data Studio Developer in the following cases:
By starting the installation process from the Launchpad program, IBM Installation Manager will start preconfigured with the location of the repository that contains the Data Studio Developer package. If you install and start Installation Manager directly, then you must set repository preference manually.
To install from the launchpad:
Follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Installing IBM Data Studio Developer using the IBM Installation Manager graphical interface.
Complete the preinstallation tasks described in Preinstallation tasks, if you have not done so already.
If you are installing from a DVD and autorun is enabled on your workstation, then the Data Studio Developer launchpad starts automatically when you insert the first installation disc into your DVD drive. If you are installing from an electronic image, or if autorun is not configured on your workstation, then you must start the Launchpad program manually.
To start the Launchpad program:
For information about how to use the Installation Manager interface to install or update a package, refer to the Installation Manager information center.
IBM Installation Manager is installed by the launchpad. For more information on this process, refer to Installing from the Launchpad program.
To install Installation Manager manually:
IBM Installation Manager is installed by the launchpad. For more information on this process, refer to Installing from the Launchpad program.
To install Installation Manager manually:
IBM Installation Manager should be started from the launchpad program. Doing so starts Installation Manager with a configured repository preference and selected Data Studio Developer packages. If you start Installation Manager directly, then you must set a repository preference and choose product packages manually.
To start Installation Manager manually:
Installation Manager should be started from the launchpad program. Doing so starts the Installation Manager with a configured repository preference and selected Data Studio Developer packages. If you startInstallation Manager directly, then you must set repository preference and choose product packages manually.
To start Installation Manager manually:
To uninstall Installation Manager manually:
IBM Installation Manager must be uninstalled using the package management tool that is included with your Linux version.
To uninstall Installation Manager manually on Linux:
You can install the Data Studio Developer product package by running Installation Manager in silent installation mode. When you run Installation Manager in silent mode, the user interface is not available; instead, Installation Manager uses a response file to input the commands that are required to install the product package. You can also install Installation Manager silently using the Installation Manager installer. You can then use the installer to silently install product packages.
Typically, you silently install Installation Manager and the Data Studio Developer package at the same time. The general process is the same as the processes that are described in the following Installation Manager information center topics. Follow the links below to read the topics, or access them from the Installation Manager information center by clicking Help -> Help Contents from the Installation Manager main menu.
The only difference for Data Studio Developer is that you must run the Installation Manager install program from the <Data Studio media root>/disk1/InstallerImage_<platform> location.
The following tasks are the main tasks that are required for silent installation:
Refer to the related links for additional information about silent installation commands and files. This same information is available in the Installation Manager information center by clicking Help -> Help Contents.
You can manage the licenses for your installed products and customized packages by using the Manage Licenses wizard and associated Preferences pages. The Manage Licenses wizard displays license type and license expiration information for each of your installed packages.
You can upgrade trial or non-licensed versions of Data Studio Developer to licensed versions by importing product activation kits.
For information about how to work with licenses in Installation Manager, refer to the topic called Managing licenses in the Installation Manager online information center. This same information is available in the Installation Manager information center by clicking Help -> Help Contents.
You can purchase new licenses if your current product license is about to expire or if you want to acquire additional product licenses for team members.
To purchase licenses and enable your product, complete the following steps:
When you want to import the activation kit for your product, use the Manage Licenses wizard in Installation Manager.
You can start Data Studio Developer from the desktop environment or a command-line interface.
For Windows: Click Start -> Programs -> IBM Data Studio -> Data Studio Developer.
To start Data Studio Developer from a command-line:
The Modify Packages wizard in Installation Manager enables you to change the language and feature selections of an installed product package.
By default, Internet access is required unless the repository preferences points to a local update site. See the Installation Manager help for more information.
To modify an installed product package, follow the instructions in the Installation Manager online information center topic called: Modifying installed packages. This same information is available in the Installation Manager information center by clicking Help -> Help Contents.
You can remove an update to some packages to revert to a previous version by using the Roll back Packages wizard of IBM Installation Manager.
To modify an installed product package, follow the instructions in the Installation Manager online information center topic called: Rolling back updates. This same information is available in the Installation Manager information center by clicking Help -> Help Contents.
You can install updates for packages that were installed with Installation Manager.
Prerequisites:
To modify an installed product package, follow the instructions in the Installation Manager online information center topic called: Installing updates. This same information is available in the Installation Manager information center by clicking Help -> Help Contents.
The Uninstall Packages option in Installation Manager enables you to uninstall packages from a single installation location. You can also uninstall all the installed packages from every installation location.
To uninstall Data Studio Developer, follow the instructions in the Installation Manager online information center topic called: Uninstalling products, packages, and updates. This same information is available in the Installation Manager information center by clicking Help -> Help Contents.
If you want to uninstall Installation Manager, follow the instructions in the Installation Manager online information center topic called: Uninstalling Installation Manager . This same information is available in the Installation Manager information center by clicking Help -> Help Contents.
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 document 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 document. The furnishing of this document does not grant 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 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.
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:
Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
Other company, product or service names, may be trademarks or service marks of others.