IBM Data Studio Developer, Version 1.1.1

Installation guide

Overview

IBM Installation Manager

IBM Installation Manager offers several time-saving features, which you can use to complete the following tasks:

• Install product packages
• Manage licenses for installed product packages
• Search for and install updates to installed product packages
• Modify installed product packages
• Revert installed product packages to earlier versions
• Uninstall product packages

For more information about IBM Installation Manager, visit the Installation Manager Information Center at http://publib.boulder.ibm.com/infocenter/install/v1m0r0/index.jsp.

Installation requirements

Hardware requirements

Software requirements

Operating system

The following operating systems are supported for this product.

• Microsoft Windows^(R) Vista Business, Enterprise, Ultimate (tested on Intel^(R) Pentium^(R) D CPU)
• Microsoft Windows 2000 Professional x86-32 with Service Pack 3 or 4
• Microsoft Windows 2000 Advanced Server x86-32 with Service Pack 4
• Microsoft Windows 2000 Server x86-32 with Service Pack 3 or 4
• Microsoft Windows Server 2003 Enterprise Edition x86-32 with Service Pack 1 (tested on AMD Opteron Processor 246)
• Microsoft Windows Server 2003 Enterprise Edition x86-64 (Run in 32 bit mode) with Service Pack 1 (tested on AMD Opteron Processor 250)
• Microsoft Windows Server 2003 Standard Edition x86-32 with Service Pack 1
• Microsoft Windows Server 2003 Standard Edition x86-64 (Run in 32 bit mode) with Service Pack 1
• Microsoft Windows XP Professional x86-32 with Service Pack 1 or 2 (tested on Intel Pentium M)
• Microsoft Windows XP Professional x86-64 Edition (Run in 32-bit mode) with Service Pack 1 or 2
• Red Hat Desktop Version 4.0 and 5.0 (running in 32-bit mode)
• Red Hat Enterprise Linux^(R) Workstation x86-32 Version 4.0 (tested at Kernel level: 2.6.9-55.0.9.ELsmp #1 SMP i686 athlon i386 GNU/Linux)
• SuSE Linux Enterprise Server (SLES) Version 9 (all service packs; running in 32-bit mode) (tested at Kernel level: 2.6.5-7.286-bigsmp #1 SMP i686 athlon i386 GNU/Linux)
• SuSE Linux Enterprise Server (SLES) Version 10 (running in 32 bit mode)

Additional software requirements

• One of the following Web browsers to view the readme files and the installation guide, and to support the Standard Widget Toolkit (SWT) browser widget:
  • Microsoft Internet Explorer 6.0 with Service Pack 1.
  • Mozilla 1.6 or 1.7.
  • Firefox 1.0.x or 1.5.
    Note:
    On Red Hat Enterprise Linux Workstation Version 4.0, you may need to set the environment variable MOZILLA_FIVE_HOME to the folder containing your Firefox install. For example, setenv MOZILLA_FIVE_HOME /usr/lib/firefox-1.5.
• To properly view multimedia user assistance, such as tours, tutorials, and demonstration viewlets, you must install Adobe^(R) Flash Player.
  • Version 6.0 release 65 or later
  • Version 6.0 release 69 or later
• For information about supported database servers refer to the release notes.

User privileges requirements

• Your user ID must not contain double-byte characters.
• You must have a user ID that belongs to the Administrator group.
• You must be able to log in as root.

Planning to install

Installation scenarios

The following are some of the factors that might determine your installation scenario:

• The format and method by which you access your installation files (for example, from CDs or files downloaded from IBM Passport Advantage^(R)).
• The location for your installation (for example, you can install the product onto your own workstation, or make the installation files available to your enterprise.
• The type of installation (for example, you can use the Installation Manager GUI, or install silently).

These are the typical installation scenarios you might follow:

• Installing from the CDs.
• Installing from a downloaded electronic image on your workstation.
• Installing from an electronic image on a shared drive.

Note that in the latter three scenarios you can choose to run the Installation Manager program in silent mode to install Data Studio. For details on running Installation Manager in silent mode, see Installing silently.

Installing from CDs

In this installation scenario, you have the CDs that contain the product package files, and typically you are installing Data Studio on your own workstation. Refer to Installing Data Studio from CDs: task overview for an overview of the steps.

Installing from a downloaded electronic image on your workstation

In this scenario, you have downloaded the installation files from IBM Passport Advantage and you will install Data Studio on your own workstation. Refer to Installing Data Studio from an electronic image on your workstation: task overview for an overview of the steps.

Installing from an electronic image on a shared drive

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 from a single location. Refer to Installing Data Studio from an electronic image on a shared drive: task overview for an overview of the steps.

Deciding which features to install

When you install the Data Studio 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.

Features

Installation repositories

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. SeeSetting repository preferences in Installation Manager.

By default, IBM 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.

Setting repository preferences in Installation Manager

To add, edit, or remove a repository location in Installation Manager:

1. Start Installation Manager.
2. On the Start page of Installation Manager, click File -> Preferences, and then click Repositories. The Repositories page opens, showing any available repositories, their locations, and whether they are accessible.
3. On the Repositories page, click Add Repository.
4. In the Add repository window, type the URL of the repository location or browse to it and set a file path.
5. Click OK. If you entered a HTTPS repository location, then you will be prompted to enter a user ID and password. The new or changed repository location is listed. If the repository is not accessible, a red x is displayed in the Accessible column.
6. Click OK to exit.

Package groups and the shared resource directory

Package groups

During the installation process, you must specify a package group for the Data Studio 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 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 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 into an existing package group only if the product and version in the existing package group is compatible with Data Studio. 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 a list of products that can share a package group with Data Studio, see the release notes for each Data Studio release.

Shared resources directory

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.

Extending an existing Eclipse IDE

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 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 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 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 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. 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.

Verifying and extracting electronic images

You can compare the published MD5 values with the checksum of the downloaded files to check if the downloaded file is corrupt or incomplete.

Extracting the downloaded files

Extract each compressed file to the same directory.

Preinstallation tasks

1. Confirm that your system meets the requirements described in the section Installation requirements.
2. Confirm that the directory pointed to by your environment variable TEMP has at least 100 MB free. This is in addition to the space required for installing the product.
3. Confirm that your user ID meets the required access privileges for installing the product. See User privileges requirements.
4. Read the section Planning to install.

Installation tasks

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.

Installing Data Studio from CDs: task overview

The following are the general steps for installing from CDs:

1. Complete the preinstallation steps listed in Preinstallation tasks.
2. Insert the first installation CD into your CD drive.
3. If autorun is enabled on your system, the Data Studio Launchpad program automatically opens. If autorun is not enabled, start the Launchpad program. Refer to Starting the Launchpad program for details.
4. Start the installation of Data Studio from the launchpad. For details, see Starting an installation from the Launchpad program.

   If IBM 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.

5. Follow the on-screen instructions in the Install Packages wizard to complete the installation. For details, see Installing IBM Data Studio using the IBM Installation Manager graphical interface.

Installing Data Studio from an electronic image on your workstation: task overview

The following are the general steps for installing Data Studio from an electronic installation image.

1. Ensure that your workstation has sufficient space to store both the files you must download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements.
2. Download all required parts for the product image from IBM Passport Advantage to a temporary directory.
3. Extract the installation image from the downloaded file and verify that the installation image is complete. See Verifying and extracting electronic images for details.
4. Continue with the steps in Installing from an electronic image below.

Installing from an electronic image

1. Complete the preinstallation steps listed in Preinstallation tasks.
2. Start the launcher.
3. Start the launchpad program. Refer to Starting the Launchpad program for details.
4. Start the installation of Data Studio from the Launchpad. For details, see Starting an installation from the Launchpad program.

   If IBM 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.

5. Start the installation of Data Studio from the launcher.

   If IBM 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.

6. Follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Installing IBM Data Studio using the IBM Installation Manager graphical interface.
7. Increase the number of file handles on your workstation. For details, see Increasing the number of file handles on Linux workstations.

Installing Data Studio from an electronic image on a shared drive: task overview

The following steps are performed by the person who places the installation image on a shared drive.

1. Ensure that your shared drive has sufficient disk space to store both the files you must download from IBM Passport Advantage and the extracted installation image. Refer to Hardware requirements for details.
2. Download all required parts for the product image from IBM Passport Advantage to a temporary directory on the shared drive.
3. Extract the installation image from the downloaded files into an accessible directory on the shared drive and verify the installation image is complete. See Verifying and extracting electronic images for details.

To install Data Studio from the installation files on the shared drive:

1. Change to the disk1 directory on the shared drive containing the installation image.
2. Follow the steps in Installing from an electronic image.

Installing from the Launchpad program

Use the launchpad program to start the installation of Data Studio in the following cases:

• Installing from the product CDs.
• Installing from an electronic image on your workstation.
• Installing from an electronic image on a shared drive.

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 package. If you install and start Installation Manager directly, then you must set repository preference manually.

To install from the launchpad:

1. Complete the preinstallation tasks described in Preinstallation tasks, if you have not done so already.
2. Start the launchpad program. See Starting the Launchpad program.
3. Start the installation of Data Studio. See Starting an installation from the Launchpad program.

Follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Installing IBM Data Studio using the IBM Installation Manager graphical interface.

Starting the Launchpad program

Complete the preinstallation tasks described in Preinstallation tasks, if you have not done so already.

If you are installing from a CD and autorun is enabled on your workstation, then the Data Studio launchpad starts automatically when you insert the first installation disc into your CD 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:

1. Insert the IBM Data Studio CD into your CD drive.
2. If autorun is enabled on your system, the IBM Data Studio launchpad program automatically opens. If autorun is not enabled on your system:
   • Run setup.exe located in the root directory of the CD.
   • Run setup located in the root directory of the CD.

Starting an installation from the Launchpad program

1. Start the launchpad program.
2. If you have not done so already, read the release information by clicking Release notes.
3. When you are ready to begin the installation, click Install IBM Data Studio Developer.
4. A message window opens to inform you whether the program IBM Installation Manager is detected on your workstation.
   • If IBM Installation Manager is not detected on your system, then you are informed that you must install it before you can continue.
     1. Click OK to install IBM Installation Manager. The IBM Installation Manager installation wizard starts.
     2. Follow the on-screen instructions in the wizard to complete the installation of IBM Installation Manager. Refer to Installing Installation Manager on Windows for more information.
     3. When the installation of IBM Installation Manager completes successfully, click Finish to close the wizard.
     4. Read the message that opens and click OK. Installation Manager starts and automatically opens the Install Packages wizard.
   • If IBM Installation Manager is detected on your system, click OK and Installation Manager starts and automatically opens the Install Packages wizard.
5. Follow the on-screen instructions in the Install Packages wizard to complete the installation. For complete details, see Installing IBM Data Studio using the IBM Installation Manager graphical interface

Installing IBM Data Studio using the IBM Installation Manager graphical interface

1. The Install page lists all the packages that Installation Manager finds in the repositories that it searches. If two different versions of a package are discovered, only the most recent, or recommended, version of the package is displayed.
   • To display all versions of any package found by Installation Manager, click Show all versions.
   • To return to the display of only the recommended packages, click Show only recommended.
2. Click the IBM Data Studio package to display its description in the Details pane.
3. To search for updates to the IBM Data Studio package, click Check for updates. Installation Manager searches for updates at the predefined Web site for the product package. It also searches any repository locations that you have set. A progress indicator shows the search is taking place. You can install updates at the same time that you install the base product package.
4. If updates for the IBM Data Studio package are found, then they will be displayed in the Packages list on the Install Packages page below their corresponding package. Only recommended updates are displayed by default.
   • To view all updates found for the available packages, click Show all versions.
   • To display a package description under Details, click on the package name.
5. Select the IBM Data Studio package and any updates to the package that you want to install. Updates that have dependencies are automatically selected and cleared together. Click Next to continue.
   Note:
   To install multiple packages at the same time, then all the packages will be installed into the same package group.
6. On the Licenses page, read the license agreement for the selected package. If you selected more than one package to install, there might be a license agreement for each package. On the left side of the License page, click each package version to display its license agreement. The package versions that you selected to install (for example, the base package and an update) are listed under the package name.
   1. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements.
   2. Click Next to continue.
7. On the Location page, type the path for the shared resources directory in the Shared Resources Directory field; or, accept the default path. The shared resources directory contains resources that can be shared by one or more package groups. Click Next to continue.
   Important:
   You can specify the shared resources directory only the first time that you install a package. Use your largest disk for this to help ensure adequate space for the shared resources of future packages. You cannot change the directory location unless you uninstall all packages.
8. On the Location page, either choose an existing package group to install the IBM Data Studio package into, or create a new one. A package group represents a directory in which packages share resources with other packages in the same group. For more information about package groups, refer to Package groups and the shared resource directory. To create a new package group:
   1. Click Create a new package group.
   2. Type the path for the installation directory for the package group. The name for the package group is created automatically.
   3. Click Next to continue.
9. On the next Location page, you can choose to extend an existing Eclipse IDE already installed on your system, adding the functionality in the packages that you are installing. You must have the minimum version of Eclipse that contains compatible features and plugins to select this option. For more information about extending an Eclipse IDE, see Extending an existing Eclipse IDE.
   • If you do not want to extend an existing Eclipse IDE, click Next to continue.
   • To extend an existing Eclipse IDE:
     1. Select Extend an existing Eclipse.
     2. In the Eclipse IDE field, type or navigate to the location of the folder containing the eclipse executable file (eclipse.exe or eclipse.bin). Installation Manager will check if the Eclipse IDE version is valid for the package that you are installing. The Eclipse IDE JVM field displays the Java^(TM) Virtual Machine (JVM) for the IDE that you specified.
     3. Click Next to continue.
10. On the Features page under Languages, select the languages for the package group. The corresponding national language translations for the user interface and documentation for the IBM Data Studio package will be installed. Note that your choices apply to all packages installed under this package group.
11. On the Summary page, review your choices before installing the IBM Data Studio package. If you want to change the choices you made on previous pages, click Back and make your changes. When you are satisfied with your installation choices, click Install to install the package. A progress indicator shows the percentage of the installation completed.
12. When the installation process is completed, a message confirms the success of the process.
    1. Click View log file to open the installation log file for the current session in a new window. You must close the Installation Log window to continue.
    2. In the Install Package wizard, select whether you want IBM Data Studio to start when you exit.
    3. Click Finish to launch the selected package. The Install Package wizard closes and you are returned to the Start page of Installation Manager.

Managing IBM Installation Manager

Installing Installation Manager on Windows

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:

1. Run setup.exe from the InstallerImage_win32 folder on the first installation disk.
2. Click Next on the Welcome screen.
3. Review the license agreement on the License Agreement page and select I accept the terms in the license agreement to accept. Click Next.
4. Click the Change button on the Destination Folder page to change the installation location if required. Click Next.
5. Click Next on the Setup Type page.
6. Click Install on the Ready to Install Program page. The Completed page opens after the installation is complete.
7. Click Finish.

Starting Installation Manager on Windows

IBM Installation Manager should be started from the launchpad program. Doing so starts Installation Manager with a configured repository preference and selected Data Studio packages. If you start Installation Manager directly, then you must set a repository preference and choose product packages manually.

To start Installation Manager manually:

1. Open the Start menu from the Taskbar.
2. Select All Programs -> IBM Installation Manager -> IBM Installation Manager.

Uninstalling Installation Manager on Windows

To uninstall Installation Manager manually:

1. Run setup.exe from the InstallerImager_win32 folder on the first installation disk.
2. Click Next on the Welcome screen.
3. Select the Remove button on the Program Maintenance page. Click Next.
4. Click Next on the Setup Type page.
5. Click Remove on the Remove the Program page.
6. Click Finish on the InstallShield Wizard Completed page.

Installing silently

Running Installation Manager in silent mode is helpful because it enables you to use a batch process to install, update, modify and uninstall product packages through scripts.

Typically, you silently install Installation Manager and the Data Studio package at the same time. The general process is the same as the processes that are described in Recording a response file with the Installation Manager installer and Silently installing and uninstalling Installation Manager. The only difference is that you must run the Installation Manager install program from the <Data Studio media root>/<platform folder>/InstallerImage_<platform> location.

The following tasks are the main tasks that are required for silent installation:

1. Create the response file.
2. Run the silent installation command using one of the following methods:
   • In a typical scenario: Run the Installation Manager silent install command from the <Data Studio media root>/<platform folder>/InstallerImage_<platform>, to install both Installation Manager and the product in one run.
   • In a less typical scenario in which Installation Manager is already installed: Run Installation Manager in silent installation mode to install just the product. You can also choose to use the first method in this situation, in which case the installer will ignore the Installation Manager installation and simply install the product.
3. Install the license key silently. This step must always be performed separately.

Creating a response file with Installation Manager

To record a response file for installation (or uninstallation):

1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager. For example:
   • cd C:\Program Files\IBM\Installation Manager\eclipse
2. On a command line, type the following command to start the Installation Manager, substituting your own file name and location for the response file and (optionally) the log file:
   • IBMIM -record <response file path and name> -log <log file path and name>. For example, IBMIM.exe -record c:\mylog\responsefile.xml -log c:\mylog\record_log.xml
   • You can record a response file without installing or uninstalling a product by adding the optional -skipInstall <agentDataLocation> argument. Note that <agentDataLocation> must be a writable directory. The argument causes the Installation Manager to save the installation data without installing the product. You can use the same <agentDataLocation> in the next recording session to record updates or modifications to the product, or to record license management. Note that the products installed or preferences, including repository settings, that you may have set on install when not using the -skipInstall argument are not be stored. Using -skipInstall will make installation faster because the IM is not installing the product, it is just recording the installation data.

     The syntax for using the skipInstall argument is: IBMIM -record <response file path and name> -skipInstall <a writable directory for agent data location>. For example IBMIM -record c:\mylog\responsefile.xml -skipInstall c:\temp\recordData

   Note:
   Ensure the file paths you enter exist; Installation Manager will not create directories for the response file and the log file.
3. Follow the instructions in the Install Packages wizard to make your installation choices. For details, see Installing IBM Data Studio using the IBM Installation Manager graphical interface.
4. Click Finish, then close Installation Manager.

An XML response file is created and resides in the location specified in the command.

Recording a response file with the Installation Manager installer

To record the installation of Installation Manager, follow these steps:

1. Unzip the Installation Manager, then go to the InstallerImage_platform directory.
2. To start recording, enter install -record <response file path and name> -skipInstall <agentDataLocation> -vmargs -Dcom.ibm.cic.agent.hidden=false

Recording a product install with the installer

To start recording a product install with the Installation Manager installer, follow these steps:

1. Go to the InstallerImage_platform directory in location where you unzipped the Installation Manager.
2. Open the install.ini file by removing the following lines: -input and @osgi.install.area/install.xml
3. Enter the following command: install -record <response file path and name> -skipInstall <agentDataLocation>, for example: install -record
4. Start the Installation Manager and complete the Install Packages wizard.

Silently installing and uninstalling Installation Manager

Silently installing Installation Manager

To install Installation Manager silently, unzip the installer and switch to the InstallerImage_platform subdirectory, then use the following commands:

• For Windows: installc --launcher.ini silent-install.ini -silent -input <response file> -log <log file path and name> .
• For other platforms: install --launcher.ini silent-install.ini -silent -input <response file> -log <log file path and name>.

After installation, you can use Installation Manager or the Installation Manager installer to silently install packages.

Silently uninstalling Installation Manager from Windows

To silently uninstall Installation Manager:

1. Create a response file for the uninstallation.
2. Follow the instructions in Installing and running Installation Manager in silent mode.

Silently uninstalling Installation Manager on other platforms

To silently uninstall Installation Manager on other platforms:

1. From a terminal window, go to the directory uninstallation directory of Installation Manager. By default, this is/var/ibm/InstallationManager/uninstall).
2. Run the following command: uninstall --launcher.ini silent-uninstall.ini

Installing and running Installation Manager in silent mode

Refer to the Installation Manager Web site for additional documentation on how to run it in silent mode. For example, silently installing from a repository that requires authentication (user ID and password).

The following table describes the arguments used with the silent installation command:

-nosplash

--launcher.suppressErrors

-input

-log

Both the Installation Manager installer and the Installation Manager have an initialization or .ini file silent-install.ini that includes default values for the arguments in the table.

The Installation Manager installer is used to install the Installation Manager. Follow these steps to install the Installation Manager silently.

To install Installation Manager silently, unzip the installer and switch to the eclipse subdirectory, then use the following commands:

• installc --launcher.ini silent-install.ini -log <log file path and name> . For example: installc --launcher.ini silent-install.ini -log c:\mylogfile.xml

After Installation Manager is installed, you can use it to install other products. You can also use the Installation Manager installer to install the products.

To run Installation Manager in silent mode run the following command from the eclipse subdirectory:

• IBMIMc.exe --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>. For example: IBMIMc.exe --launcher.ini silent-install.ini -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml

If you want to silently install products using the Installation Manager installer, from the eclipse directory, enter the following command:

• installc.exe --launcher.ini silent-install.ini -input <response file path and name> -log <log file path and name>. For example: installc --launcher.ini silent-install.ini -input c:\mylog\responsefile.xml -log c:\mylog\silent_install_log.xml

When the Installation Manager installer, or Installation Manager runs in silent installation mode; it reads the response file and writes a log file to the directory you specified. While you must have a response file when running in silent installation mode, log files are optional. The result of this execution should be a status of 0 on success and non-zero number on failure.

Searching for and silently installing all available products

To search for and silently install all available products:

1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
2. Enter and run the following command, substituting your own locations for the response file and, optionally, the log file:
   • IBMIMc.exe --launcher.ini silent-install.ini -installAll -log <log file path and name>

All available products known to Installation Manager are installed.

Silently installing updates to all currently installed products

To search for and silently install updates for all available products:

1. On a command line, change to the eclipse subdirectory in the directory where you installed Installation Manager.
2. Enter and run the following command, substituting your own locations for the response file and, optionally, the log file:
   • IBMIMc.exe --launcher.ini silent-install.ini -updateAll -log <log file path and name>

All available product updates known to Installation Manager are installed.

Response file commands

There are two categories of commands for the response file:

• Preference commands are used to set preferences that are found in Installation Manager under File -> Preferences..., such as repository location information.
• Silent installation commands are used to emulate the Install Packages wizard in Installation Manager.

Silent install preference commands

When you define preferences in a response file, your XML code will look similar to the following example:

<preference>
	name = "the key of the preference"
	value = "the value of the preference to be set" 
</preferences>

Use the following table to identify keys and their associated values for silent installation preferences:

Silent installation commands

<profile 
id="the profile (package group) id" 
installLocation="the install location of
 the profile">
<data key="key1" value="value1"/>
<data key="key2" value="value2"/>

</profile>

<server>
<repository location="http://example/
repository/">
<repository location="file:/C:/
repository/">
<!--add more repositories below-->
<...>
      </server>

<install>
<offering profile= "profile id" 
features= "feature ids" 
id= "offering id" version= "offering 
version"></offering>

<!--add more offerings below>
<...>

</install>

<uninstall modify="true">
<offering profile="profileID"
 id="Id" version="Version" 
features="-"/>
</uninstall>

<uninstall>
<offering profile= "profile id" 
features= "feature ids" 
id= "offering id" version= "offering 
version"></offering>

<!--add more offerings below>
<...>

</uninstall>

<rollback>
<offering profile= "profile id"
 id= "offering id" 
version= "offering version">
</offering>

<!--add more offerings below
<...>

</rollback>

<installALL/>

-silent -installAll 

<updateALL/>

-silent -updateAll 

<license policyFile="policy file
 location"/>

<license policyFile="c:\mylicense.opt"/> 

<launcher -mode wizard -input 
< response file >

Reference: Sample response file

<agent-input >

<!-- add preferences -->
<preference name="com.ibm.cic.common.core.preferences. http.proxyEnabled" 
value="c:/temp"/>

<!-- create the profile if it doesn't exist yet -->
<profile id="my_profile" installLocation="c:/temp/my_profile"></profile>

<server>
<repository location= 
"http://a.site.com/local/products/sample/20060615_1542/repository/"></repository>
/server>

<install>
	<offering profile= "my_profile" features= "core" id= "ies" 
version= "3.2.0.20060615">
	</offering>
/install>

</agent-input>

Silent install log files

The silent installation functionality creates an XML-based log file that records the result of the silent install execution (as long as a log file path is specified using -log <your log file path>.xml). If your silent installation session is successful, the log file will contain just the root element of <result> </result>. However, if errors occur during the installation, the silent install log file will contain error elements with messages such as:

<result>
	<error> Cannot find profile: profile id</error>
	<error> some other errors</error>
</result>

For detailed analysis, you can look at the logs generated in the Installation Manager data area. By using a preference command, you can optionally set the data area to your preferred location, as shown in the response file topic.

Managing licenses

Licenses

Authorized User License

An Authorized User license permits a single, specific individual to use a software product. Purchasers must obtain an Authorized User license for each individual user who accesses the product in any manner. An Authorized User license cannot be reassigned unless the purchaser replaces the original assignee on a long-term or permanent basis.

For example, if you purchase one Authorized User license, you can assign that license to one specific individual, who can then use the software product. The Authorized User license does not entitle a second person to use that product at any time, even if the licensed individual is not actively using it.

Authorized User Fixed Term License

An Authorized User Fixed Term License (FTL) permits a single, specific individual to use a software product for a specific length of time (the term). Purchasers must obtain an Authorized User FTL for each individual user who accesses the product in any manner. An Authorized User FTL cannot be reassigned unless the purchaser replaces the original assignee on a long-term or permanent basis.

If you notify IBM that you do not want to extend the license term, then you must stop using the product when the license expires.

License enablement

Licenses for product offerings are enabled by importing a product activation kit.

Activation kits

Product activation kits contain the permanent license key for your product. You purchase, download to your local machine, and then import the activation kit to enable the license for your product. You import the activation kit to your product by using IBM Installation Manager.

Installing permanent license keys silently

Running Installation Manager in silent mode is helpful because it enables you to use a batch process to install, update, modify and uninstall permanent license keys through scripts.

Note that you must install Installation Manager before you can silently install the Data Studio package. Refer to Managing IBM Installation Manager for details on installing Installation Manager.

There are two main tasks required for silent installation of a permanent license key:

1. Create the response file.
2. Run Installation Manager in silent installation mode.

Installing a permanent license key silently on Windows

To install a permanent license key silently on Windows:

1. Create an XML response file:
   1. On a command line, change to the disk1 directory of the Data Studio installation image.
   2. Create a new XML file in this directory. You can name the XML file anything you want. In this example, the XML file is named install_win32_permlic.xml.
   3. Copy the following XML code into the XML file:

      <?xml version="1.0" encoding="UTF-8"?>
      <agent-input>
      <server>
      <repository location="C:\<any_directory>\<Data Studio Developer Product Activation Kit jar file name>"/>
      </server>
      <install modify="false">
      <offering version="1.0.1.20071128_1607" features="main.feature" id="com.ibm.datastudio.developer.pek.la.offering"></offering>
      </install>
      <preference value="<shared directory>" name="com.ibm.cic.common.core.preferences.eclipseCache"/>
      </agent-input>

      where:
      • <any_directory> is the directory on your computer that contains the permanent license key JAR file
      • <shared directory> is the shared resources directory for the product package; for example: C:\Program Files\IBM\SDP70Shared
2. Run <Installation Manager Install Path>\eclipse\IBMIMc.exe -nosplash --launcher.suppressErrors -silent -input <response file> -log <log file>.

Installing a permanent license key silently on Linux

To install a permanent license key silently on Linux:

1. Create an XML response file:
   1. Change to the disk1 directory of the Data Studio installation image.
   2. Create a new XML file in this directory. You can name the XML file anything you want. In this example, the XML file is named install_linux_permlic.xml.
   3. Copy the following XML code into the XML file:

      <?xml version="1.0" encoding="UTF-8"?>
      <agent-input>
      <server>
      <repository location="/<any_directory>/<Data Studio Developer Product Activation Kit jar file name>"/>
      </server>
      <install modify="false">
      <offering version="1.0.1.20071128_1607" features="main.feature" id="com.ibm.datastudio.developer.pek.la.offering"></offering>
      </install>
      <preference value="<shared directory>" name="com.ibm.cic.common.core.preferences.eclipseCache"/>
      </agent-input>

      where:
      • <any_directory> is the directory on your computer that contains the permanent license key JAR file
      • <shared directory> is the shared resources directory for the product package
2. Run <Installation Manager Install Path>/eclipse/launcher -nosplash --launcher.suppressErrors -silent -input <response file> -log <log file>.

Viewing license information for installed packages

To view license information:

1. Start IBM Installation Manager.
2. On the main page, click Manage Licenses.

The package vendor, current license types, and expiration dates are displayed for each installed package.

Importing a product activation kit

You must purchase and download the activation kit to an accessible workstation.

To import an activation kit and enable the new license key:

1. Start IBM Installation Manager.
2. On the main page, click Manage Licenses.
3. On the Manage Licenses page, select a package and click Import product Activation kit.
4. Click Next. Details for the selected package are displayed, including the current license type and the version range the license applies to.
5. Browse to the path of the download location for the kit; then select the appropriate Java archive (JAR) file and click Open.
6. Click Next. The license agreements text is displayed.
7. Click I accept the terms in the license acceptance agreements and then click Next.
8. Click Next. The Summary page displays the target package for the activation kit, the product the new license applies to, the license type and version information.
9. Click Finish.

The product activation kit with its permanent license key is imported to the product. The Manage Licenses wizard indicates whether the import is successful.

Purchasing licenses

To purchase licenses and enable your product, complete the following steps:

1. Determine the type of license you want to purchase.
2. Go to ibm.com^(R) or contact your IBM sales representative to purchase the product license. For details, visit the IBM Web page on How to buy software.

When you want to import the activation kit for your product, use the Manage Licenses wizard in IBM Installation Manager.

Increasing the number of file handles on Linux workstations

Important: For best results, before you work with your product, increase the number of file handles available for Data Studio, because it uses more than the default limit of 1024 file handles per process. (A system administrator might need to make this change.)

Exercise caution when using the following these steps to increase your file descriptors on Linux. Failure to follow the instructions correctly might result in a computer that will not start correctly. For best results, have your system administrator perform this procedure.

To increase your file descriptors:

1. Log in as root. If you do not have root access you will need to obtain it before continuing.
2. Change to the etc directory
3. Use the vi editor to edit the initscript file in the etc directory. If this file does not exist, type vi initscript to create it.

   Important: If you decide to increase the number of file handles, do not leave an empty initscript file on your computer. If you do so, your machine will not start up the next time that you turn it on or restart.

4. On the first line, type ulimit -n 4096 (the key here is that the number is significantly larger than 1024, the default on most Linux computers). Caution: do not set this too high, because it can seriously impact system-wide performance.
5. On the second line, type eval exec "$4".
6. Save and close the file after making sure you have done steps 4 and 5.
   Note:
   Ensure you have followed the steps correctly, as not doing this correctly will result in a machine that does not boot.
7. Optional: Restrict your users or groups by modifying the limits.conf file in the etc/security directory. Both SuSE Linux Enterprise Server (SLES) Version 9 and Red Hat Enterprise Linux Version 4.0 have this file by default. If you do not have this file, you might consider a smaller number in step 4 above (for example, 2048). You need to do this so that most users have a reasonably low limit on the number of allowable open files per process. If you used a relatively low number in step 4, it is less important to do this. However, if you choose to set a high number in step 4, refraining from establishing limits in the limits.conf file can seriously impact computer performance.

   The following is a sample limits.conf file would look that restricts all users and then sets different limits for others afterwards. This sample assumes you set descriptors to 8192 in step 4 earlier.

   *      soft nofile 1024
   *      hard nofile 2048
   root    soft nofile 4096
   root    hard nofile 8192
   user1   soft nofile 2048
   user1 hard nofile 2048
   

   Note that the * in the example above sets the limits for all users first. These limits are lower than the limits that follow. The root user has a higher number of allowable descriptors open, while user1 is in between the two. Make sure you read and understand the documentation contained within the limits.conf file before making your modifications.

For more information on the ulimit command, refer to the man page for ulimit.

Modifying installations

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:

1. From the Start page of the Installation Manager, click the Modify Packages icon.
2. In the Modify Packages wizard, select the installation location for the Data Studio product package and click Next.
3. On the Modify page, under Languages, select the languages for the package group, then click Next. The corresponding national language translations for the user interface and documentation for the packages will be installed. Note that your choices apply to all packages installed under this package group.
4. On the Features page, select the package features that you want to install or remove.
   1. To learn more about a feature, click the feature and review the brief description under Details.
   2. If you want to see the dependency relationships between features, select Show Dependencies. When you click a feature, any features that depend on it and any features that are its dependents are shown in the Dependencies window. As you select or exclude features in the packages, Installation Manager will automatically enforce any dependencies with other features and display updated download size and disk space requirements for the installation.
5. When you are finished selecting features, click Next.
6. On the Summary page, review your choices before modifying the installation package, and then click Modify.
7. Optional: When the modification process completes, click View Log File to see the complete log.

Reverting updates to previous versions

During the rollback process, Installation Manager must access files from the earlier version of the package. By default, these files are stored on your computer when you install a package. If you installed the package from a repository, the files are not available on your computer. You must have listed in your Preferences (File > Preferences > Repository) the repository from which you installed the previous version of the product. If you installed the product from CDs or other media, they must be available when you use the rollback feature.

Use the rollback feature if you have applied an update to a product package and decide later that you want to remove the update and revert to the earlier version of the product. When you use the rollback feature, Installation Manager uninstalls the updated resources and reinstalls the resources from the previous version. You can only roll back one version level at a time.

For more information, see the Installation Manager online help or Information Center.

To revert an update to a previous version, complete the following steps:

1. On the Start page, click Roll back Packages.
2. In the Rollback wizard, from the Installation Packages list, select the package that you want to revert to the previous version.
3. Follow the instructions in the wizard.

Updating Data Studio

By default, Internet access is required unless your repository preferences points to your local update site. See the Installation Manager help for more information.

To find and install product package updates:

1. From the Start page of the Installation Manager, click Update Packages.
2. In the Update Packages page, select the location where the Data Studio product package is installed and then click Next. Installation Manager searches for updates in its repositories and the predefined update sites for Data Studio. A progress indicator shows the search is taking place
3. If updates are found, they are shown on the Updates page. By default, only recommended updates are displayed and they are selected by default. Click Show All to display all available updates. Accept the default selections or select other updates and click Next.
4. On the Licenses page, read the license agreement for the updates. If you agree to the terms of all of the license agreements, click I accept the terms of the license agreements and then click Next.
5. Review the details on the Summary page and then click Update. When the update process finished, the Complete page displays the results.
6. Optional: Click the View Log File link to see the complete log.
7. Click Finish to close the wizard.

Uninstalling Data Studio

To uninstall the packages, you must log in to the system using the same user account that you used to install the product packages.

To uninstall the packages:

1. Close the programs that you installed using Installation Manager.
2. On the Start page click the Uninstall Packages icon.
3. In the Uninstall Packages page, select the Data Studio product package that you want to uninstall. Click Next.
4. In the Summary page, review the list of packages that will be uninstalled and then click Uninstall. The Complete page is displayed after the uninstallation finishes.
5. Click Finish to exit the wizard.

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 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.

Trademarks and service marks

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

• developerWorks^(R)
• IBM
• Passport Advantage
• Rational
• WebSphere^(R)
• iSeries^(TM)
• zSeries^(R)

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.