Before using this information and the product it supports, read the information in Notices.
This edition applies to version 2.2 of IBM Optim Designer and to all subsequent releases and modifications until otherwise indicated in new editions. Instructions are written for version 1.4.3 of Installation Manager, which is compatible with Optim Designer 2.2.
You use the Installation Manager product to install, update, and uninstall the Optim Designer product.
The installation roadmap lists the high-level steps for installing IBM® Optim™ Designer.
This roadmap describes a typical installation using the Installation Manager Install wizard. If you are installing the product silently, see the Silent installation road maps.
Perform these tasks to install the product:
The typical silent installation path is to use the Installation Manager installer to install Installation Manager, and then to use Installation Manager to record a response file, then to silently install software packages. Optionally, you can use the Installation Manager installer to install Installation Manager and software packages at the same time. When you install in silent mode, the user interface is not available; instead, a response file inputs the commands that are required to install the software packages.
There are two main road maps for performing a silent installation.
This section contains instructions for installing, updating, and uninstalling your product package.
Understanding these terms and conventions can help you take full advantage of the installation information and your product.
These terms are used in the installation topics.
The installation documentation uses conventions such as Shared resources directory that infer specific directory locations. This topic describes the conventions in use for this product and the associated default value.
Name | Convention in installation documentation | Default Value |
---|---|---|
Installation Manager installation directory | Installation Manager directory |
|
Installation Manager shared resources directory | Shared resources directory |
|
Product installation directory | Product directory |
|
Product workspace directory | workspace directory |
|
Read all of the following topics before you begin to install or update any of the product features. Effective planning and an understanding of the key aspects of the installation process can help ensure a successful installation.
IBM Installation Manager is a program for installing, updating, and modifying packages. It helps you manage the IBM applications, or packages, that it installs on your computer. Installation Manager does more than install packages: It helps you keep track of what you have installed, determine what is available for you to install, and organize installation directories.
Installation Manager provides tools that help you keep packages up to date, modify the packages, manage the licenses for your packages if required, and uninstall the packages from your system.
Version 1.4.3 of Installation Manager is included with the product. All instructions in this Installation Guide assume that you are using the included version of Installation Manager. If you upgrade later to a higher version of Installation Manager, some of the instructions might not be accurate. The Installation Manager information center is on the Web at: http://publib.boulder.ibm.com/infocenter/install/v1r4/index.jsp
Installation Manager includes six wizards that make it easy to maintain packages through their life cycles:
IBM Installation Manager is the tool that you use to install your software packages. It is installed automatically when you start the installation for your product offering.
If you start the installation of the product by using the launchpad from the product DVD, IBM Installation Manager automatically starts even if it is not already installed. If the correct version of Installation Manager is not installed, you will install Installation Manager on your computer during the process of installing the product.
The latest version of Installation Manager might be required for your package. Updates are discovered if you have not cleared the Search service repositories for updates check box on Repositories page in the Preferences window of Installation Manager.
If you start the installation of the product from the launchpad, IBM Installation Manager automatically starts even if it is not already installed.
If you already installed Installation Manager, you can start it manually:
Installation requires the correct hardware, operating system, software, and other factors.
Before you can install the product, verify that your hardware and software meet or exceed the minimum requirements. If your hardware and software do not meet the minimum requirements, you might be unable to install or run the product.
For the most up to date Optim Designer system requirements, see the technote on the Web: http://www.ibm.com/support/docview.wss?uid=swg27019157
Optim Designer supported operating systems are listed on the product system requirements Web page: http://www.ibm.com/support/docview.wss?uid=swg27019157
You must have a user ID that meets specific requirements before you can install your product.
Your user ID must not contain double-byte characters.
There are two methods of installation: administrative and non-administrative. For information about how to choose between these two options, see the topic: Installation terminology
User ID authority | Case where you install as Non-admin | Case where you install as Admin |
---|---|---|
Non-admin (current user) |
|
|
Admin | An error message occurs. |
|
If you use a Linux or Unix operating system, then you must check that your computer meets the requirements listed in this topic.
You might need to set the environment variable MOZILLA_FIVE_HOME to the folder containing your Firefox or Mozilla installation. For example, setenv MOZILLA_FIVE_HOME /usr/lib/firefox-1.5.
To support the SWT browser widget, your Firefox browser must be dynamically linked, which means it was not downloaded from mozilla.org, but was compiled from source. This is typically the case when the Firefox comes as part of the distribution (that is, it is in a place such as /usr/lib/firefox).
One way to ensure that this is true is to see if it is the browser that is pointed at by /etc/gre.conf. The purpose of this gre.conf file is to point at an embeddable browser.
If your operating system is SUSE Linux Enterprise Desktop 10 SP1 or SUSE Linux Enterprise Server 10 SP1, then you might need the following operating system update to resolve a problem with text not being displayed in some editors:http://support.novell.com/techcenter/psdb/44ab155e3202595389c101e6cf7e20f2.html.
You can customize your software product by selecting which features to install.
When you install the product package by 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 tables show the features of the product that you can install for each package. Default selections of features to install might vary. If a feature already exists in your shared resources directory, it will not be selected by default and will not be installed again.
Feature | Description |
---|---|
Replacement Data, Sample Data, and User Data in Comma Separated Format (with associated DDL) | This feature installs replacement data files, sample data files, and management console user data files in comma-separated (CSV) format, with accompanying Data Definition Language (DDL) files. Use these files to create replacement data tables, sample data tables, and management console user tables in the database of your choice. You could then use these tables instead of installing and using the Optim Replacement Data Database. |
Feature | Description |
---|---|
Core Architect Features | The IBM InfoSphere Data Architect core functionality includes support for physical, logical, glossary, and domain data modeling. If you have WebSphere® Federation Server installed, you can also use the core functionality to enhance and extend the information that you have accessed with the WebSphere Federation Server federated functions. |
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. |
SQL Routines and PL/SQL Development | Provides tooling for developing, testing, and deploying SQL stored procedures and user-defined functions, including wizards, editors, and an integrated stored procedure debugger. |
Oracle Support | Provides support for database objects and storage management, access control for Oracle databases, and support for SQL scripts and PL/SQL development. |
SQL Server Support | Support for connecting to, modeling, and reverse engineering Microsoft SQL Server databases. |
Sybase Support | Support for connecting to, modeling and reverse engineering Sybase databases. |
Teradata Support | Support for connecting to, modeling, and reverse engineering Teradata databases. |
Cloudscape Support | Support for connecting to, modeling, and reverse engineering Cloudscape databases. |
BIRT Visual Report Designer | Provides a solution for producing reports, charts, and documents from a variety of data sources using Business Intelligence and Reporting Tools (BIRT) functionality. |
Rational® RequisitePro® Integration | Provides capabilities for associating data model elements with requirements. You can use the RequisitePro integration to create, manage, and track project requirements. This feature can only be used if the Rational RequisitePro product is installed on the same computer. |
Rational ClearCase® SCM Adapter | The Rational 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. To use this feature, you must have a ClearCase client and a configured ClearCase server. |
UML-to-LDM Transformation | Use the UML-to-LDM transformation feature to transform UML models into logical data models, or to transform logical data models into UML models. |
LDM-to-XSD Transformation | Use the LDM-to-XSD transformation feature to transform logical data models into XSD files or to transform XSD files into logical data models. |
Model Import/Export | Use the model import/export feature to import and export data models from IBM InfoSphere Data Architect to other modeling tools such as ERwin, IBM Rational Rose®, and Sybase PowerDesigner. You can also configure this feature to support additional data model formats. |
Information Server Integration | Use the Information Server Integration feature to transfer metadata between IBM InfoSphere Data Architect and the metadata repository of IBM InfoSphere Information Server. You can transfer glossary model metadata back and forth from IBM InfoSphere Data Architect to the metadata repository. You can also export physical data model metadata from IBM InfoSphere Data Architect to the metadata repository. To use this feature, you must have Microsoft XML Core Services (MSXML) 4.0 Service Pack 2 installed on the same computer and one of the following products: IBM WebSphere Information Services Director; IBM WebSphere Information Analyzer; or IBM WebSphere DataStage® and QualityStage™ Designer. |
Modeled Privacy Integration | Use this feature to export a physical data model that has been annotated with data privacy metadata to an Optim interchange file. |
Feature | Description |
---|---|
External Data Store Support | The Optim Shared Libraries component contains native libraries that are required by all Optim components (Optim Designer, Optim Manager, Optim Management Server, and Optim Proxy). This component must be installed on every machine that has any other another Optim component installed and must be present before any Optim component can be executed on this machine. |
Optim Designer and Optim Manger Documentation | This feature installs documentation for Optim Designer and the Optim Manager environment. |
Feature | Description |
---|---|
Optim Online Help Files | The Optim Designer Online Help Files provide online help for Optim Designer. The online help includes documentation for Optim Designer and the Optim Manager environment. |
Feature | Description |
---|---|
Core Features | The core features of Blueprint Director allow you to author, manage and view blueprints and templates. Blueprints and templates can consist of an architecture diagram part and a method part that are both related together. |
InfoSphere Business Glossary integration | If you have a license of IBM InfoSphere Business Glossary, you can view the terms from Business Glossary within Blueprint Director using the standard InfoSphere Business Glossary Eclipse plugin. You can also drag and drop business terms from the InfoSphere Business Glossary Eclipse plugin onto the Blueprint Director canvas to identify key business elements and requirements as part of your blueprint. |
Cognos Framework Manager integration | If you have a license of IBM Cognos Framework Manager, you can link Blueprint Director elements (e.g. a measure and dimension / "cube" element) to Cognos Framework Manager models and then navigate from Blueprint Director into Cognos Framework Manager from a Blueprint for a selected BI model. You can also generate a Cognos Framework Manager model from a given measure and dimension model in Blueprint Director; this is then also automatically linked. |
InfoSphere DataStage integration | If you have a license of IBM InfoSphere DataStage, you can link your blueprint elements (e.g. an ETL element) to DataStage jobs and then navigate from the blueprint element to the corresponding job which is then opened in the InfoSphere DataStage Designer client. |
InfoSphere Data Architect integration | If you have a license of IBM InfoSphere Data Architect, you can link your blueprint elements (e.g. a data warehouse element) to data models and then navigate from the blueprint element to the corresponding data model that is opened in the Data Architect client. |
InfoSphere Metadata Workbench integration | If you have a license of IBM InfoSphere Metadata Workbench, you can link your blueprint elements (e.g. a database) to metadata that represents that deployed database. You can then navigate from the blueprint element to the display of the corresponding metadata as displayed in InfoSphere Metadata Workbench. |
Part of planning entails making decisions about things such as installation locations, working with other applications, or extending Eclipse. This information helps you with these decisions.
IBM Installation Manager uses two directories when installing product artifacts.
The shared resources directory is where some product resources are installed so that they can be used by multiple product package groups. You define the shared resources directory the first time that you install IBM Installation Manager. For best results, use your largest disk drive for shared resources directories. You cannot change the directory location unless you uninstall Installation Manager.
During installation, you specify a package group into which to install a product.
Optim Designer includes several installation packages.
The following installation packages are available.
An IBM InfoSphere Data Architect installation is a prerequisite for Optim Designer. You must install the IBM InfoSphere Data Architect and Optim Designer installation packages as part of the same package group.
You must also install the Optim Shared Libraries before or at the same time as Optim Designer, however, you cannot install the Optim Shared Libraries at the same time as the InfoSphere Data Architect.
An IBM InfoSphere Data Architect installation is a prerequisite for Optim Designer. You must install the IBM InfoSphere Data Architect and Optim Designer installation packages as part of the same package group.
The InfoSphere Data Architect license activation kit is located in the ida_activation_kit directory on the installation disc.
You can only install Data Architect with Optim Designer, Optim Designer Online Help, and InfoSphere Blueprint Director.
This package also includes documentation for Optim Designer and the Optim Manager environment.
When installed with Optim Designer, the Optim Shared Libraries installation directory must be included in the following environment variable: For Windows, the PATH variable. For Linux, the LD_LIBRARY_PATH variable.
To use Blueprint Director with Optim Designer, install Blueprint Director and Optim Designer in the same package group.
Coexistence refers to the installed products on the same computer.
You can install multiple compatible products into the same package group. This is sometimes also referred to as "shell sharing".
When you install each product package, you select whether you want to install the product package into an existing package group or whether you want to create a new package group. IBM Installation Manager offers only products that are designed to share a package group and meet version compatibility 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.
The Optim components can be installed at the same time. However, IBM InfoSphere Data Architect and InfoSphere Blueprint Director cannot be installed at the same time as a package in a different package group.
Any number of eligible products can be installed to a package group. When a product is installed, the product functions are 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 functions 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 functions available.
Multiple instances of a product package can exist on the same computer and they are automatically installed into separate package groups. The product packages can be at different versions or fix levels.
If you update a product package, you update only that instance of the product.
If you have a previous version of the product, or if you plan to install multiple products on the same workstation, review this information.
Eclipse-based products that have been installed with Installation Manager can share a package group with other compatible products that have been installed with Installation Manager.
For information about other products that are compatible, see the following technote: http://www-01.ibm.com/support/docview.wss?rs=2042&uid=swg21279139
For the most up to date list of compatible products and more information about known compatibility issues and workarounds, see the following technote:http://www.ibm.com/support/docview.wss?rs=3360&uid=swg27014124
The following limitation exists for shared installations:
If you have installed other Eclipse 3.4.2-based products using a mechanism other than Installation Manager, you can attempt to install Optim Designer 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 exactly compatible with this version of Optim Designer.
When you install the product package, you can choose to extend an Eclipse integrated development environment (IDE) already installed on your computer by adding the functions that the product package contains.
This option is not recommended for Optim Designer.
The product package contains a compatible version of the Eclipse IDE or workbench; this bundled workbench is the base platform on top of which the functionality in the product is provided. If you have an Eclipse IDE on your workstation, then you have the option to extend it, that is, add to your current Eclipse IDE the additional functionality provided in the product.
Extending an Eclipse IDE adds the functions of the newly installed product, but maintains your IDE preferences and settings. Previously installed plug-ins are also still available.
Your Eclipse IDE and JRE must be at least at the minimum version levels that the product requires. See the product system requirements for details on the required versions. Installation Manager checks that the Eclipse instance that you specify meets the requirements for the installation package.
Some help systems are configured to use remote help so that you can pull in content from the Web dynamically. With remote help, you always have the latest content available from within your product. Some help systems are not configured to access help content on the Web; in such cases, help content is included with the installation.
If your product is configured to use remote help, you can obtain help three ways. One of these options will be best for you, depending on your needs and situation:
If your help system supports remote help, you can change your access decision any time. If you install multiple products together, you can use different locations for the help for each product, depending on installation footprint, frequency of use, and internet policies. If internet speed is an issue, a longer one-time download and local access might be preferable. Later help updates include only differences.
If you are an administrator and you want users to access help content from an intranet server, see the Installation Manager information center for instructions on how to install the help WAR file on a server.
Before you install, you might need to prepare or configure your computer.
Review the following information and ensure the pre-installation steps are completed as required.
If you download the installation files from IBM Passport Advantage, you must extract the electronic image from the compressed files before you can install the software.
If you select the Download Director option for downloading the installation files, the Download Director applet automatically verifies the completeness of each file that it processes.
When extracting the installation files from the downloaded compressed files, do the following things:
For best product performance, increase the number of file handles above the default of 1024 handles.
Ensure that you complete the following steps correctly. If this procedure is not completed correctly, your computer will not start.
To increase the number of file handles on a Linux computer, complete the following steps:
The following sample limits.conf file restricts all users, and then sets different limits for others afterwards. This sample assumes that you set handles to 8192 in step 4.
Note that the * in the preceding example 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 handles open, while number available to user1 is between the two. Make sure that you read and understand the documentation contained in the limits.conf file before making changes.
With some operating systems, such as Linux, you must mount the appropriate drive before you can access data on the product disc.
For Linux:
Some window managers can automatically mount your DVD drive for you. Consult your computer documentation for more information.
A repository is a location for storing installation or update package data. By default, IBM Installation Manager uses an embedded URL in each product package to connect to a repository server through the Internet and search for available installation packages and new features. You can set these repository locations on the Repositories page in the Preferences window.
This task is only necessary to complete if you are installing from a repository other than the default repository on the Internet or the product media. For example, your organization might require you to redirect the repository to use intranet sites.
The repository is located in the /repo directory on the installation disc.
To specify a repository, complete the following steps:
To install your product package, follow the procedures and information in these topics.
This topic provides the instructions for installing Optim Designer with the Installation Manager Install wizard.
Complete any necessary pre-installation tasks.
This information describes how to start the product package installation for a typical installation. You typically install the product package using the installation launchpad and the Installation Manager Install wizard. For information about how to install the product package silently, see the silent installation information.
For products that are installed by IBM Installation Manager, starting the installation process causes IBM Installation Manager to start even if it is not already installed. You will then install Installation Manager on your computer during the process of installing the product package. The installation wizard is pre-configured with the location of the repository that contains the installation package.
The launchpad includes options to perform either an administrative or a non-administrative installation.
To install IBM Optim Designer with the Installation Manager Install wizard:
If autorun is enabled on your computer, the launchpad automatically opens.
To start the installation manually, follow the next step.
As an alternative if you have already installed Installation Manager separately, you can also start the installation process by following these steps:
Complete any necessary post-installation tasks.
You can install a product package silently by using either Installation Manager in silent installation mode or by using the Installation Manager installer. When you run Installation Manager in silent mode, the user interface is not available; instead, a response file inputs the commands that are required to install the product package.
The typical silent installation path is to use the Installation Manager installer to install Installation Manager, and then to use Installation Manager to record a response file, then to silently install software packages. Optionally, you can use the Installation Manager installer to install Installation Manager and software packages at the same time. When you install in silent mode, the user interface is not available; instead, a response file inputs the commands that are required to install the software packages.
There are two main road maps for performing a silent installation.
The Installation Manager installer is the tool used to install Installation Manager silently. It can also be used to install packages.
The Installation Manager installer is a command-line utility. Run the Installation Manager installer to silently install and uninstall Installation Manager. You can also install software packages using the Installation Manager installer.
If you do not already have Installation Manager installed on your computer, you might choose to use the Installation Manager installer to install both Installation Manager and packages together using a single command. This sample response file provides an example for installing Installation Manager and a software package. If you already have Installation Manager installed on your computer, you can simply use Installation Manager to install packages .
Use the Installation Manager installer to install Installation Manager silently.
The Installation Manager installer is used to install the Installation Manager. You can install the Installation Manager as an administrator, or in non-administrator modes. Follow the example below to install Installation Manager.
After you install Installation Manager silently, you can use Installation Manager or the Installation Manager installer to silently install packages.
You can change the default location for installing Installation Manager by modifying the install.xml response file.
The Installation Manager installer uses a default response file to install Installation Manager installer. You can modify the file to change the default installation location.
Changes were made to the default install.xml response file to change the installation location to C:\IBM\InstallationManager.
<?xml version="1.0" encoding="UTF-8"?> <agent-input clean='true' temporary='true'> <!-- add a profile and specify the installation location using the data value attribute. The location must end in \eclipse --> <profile kind='self' installLocation='C:\IBM\InstallationManager\eclipse' id='IBM Installation Manager'> <data key='eclipseLocation' value='C:\IBM\InstallationManager\eclipse'/> </profile> <server> <repository location='.'/> </server> <!-- add the profile information but do not modify the features, id, and version number --> <install> <offering profile='IBM Installation Manager' features='agent_core,agent_jre' id='com.ibm.cic.agent' version='1.4.3.20110624_0100'/> </install> </agent-input>
Use the Installation Manager installer to install Installation Manager and other software packages.
To install software packages using the Installation Manager installer, you must first create a response file.
You can use the Installation Manager installer to silently install Installation Manager and software packages at the same time. Optionally, use the installer to install Installation Manager, then use Installation Manager to install packages silently.
To silently install packages using the Installation Manager installer, from the InstallerImage_platform directory, enter the following command:
The following table describes the arguments used with the silent installation command:
The Installation Manager installer has an initialization or .ini file silent-install.ini (or user-silent-install.ini for non-administrator installations) that includes default values for the arguments in the table. For example, a default silent-install.ini file might look something like this:
-accessRights admin -vm C:\Program Files\IBM\Installation Manager\eclipse\jre_5.0.2.sr5_20070511\jre\bin\java.exe -nosplash --launcher.suppressErrors -silent -vmargs -Xquickstart -Xgcpolicy:gencon
If the installation is successful, it will return a status of "0" an unsuccessful operation will return a non-zero number.
When Installation Manager installer is run, it reads the response file and (optionally) writes to a log file to the directory specified. If you specified a log file and directory, the log file will be empty if operation was successful, for example:
<?xml version="1.0" encoding="UTF-8"?> <result> </result>
The log file will contain an error element if the operation was not completed successfully.
A log file for Installation Manager is also available. The default locations for the Installation Manager log file are
Launch Installation Manager in silent mode with a response file to install, uninstall, update, or modify packages silently. Installation Manager is the tool that you typically use to install packages silently.
If you do not already have Installation Manager installed on your computer, you can also use the Installation Manager installer to install both Installation Manager and packages together silently using a single command.
Use Installation Manager in silent mode to install product packages from a command line.
After you install Installation Manager, use it in silent mode to install packages. This file explains how to install packages using the Installation Manager.
To run Installation Manager in silent mode, run the following command from the eclipse subdirectory in the directory where you installed Installation Manager:
The following table describes the arguments that are used with the silent installation command:
The Installation Manager has an initialization or .ini file silent-install.ini that includes default values for the arguments in the table. For example, the silent-install.ini file might look something like this:
-accessRights admin -vm C:\Program Files\IBM\Installation Manager\eclipse\jre_5.0.2.sr5_20070511\jre\bin\java.exe -nosplash --launcher.suppressErrors -silent -vmargs -Xquickstart -Xgcpolicy:gencon
If the installation is successful, it will return a status of "0" an unsuccessful operation will return a non-zero number.
When Installation Manager installer is run, it reads the response file and (optionally) writes to a log file to the directory specified. If you specified a log file and directory, the log file will be empty if operation was successful, for example:
<?xml version="1.0" encoding="UTF-8"?> <result> </result>
The log file will contain an error element if the operation was not completed successfully.
A log file for Installation Manager is also available. The default locations for the Installation Manager log file are
You can search for and silently install all available products using the Installation Manager.
Follow these steps to find and install all available products using Installation Manager in silent mode:
All connected repositories are searched, and all available products that are found are installed.
You can use Installation Manager to silently search for and install updates for all currently installed products.
Follow these steps to find and install all available updates for products that are installed:
All available product updates that are known to Installation Manager are installed.
You can silently install from an authenticated repository; however, authenticated repositories need the appropriate credentials for access.
Installation Manager uses the Eclipse infrastructure (www.eclipse.org) to save credentials in a file called a key ring file. While the contents of the key ring file are encrypted, you can provide an additional level of security by specifying a password to open the key ring file. For additional information on key ring files, refer to the Eclipse workbench user's guide available from www.eclipse.org.
To access authenticated repositories in silent mode, complete the following steps:
Use the uninstall script to silently uninstall Installation Manager.
The uninstall script is stored in the Installation Manager uninstall directory. Follow these steps to silently uninstall Installation Manager:
A response file is an XML file that contains the data needed to perform installation operations in silent mode.
Response files are used by both Installation Manager and the Installation Manager installer to perform installation operations silently. You can record a response file by recording preferences and installation actions in Installation Manager in user interface mode, or you can create one manually using the documented list of response file commands and preferences.
A response file is an XML file that contains data read by Installation Manager in silent mode. Using a response file, you can perform almost any action that you can perform using Installation Manager in wizard mode. For example, with a response file you can specify the location of the repository that contains the packages, which package to install, and which features to install for that package. You can also use a response file to modify your installed package, to apply updates, and to apply a license.Sample response file: Installing Installation Manager and packages
You can create a response file by recording your actions in Installation Manager. When you record a response file, all of the selections that you make in Installation Manager are stored in an XML file. When you run Installation Manager in silent mode, Installation Manager uses the data in the XML response file to perform the installation.
When you are recording a response file, you can choose to perform the actions, for example installing a package, or you can choose to just record the create a response file without performing the actions. Note that when you are recording a response file, preferences that you set, including repository settings, are not stored. Follow these steps to record a response file:
For Windows: IBMIM -record <response file and path name> -skipInstall <a writable directory for agent data location>. For example IBMIM -record c:\mylog\responsefile.xml -skipInstall c:\temp\recordData
When you add this argument:You can use the same <agentDataLocation> in the next recording session to record license management, updates, or modifications to the product. These changes will be added to the agent data location.
An XML response file is created and saved in the location that you specified in the command.
If you want to use the silent installation capabilities of Installation Manager, you need to create a response file that contains all of the commands that Installation Manager must run. The recommended way to do this is to create a response file by recording your actions as you install a package. However, you can also create or edit a response file manually.
There are two categories of commands for the response file:
You can use this reference table to learn more about response file commands.
Response file attribute | Description |
---|---|
Clean <agent-input clean="true"> </agent-input> |
By default, the clean attribute is set to 'false'. Installation Manager will use the repository and other preferences that are specified in the response file as well as the existing preferences that are set in the Installation Manager. If a preference is specified in the response file and set in the Installation Manager, the preference that is specified in the response file takes precedence. If the clean attribute is set to 'true', Installation Manager will use the repository and other preferences that are specified in the response file and the existing preferences that are set in the Installation Manager will not be used. |
Temporary <agent-input clean="true" temporary="false"> </agent-input> |
By default, the temporary attribute is set to 'false' and the preferences that are set in your response file will be persisted. When you set the temporary attribute to 'true', the preferences that are set in the response file will not be persisted. You can use the temporary and clean attributes together. For example, if you set clean to 'true' and temporary to 'false', after running the silent install the repository setting that is specified in the response file will override the preferences that were set in the previous sessions using Installation Manager. |
License agreement acceptance <agent-input acceptLicense="false"> </agent-input> |
By default, you do not agree to accept the licenses that an installation package carries when using Installation Manager in silent installation mode. If the package you are installing has a license agreement that must be accepted, the silent installation operation will fail. To accept the license agreement, you must set the attribute to <agent-input acceptLicense="true">. By doing so, you agree to accept the license agreements for every package specified in the response file. |
Reboot later <agent-input rebootLater="false"> </agent-input> |
By default, rebootLater is set to
'false' and if the response file installs any package that requires
rebooting the system on Windows,
Installation Manager will reboot the system after the execution of
the response file is finished.
When rebootLater is set to 'true', the system will not reboot. |
Although you typically specify preferences using the Preferences window, you can also specify preferences (identified as keys) in a response file for use during a silent installation.
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"> </preference>
Use the following table to identify keys and their associated values for silent installation preferences:
You can use an XML-based response file to specify predefined information such as silent installation preferences, repository locations, installation profiles, and so on. Response files are beneficial for teams and companies that want to install software packages silently and to standardize the locations and preferences for the packages.
It can be helpful to record a response file and then tailor the contents to suit your needs. See Recording a response file with Installation Manager for more information on recording a response file.
Sample response files for each Optim package are included in the scripts subdirectory of the package installation directories.
Sample response files are also included on the installation disc, in the scripts directory.
This is a sample response file for installing Installation Manager and a package at the same time.
Sample response file for installing Installation Manager and a software package |
---|
<agent-input clean="true" temporary="true"> <!-- add preferences --> <preference name="com.ibm.cic.common.core.preferences.http.proxyEnabled" value="false"/> <!-- create the profile if it doesn't exist yet --> <profile id="IBM Software Delivery Platform" installLocation="c:/temp/my_profile"></profile> <server> <repository location= "http://a.site.com/local/products/sample/20090215_1542/repository/"></repository> </server> <!-- add the offerings and features to install. You can install Installation Manager and packages in one response file --> <install> <offering id="com.ibm.cic.agent" version="1.3.0.20090114_0637" /> <offering features="com.ibm.rad.sdpcore,com.ibm.rad.jre,com.ibm.rad.webtools_core,com.ibm.rad.pde,com.ibm.rad.data_tools" profile="IBMSoftware Delivery Platform" id="com.ibm.rational.application.developer" version="7006_20080320_1728"/> </install> </agent-input> |
This is a sample response file for installing a software package.
Sample response file for a software package |
---|
<agent-input> <server> <repository location= "http://a.site.com/local/products/sample/20060615_1542/repository/"></repository> </server> <!-- use default installation location and choose the latest version of the offering that is available in the repository --> <install> <offering features= "core" id= "ies"> </offering> </install> </agent-input> |
You can install, update, modify, or uninstall software packages with Installation Manager in wizard mode, using a response file.
Installation Manager can be run in silent mode or wizard mode. To start Installation Manager in wizard mode, enter the following on the command line:IBMIM -mode wizard -input <response> where <response> is the response file path and name.
Based on the commands in your response file, Installation Manager will start in one of the following wizards: install, update, modify, or uninstall. Your response file can only contain commands for one of the Installation Manager wizards. For example, the response file can include either:
You can generate a .zip file that contains data for problem analysis. This file is used by IBM Support to help troubleshoot the problem.
A .zip file that contains the installation data is created.
If you cannot instal Installation Manager, the Installation Manager installer can optionally be used to perform other silent installation operations.
You can search for and silently install all available products using the Installation Manager installer.
Follow these steps to find and install all available products using Installation Manager installer:
All available products found searching the connected repositories are installed.
You can silently search for and install updates for all installed products with the Installation Manager installer.
Follow these steps to find and install all available updates for products that are installed.
All available product updates known to Installation Manager are installed.
You can silently install from an authenticated repository; however, authenticated repositories need the appropriate credentials for access.
You must have Installation Manager installed to install a software package from an authenticated repository.
Installation Manager uses the Eclipse infrastructure to save credentials in a file called a key ring file. While the contents of the key ring file are encrypted, you can provide an additional level of security by specifying a password to open the key ring file. For additional information on key ring files, refer to the Eclipse workbench user's guide available from www.eclipse.org.
To access authenticated repositories in silent mode, complete the following steps:
If you need to install the product to multiple systems, refer to the available articles on the installation Web site.
The Installation Manager information center contains articles that will help you install your product in an enterprise environment. Visit the information center for Installation Manager 1.4.3 at http://publib.boulder.ibm.com/infocenter/install/v1r4/index.jsp.
After you have installed your product package, complete the post-installation tasks or configure your product package as required.
After you have installed your product, complete several tasks to configure and verify the installation.
Review the following information and ensure the post-installation steps are completed as required.
You can start the product from the desktop environment or a command-line interface.
For Windows operating systems: Click Start > All Programs > <package group name> > Optim Designer <Version number>.
To start the product from a command-line interface:
Licensing for your installed IBM software and customized packages is administered using the Manage Licenses wizard in the IBM Installation Manager. The Manage Licenses wizard displays license information for each of your installed packages.
Using the Manage Licenses wizard, you can upgrade trial versions of an offering to a licensed version by importing a product activation kit.
The Optim Management Server license is administered from Optim Manager.
Some products include three types of product licenses: an Authorized User license, an Authorized User Fixed Term License (FTL) and a Floating license. The best choice for your organization depends upon how many people use the product, how often they require access, and how you prefer to purchase your software.
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.
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.
A Floating license is a license for a single software product that can be shared among multiple team members; however, the total number of concurrent users cannot exceed the number of floating licenses you purchase. For example, if you purchase one floating license for a software product, then any user in your organization may use the product at any given time. Another person who wants to access the product must wait until the current user logs off.
To use floating licenses, you must obtain floating license keys and install them on a Rational License Server. The server responds to end-user requests for access to the license keys; it will grant access to the number of concurrent users that matches the number of licenses the organization purchased.
If you are using a trial license, it will expire 30 or 60 days after installation. You need to activate your product to use it after the expiration date.
Licenses for this product are activated by importing a license activation kit.
A license activation kit contains the permanent license key for you product. You purchase the activation kit, download the activation kit compressed file to your computer, and then use IBM Installation Manager to import the activation kit (a .jar file) to activate the license for your product.
The InfoSphere Data Architect license activation kit is located in the ida_activation_kit directory on the installation disc.
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.
To install your permanent license key, you must import the license activation kit from the download location or the product media by using IBM Installation Manager.
If you have not purchased an activation kit, you must do this first. If you have purchased a product or a product activation kit, insert the appropriate CD or download the activation kit from IBM Passport Advantage to an accessible workstation. The activation kit is packaged as a Java archive (.jar) file. The .jar file contains the permanent license key and must be imported to activate your product.
To import an activation kit .jar file and enable the new license key, complete the following steps:
The product activation kit with its permanent license key is imported to the product. The Manage Licenses wizard indicates whether the import is successful.
You can review license information for your installed product packages, including license types and expiration dates, from IBM Installation Manager.
To view license information, complete the following steps:
The package vendor, current license types, and expiration dates are displayed for each installed product package.
You might need to set up or change how you access help content. Help content for Optim Designer is provided in the Optim Designer Online Help installation package.
Help for your product is available on a product information center on the Internet. You can view this help from within the product.
During installation, the option to access help from a remote information center was selected. This is the default selection.
Your product help system can retrieve content installed with the product, as well as content from a remote server running an information center. The information center for your product has the most current help content and when your product is configured to retrieve content from a remote information center, the contents of the information center can be accessed by selecting Help > Help Contents to open your help system.
During installation, your product was configured to access the help from the product information center.
The information center for your product is available from the following URL: http://publib.boulder.ibm.com/infocenter/rdahelp/v7r5/index.jsp.
Follow these steps to check your connection to the information center:
This topic explains how to download, remove, and update help content from the Local Help System Updater site. Most help content is not installed when you install your product. To access all help content locally, you need download it from the IBM Local Help System Updater Web site.
During installation, the help access option, Download help and access the content locally, was selected.
Before using the help for the product, you have to download the help to your local system.
To download the help content from the Local Help System Updater site, complete the following steps:
The help that you selected is installed on your system. The files will be updated automatically when an Internet connection is available.
Use the Local Help System updater to ensure that you have the latest help content.
You have installed help features from the Local Help System Updater Web site.
Updates are automatically installed each time you start the product, if you have an Internet connection.
To update the help without restarting the product, complete the following steps:
You can use the Local Help System Updater to remove installed help content.
You have downloaded help features using the Local Help System Updater.
To remove installed help content, complete the following steps:
You can set up an intranet server behind a firewall to provide help content to users. In this way, users do not have to download and save help content to their computers.
You have a server available that can be accessed by users behind a firewall.
See the Installation Manager information center for the instructions for setting up an intranet server for help content.
The WAR file that is needed to set up IBM Optim Designer help on an intranet server is located on the product DVD, in the enterprise folder.
You can change the way that you access help content.
During the installation process, a help content access method was selected. Close the help browser before you change the way you access help content.
To change the way that you access help content, complete the following steps:
The Modify Packages wizard in the IBM Installation Manager enables you to change the feature and language selections of an installed product package. You can also use the Modify Packages wizard to install new features that might be included in a package update, such as a refresh pack.
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:
Package updates provide fixes and updates to installed product packages. You can use the Update Packages wizard in IBM Installation Manager to install updates for product packages that were installed by using IBM Installation Manager.
Internet access is required unless your repository preferences points to a local update site.
Each installed package has the location embedded for its default IBM update repository. For Installation Manager to search the IBM update repository locations for the installed packages, the preference Search service repositories during installation and updates on the Repositories preference page must be selected. This preference is selected by default.
See the Installation Manager help for more information.
To find and install product package updates:
You can remove an update, such as a fix pack, to a product package to revert to a previous version by using the Roll Back Packages wizard of IBM Installation Manager.
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 upgrade to a new package. If you have deleted the files that are saved locally for rollback or cleared the Save files for rollback check box in the Preferences page (File > Preferences > Files for Rollback) while upgrading, you will not be able to roll back to the previous version without the media or repositories that were used to install that version of the package.
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:
You can use the Uninstall option in IBM Installation Manager to uninstall software that was installed by using Installation Manager from your computer.
For Windows, you can use the Control Panel and, for Linux and UNIX, you can use the Uninstall IBM Installation Manager icon on your computer's desktop to uninstall IBM Installation Manager.
You can use the Uninstall option in IBM Installation Manager to uninstall a product package from a single installation location. You can also uninstall all the installed packages from every installation location.
To uninstall a product package, you must log in to the system by using the same user account that you used to install the product package. You must close the programs that you installed by using IBM Installation Manager.
To uninstall a product package, complete the following steps:
You can follow the instructions below to uninstall IBM Installation Manager.
Before you can uninstall IBM Installation Manager, you must uninstall all of the packages, including products that were installed by IBM Installation Manager. You must close Installation Manager before attempting to uninstall the program. You must log in to the computer by using the same user account that you used to install Installation Manager.
To uninstall Installation Manager, complete the following steps:
Version 2, Release 2 of IBM Optim Designer provides the following enhancements:
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.
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. These and other IBM trademarked terms are marked on their first occurrence in this information with the appropriate symbol (® or ™), indicating US registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A complete and current list of IBM trademarks is available on the Web at http://www.ibm.com/legal/copytrade.shtml
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.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other company, product or service names, may be trademarks or service marks of others.