of 44/44
Release 6.2 Installation Guide UNIX IBM Maximo Integration Composer

IBM Maximo Integration Composerpublib.boulder.ibm.com/tividd/td/ITMIntC/621_mx_int_comp...Maximo Discovery 4.5, 4.51, 4.52, 2005 SQL Server JDBC Maximo MainControl i.collect 4.3.2

  • View
    17

  • Download
    7

Embed Size (px)

Text of IBM Maximo Integration Composerpublib.boulder.ibm.com/tividd/td/ITMIntC/621_mx_int_comp...Maximo...

  • Release 6.2

    Installation GuideUNIX

    IBM Maximo Integration Composer

  • Second Edition (January 2007)This edition applies to Release 6.2 of IBM Maximo Integration Composer and to all subsequent releases and modifications until otherwise indicated in new editions.

    Third-Party Technology: Certain Maximo products contain technology provided under license from third parties, as noted in the following table:

    Open Source: Maximo contains computer software obtained from the public domain, known as "Open Source" ownership of which is attributed as follows: Portions © 2002, Steve Souza ([email protected]). Portions © 2000-2004, Jason Hunter & Brett McLaughlin. Portions © 2004-2005, The Apache Software Foundation (http://www.apache.org/).

    © Copyright International Business Machines Corporation 2007. All rights reserved.

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

    IBM Product Third-Party Information

    All Products Portions © 1996-2003 Visual Mining, Inc. Visual Mining NetCharts Server provided by Visual Mining, Inc.

    IBM Maximo Portions © 1995-2004 Actuate Corporation.

    Portions © 2005 BEA Systems, Inc. BEA WebLogic Server® provided by BEA Systems, Inc.

    Portions © 1996-2005, i-net software GmbH. J-Integra for COM® v2.4. © 2004 Intrinsyc Software International, Inc.

    Maximo Discovery MSDE Copyright © Microsoft® Corporation.

    © 1998-2005 Centennial Software Limited.

    IBM Maximo Asset Navigator Portions © 1993-2002 Snowbound Software Corporation. RasterMaster Raster imaging technology provided by Snowbound Software Corporation.

    IBM Maximo Mobile Portions © 2005 DataMirror, Inc.

    Portions © 2000-2005 Zaval Creative Engineering Group.

    IBM Maximo Mobile SE Portions © 1996-2005 Syclo, LLC.

    NoteBefore using this information and the product it supports, read the information in Notices on page Notices-1.

  • © Copyright IBM Corp. 2007 iii

    About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vAudience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vRelated Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

    Chapter 1: IBM Maximo Integration Composer Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1Integration Composer Hardware/Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1Integration Composer Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

    Chapter 2: Installing IBM Maximo Integration Composer Release 6.2.1 . . . . . . . . . . . . . . . . . . . . . 2-1Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1Installation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2Installing IBM Maximo Integration Composer 6.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

    Chapter 3: Upgrading to Integration Composer Release 6.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1Updates Included in Release 6.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1Upgrade Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1Upgrade Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1Upgrading to Integration Composer Release 6.2.1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2Verifying Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11

    Chapter 4: Uninstalling IBM Maximo Integration Composer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1Uninstalling IBM Maximo Integration Composer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

    Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Notices-1

    Contents

  • iv IBM Maximo Integration Composer: Installation Guide

  • © Copyright IBM Corp. 2007 v

    About This Guide

    The IBM® Maximo® Integration Composer (formerly Maximo Fusion) is an integration tool that imports information technology asset data collected by asset discovery tools into the deployed assets database tables in IBM Maximo Asset Management. This guide explains how to perform the following tasks:

    ! install IBM Maximo Integration Composer release 6.2.1 in a UNIX® environment

    ! upgrade an existing UNIX installation of IBM Maximo Integration Composer to release 6.2.1

    ! uninstall the Integration Composer application

    This section explains how this guide can help you to install the Integration Composer. It also provides information about other IBM Corporation resources available to you, such as additional documentation and support.

    Audience

    This guide is designed for the system administrator, network administrator, or other professional who installs software tools associated with Maximo.

    Related Documentation

    For more information about Maximo, refer to the following documentation:

    Document Description

    IBM Maximo Finance Managers Guide

    Describes how IBM Maximo completes financial transactions and how to set up general ledger accounts.

    IBM Maximo Installation Guide Describes how to install and configure the following software:

    ! Application server! IBM Maximo! Actuate®

    IBM Maximo Multisite Administrators Guide

    Describes how to configure IBM Maximo for a Multisite implementation.

  • Related Documentation

    vi IBM Maximo Integration Composer: Installation Guide

    For more information about the Integration Composer, refer to the following documentation:

    IBM Maximo Online Help Provides step-by-step procedures for Maximo applications.

    IBM Maximo Reconciliation Implementation Guide

    Describes how to use the IBM Maximo Reconciliation module to reconcile the two types of information that IBM Maximo maintains about information technology (IT) assets: IT asset data and deployed asset data.

    IBM Maximo Report Administration and Development Guide

    Describes how to use Actuate to design and administer IBM Maximo reports.

    IBM Maximo System Administrators Guide

    Describes database configuration, security, and other administrative level applications and tasks.

    IBM Maximo Users Guide Provides an overview of the Maximo end user applications. It also describes how the IBM Maximo applications interact with each other.

    IBM Maximo Workflow Implementation Guide

    Provides information about how to use IBM Maximo to plan, design, build, test, implement, and manage Workflow processes.

    IBM Maximo Enterprise Adapter (MEA) System Administrator's Guide

    Describes how to configure and use the IBM MEA.

    Document Description

    IBM Maximo Integration Composer System Administrators Guide

    Describes how to use the Integration Composer to map data from an external source and import the data into the Maximo database.

    IBM Maximo Integration Composer Installation Guide

    Describes how to install and configure the Integration Composer. IBM Corporation provides installation guides for the following platforms:

    ! Microsoft Windows®

    ! UNIX

    Integration Composer Help

    Provides step-by-step procedures for the Integration Composer.

    Document Description

  • Support

    About This Guide vii

    Support

    IBM Maximo users with a valid Annual Customer Support Plan (ACSP) can obtain product support online at Support Online: support.mro.com.

    Support Online includes information about product releases, software patches, and documentation updates. To find the most current version of a document, refer to the Knowledge Base on this site.

    IBM Maximo Integration Adapter Implementation Guide

    Describes how to install and configure adapters purchased for the Integration Composer. IBM Corporation provides adapter implementation guides for the following products:

    ! Altiris® Inventory Solution®

    ! Centennial Discovery®

    ! HP Configuration Management (CM) Inventory Manager

    ! IBM Tivoli® Configuration Manager

    ! Maximo MainControl® i.collect

    ! Maximo Discovery®

    ! Microsoft SMS

    Document Description

    http://support.mro.com

  • Support

    viii IBM Maximo Integration Composer: Installation Guide

  • © Copyright IBM Corp. 2007 1-1

    This chapter introduces you to the IBM Maximo Integration Composer, the IBM Corporation solution for migrating information technology (IT) asset data into Maximo. With the Integration Composer, enterprises can aggregate data collected by disparate asset discovery tools and integrate it into Maximo, creating a central repository for enterprise IT asset management, reporting, and decision support.

    To gather deployed asset data, an asset discovery tool, such as IBM Tivoli Configuration Manager or Altiris Inventory Solution, scans computers, network devices, and network printers deployed in an enterprise and records information about the hardware and software installed on those assets. The Integration Composer transforms the collected data and imports it into Maximo.

    You can view imported data in the following Maximo applications: Computers, Network Devices, and Network Printers. Maximo also uses data imported by the Integration Composer to generate various reports.

    Integration Composer Hardware/Software Requirements

    This section of the installation guide describes the version of Maximo supported by the Integration Composer and the hardware and software requirements for the application server and database server. It also lists the asset discovery tools supported by the Integration Composer.

    Maximo Version Supported You can use Integration Composer 6.2.1 with Maximo 6.2.1.

    Application Server The Application Server, which runs the core Integration Composer application and Java components, supports the following operating systems:

    ! Microsoft Windows 2000/2003 Server! Solaris 9 and Solaris 10! HP-UX 11i v1 and HP-UX 11i v2! IBM AIX® 5.2 and 5.3! RedHat® Linux® 3

    The Integration Composer has the following minimum requirements:

    ! 2 GB (or more) memory! 70 MB or greater disk space! J2SE SDK 1.4.2_05

    IBM Maximo Integration Composer Overview 1

  • Integration Composer Hardware/Software Requirements

    1-2 IBM Maximo Integration Composer: Installation Guide

    Database Server The customer is responsible for the Database Servers, which contain and manage the source database(s) and Maximo database. Refer to the appropriate vendor for hardware requirements.

    Maximo supports the following database platforms:

    ! IBM DB2® Universal Database 8.2.7

    ! Microsoft® SQL Server 2000, Service Pack 4

    ! Microsoft SQL Server 2005

    ! Oracle® 9.2.06

    ! Oracle 10.1.0.3 or 10.2.0.1 (either Oracle Standard or Enterprise)

    NOTE Oracle 10.2.0.1 requires Maximo patch 3 or higher.

    Asset Discovery Tools To facilitate data migration, IBM Corporation offers optional IBM Maximo integration adapters to convert and migrate data provided by the most commonly used asset and systems management tools, such as IBM Tivoli Configuration Manager. The adapters provide pre-defined mapping expressions that let you transform data and transfer it from a database created by an asset discovery tool into the Maximo database. You can import an adapters mapping into the Integration Composer and, with little or no additional programming, execute a mapping to import data into Maximo.

    The following table lists platform and driver requirements for the asset discovery tools supported by the Integration Composer.

    Asset Discovery Tools Supported

    Asset Discovery Tool Database Platform Drivers

    Altiris Inventory Solution 5.5, 6.0 SQL Server JDBC

    Centennial Discovery 4.5, 4.51, 4.52, 4.53, 2005 SQL Server JDBC

    HP Configuration Management (CM) Inventory Manager

    (formerly HP Inventory Manager using Radia®)

    SQL Server

    Oracle

    JDBC

    Oracle JDBC Thin

    IBM Tivoli Configuration Manager 4.0, 4.2 Oracle

    DB2

    Oracle JDBC Thin

    DB2 JDBC

    Maximo Discovery 4.5, 4.51, 4.52, 2005 SQL Server JDBC

    Maximo MainControl i.collect 4.3.2 SQL Server

    Oracle

    JDBC

    Oracle JDBC Thin

    Microsoft SMS 2.0, 2003 SQL Server JDBC

    The i-net OPTA JDBC driver for Microsoft SQL Server 7/2000 and 2005, the Oracle JDBC Thin driver , and the DB2 JDBC driver are installed with the Integration Composer.

  • Integration Composer Components

    IBM Maximo Integration Composer Overview 1-3

    Integration Composer Components

    The Integration Composer integration tool includes the following components:

    ! Integration Composer application! Integration Composer engine! JDBC drivers! Integration Composer repository

    Integration Composer Application

    The Integration Composer has a Windows-based graphical user interface (GUI) that lets you define data sources, browse data source data, define data schemas, and create mappings to transform and migrate data.

    Integration Composer Engine

    The Integration Composer engine processes mapping expressions that transform data from the source data source and integrate it into a target data source.

    JDBC Drivers The Integration Composer uses JDBC drivers to establish connections between a source data source and a target data source. IBM Corporation provides the following JDBC drivers with the Integration Composer:

    ! IBM DB2 JDBC driver.

    ! i-net OPTA JDBC driver for Microsoft SQL Server 7/2000 and SQL Server 2005.

    ! Oracle JDBC Thin driver. This driver supports Oracle 10g and earlier versions (including 8.0, 8i, and 9i).

    Integration Composer Repository

    The Integration Composer repository resides in the Maximo database and contains the following Integration Composer data:

    ! Metadata for read-only data schemas delivered with the Integration Composer. This metadata defines the structure of the data.

    ! Metadata for data schemas that users create in the Integration Composer.

    ! Data source definitions that provide database connection parameters.

    ! Mappings that define how to transform data and migrate it from a source to a target.

    ! If a last scan time stamp exists, the Integration Composer stores the most recent last scan time stamp for every source IT asset in the Integration Composer repository.

  • Integration Composer Components

    1-4 IBM Maximo Integration Composer: Installation Guide

  • © Copyright IBM Corp. 2007 2-1

    NOTE Use the instructions in this chapter for new installations only. If you are upgrading an existing installation, see Chapter 3, "Upgrading to Integration Composer Release 6.2.1," on page 3-1.

    This chapter provides instructions for installing Integration Composer release 6.2.1 on servers running UNIX. The file that installs the Integration Composer uses an installer program to guide you through the installation process. The installer program installs the Integration Composer application and related files. It also installs an uninstall utility that you can use to remove the Integration Composer.

    When the installation is complete, you can access the Integration Composer by entering

    ./startFusion.sh

    Installation Prerequisites

    You must install JDK 1.4.2_05 on the Integration Composer application server before you install the Integration Composer.

    In addition, the PATH environment variable must include the location of the Java virtual machine (for example, j2sdk1.4.2_05\bin).

    Because the following software might adversely affect installation, you should disable these programs before attempting to install the Integration Composer:

    ! antivirus software, such as Norton or Symantec®

    ! Dell OpenManage! pcAnywhere®

    Use of these software programs adversely affects InstallAnywheres ability to install programs; the problem is not specific to the Integration Composer.

    Installing IBM Maximo Integration Composer Release 6.2.1

    2

  • Installation Checklist

    2-2 IBM Maximo Integration Composer: Installation Guide

    Installation Checklist

    This checklist provides an overview of the installation process for release 6.2.1 of the Integration Composer.

    Installing IBM Maximo Integration Composer 6.2.1

    You can run the Integration Composer installation program as an X Window application or in console mode. If you use the X Window application, you will see the screens shown in this chapter.

    To install the Integration Composer, locate the setup.bin file on the Integration Composer CD-ROM or download this file from Support Online.

    To install the Integration Composer, complete the following steps:

    NOTE Screens displayed for your installation might differ in appearance from the screens in these steps; however, the content is the same.

    1 Sign in as an administrator to run this installation.

    2 To run the Integration Composer installation program:

    ! as an X Window application, type the following command at the shell prompt:

    sh ./setup.bin

    ! in console mode, type the following command:

    sh ./setup.bin -i console

    In console mode, you are prompted to enter information line by line. The information you enter and the sequence in which you enter it are similar to the process described in the following instructions, which describe the installation using the X Window application.

    3 Press Enter. The installer displays the Introduction dialog box, as shown in the following figure.

    [ ] 1 Download the IBM Maximo Integration Composer 6.2.1 installation file from Support Online or insert the IBM Maximo Integration Composer 6.2.1 CD-ROM into your computer.

    [ ] 2 Install Integration Composer release 6.2.1.

    [ ] 3 Verify that the Integration Composer application starts successfully.

  • Installing IBM Maximo Integration Composer 6.2.1

    Installing IBM Maximo Integration Composer Release 6.2.1 2-3

    Introduction Dialog Box

    4 Close all programs currently open on your computer, and click Next. The installer displays the Select Install Type dialog box, as shown in the following figure.

    Select Install Type Dialog Box

    Close all programs currently open on your computer, and click Next. The installer displays the Choose Install Folder dialog box, as shown in the following figure.

    5 In the Select Install Type folder, select the type of installation and click Next. The installer displays the Choose Install Folder dialog box.

  • Installing IBM Maximo Integration Composer 6.2.1

    2-4 IBM Maximo Integration Composer: Installation Guide

    Choose Install Folder Dialog Box

    6 In the Choose Install Folder dialog box, accept the default location or enter a file path to specify where you want to install the Integration Composer. You can click Choose to browse to the desired location.

    7 After you select an installation location, click Next. The installer displays the Choose Java 2 SDK Location dialog box, as shown in the following figure.

    Choose Java 2 SDK Location Dialog Box

  • Installing IBM Maximo Integration Composer 6.2.1

    Installing IBM Maximo Integration Composer Release 6.2.1 2-5

    8 In the Choose Java 2 SDK Location dialog box, accept the default location or enter a file path to specify where Java 2 SDK is installed. You can click Choose to browse to the desired location.

    9 After you specify an installation location, click Next. The installer displays the Database Type dialog box, as shown in the following figure.

    Database Type Dialog Box

    10 In the Database Type dialog box, select the type of database you will use with the Integration Composer and click Next.

    The installer displays the Database Login Information dialog box.

  • Installing IBM Maximo Integration Composer 6.2.1

    2-6 IBM Maximo Integration Composer: Installation Guide

    Database Login Information Dialog Box

    The fields displayed in this dialog box vary depending on the type of database you use.

    Oracle Database The following table lists the fields the installer displays for an Oracle database.

    SQL Server Database The following table lists the fields the installer displays for a SQL Server database.

    Field Description

    Database Server Name Name of the server on which the Maximo database resides.

    Port Number Port number of the server on which the Maximo database resides.

    Database Name (SID) Session identifier for the database; that is, the database instance.

    Database/Schema Owner Database/schema owner.

    Database Username Valid user name for signing in to the Maximo database.

    Field Description

    Database Server Name Name of the server on which the Maximo database resides.

    Port Number Port number of the server on which the Maximo database resides.

    Database Name Name of the database.

  • Installing IBM Maximo Integration Composer 6.2.1

    Installing IBM Maximo Integration Composer Release 6.2.1 2-7

    DB2 Database The following table lists the fields the installer displays for a DB2 database.

    NOTE Make note of the values entered here. When you launch Integration Composer, you use the values entered in these fields to define connection parameters for the target Maximo data source.

    11 In the Database Login Information dialog box, enter login specifications for the database and click Next. The installer displays the Update Software Instances dialog box.

    Update Software Instances Dialog Box

    Database Username Valid user name for signing in to the Maximo database.

    Field Description

    Field Description

    Database Server Name Name of the server on which the Maximo database resides.

    Port Number Port number of the server on which the Maximo database resides.

    Database Name Name of the database.

    Database Username Valid user name for signing in to the Maximo database.

    Database/Schema Owner Database/schema owner.

  • Installing IBM Maximo Integration Composer 6.2.1

    2-8 IBM Maximo Integration Composer: Installation Guide

    12 In the Update Software Instances dialog box, select one of the following options and click Next:

    ! Yes, disable software updates

    If you select this option, when the Integration Composer imports data into Maximo, it inserts or deletes software records, but it does not update software records. This is the preferred option.

    ! No, dont disable software updates

    If you select this option, when the Integration Composer imports data into Maximo, it updates existing software records.

    After you click Next, the installer displays the Choose Internet Browser File dialog box, as shown in the following figure.

    Choose Internet Browser File Dialog Box

    13 In the Choose Internet Browser File dialog box, accept the default or enter another Internet browser file. You can click Choose to browse to the desired location.

  • Installing IBM Maximo Integration Composer 6.2.1

    Installing IBM Maximo Integration Composer Release 6.2.1 2-9

    14 After you specify a browser file, click Next. The installer displays the Pre-Installation Summary dialog box, as shown in the following figure.

    Pre-Installation Summary Dialog Box

    15 In the Pre-Installation Summary dialog box, review the installation details and click Next. The installer displays the Installing IBM Maximo Integration Composer dialog box, as shown in the following figure.

    Installing IBM Maximo Integration Composer Dialog Box

    NOTE If necessary, you can click Cancel to cancel the installation.

  • Installing IBM Maximo Integration Composer 6.2.1

    2-10 IBM Maximo Integration Composer: Installation Guide

    When the installation is complete, the installer displays the Installation Complete dialog box, as shown in the following figure.

    Installation Complete Dialog Box

    16 Click Next. The installer displays the Update IBM Maximo Integration Composer dialog box, as shown in the following figure.

    Update IBM Maximo Integration Composer Dialog Box

    By default, the Check for Updates to IBM Maximo Integration Composer check box is selected.

  • Installing IBM Maximo Integration Composer 6.2.1

    Installing IBM Maximo Integration Composer Release 6.2.1 2-11

    17 In the Update IBM Maximo Integration Composer dialog box, select one of the following options:

    ! To complete the installation without checking for updates, clear the Check for Updates to IBM Maximo Integration Composer check box and click Done. The installer closes the dialog box.

    ! To check for updates, complete the following steps:

    a Verify that the Check for Updates to IBM Maximo Integration Composer check box is selected and click Done. If the installer finds updates, it downloads them. This might take a few moments.

    b Select the appropriate option:

    ! If you use console mode, you must launch the update program manually. Confirm that the update program downloaded the file setup.bin to the \PowerUpdateClient directory, then type the following command:

    sh ./setup.bin -i console

    In console mode, you are prompted to enter information line by line.

    ! If you use an X Window application, the installer program launches the update and displays the Introduction dialog box.

    c Install the updates.

    The Integration Composer installation is complete.

  • Installing IBM Maximo Integration Composer 6.2.1

    2-12 IBM Maximo Integration Composer: Installation Guide

  • © Copyright IBM Corp. 2007 3-1

    This chapter provides instructions for upgrading an existing Integration Composer installation to release 6.2.1 of the IBM Maximo Integration Composer.

    Updates Included in Release 6.2.1

    IBM Maximo Integration Composer 6.2.1 provides support for IBM DB2.

    Integration Composer 6.2.1 also provides a new mapping feature. Users can create a mapping that inserts only assets, computers, network devices or network printers not moved in previous runs. To use this feature, you must select Insert Only from the Select Action menu in the Mapping window when creating a mapping. Then when you execute the mapping, Integration Composer inserts only new deployed assets (computers, network devices or network printers) or assets. It does not update existing deployed assets or assets.

    NOTE This feature only works on data sources that contain a last scan date.

    This release also includes program fixes for reported issues.

    Upgrades to the Maximo database are implemented by Maximo 6.2.1.

    Upgrade Prerequisites

    Before installing this update, install Integration Composer 6.0 or later.

    Upgrade Checklist

    This checklist provides an overview of the upgrade process for release 6.2.1 of the Integration Composer. You will find detailed instructions later in this chapter.

    Upgrading to Integration Composer Release 6.2.1 3

    [ ] 1 Back up the entire Integration Composer installation folder.

    [ ] 2 Install Integration Composer release 6.2.1.

    [ ] 3 Verify that Integration Composer was updated correctly.

  • Upgrading to Integration Composer Release 6.2.1

    3-2 IBM Maximo Integration Composer: Installation Guide

    Upgrading to Integration Composer Release 6.2.1

    This section of the installation guide explains how to upgrade to Integration Composer Release 6.2.1.

    Before You Begin Before you install Release 6.2.1, create a backup for your entire Integration Composer installation folder.

    Upgrading to Release 6.2.1 You can upgrade to release 6.2.1 using one of the following options:

    ! Locate the setup.bin file on the Integration Composer CD-ROM or download this file from Support Online, then use the file to upgrade your installation.

    ! Use PowerUpdate, which is located in your Integration Composer installation directory, to upgrade the installation.

    To upgrade to Integration Composer release 6.2.1 in a UNIX environment, complete the following steps:

    1 Select one of the following options:

    ! To upgrade using the setup.bin file that you downloaded from Support Online or that you loaded from the Integration Composer CD-ROM, complete the following steps:

    a To run the Integration Composer installation program, select one of the following options:

    ! To run the installation as an X Window application, type the following command at the shell prompt:

    sh ./setup.bin

    ! To run the installation in console mode, type the following command:

    sh ./setup.bin -i console

    In console mode, you are prompted to enter information line by line. The information you enter and the sequence in which you enter it are similar to the process described in the following instructions, which describe the installation using the X Window application.

    b Press Enter. The update program displays the Introduction dialog box. Go to step 2 on page 3-3.

    ! To upgrade using PowerUpdate, complete the following steps:

    a On the server where you installed the Integration Composer, from the shell window navigate to the following location:

    \PowerUpdateClient

  • Upgrading to Integration Composer Release 6.2.1

    Upgrading to Integration Composer Release 6.2.1 3-3

    where is the Integration Composer installation directory.

    b Type the following command at the shell prompt:

    sh ./update

    NOTE Typing this command downloads the update program. If you are running an X Window application client, this command also launches the update program.

    c Select the appropriate option:

    ! If you use console mode, you must launch the update program manually. Confirm that the update program downloaded the file setup.bin to the \PowerUpdateClient directory, then type the following command:

    sh ./setup.bin -i console

    In console mode, you are prompted to enter information line by line. The information you enter and the sequence in which you enter it are similar to the process described in the following instructions, which describe the installation using the X Window application.

    ! If you use an X Window application, the update program launches the update and displays the Introduction dialog box, as shown in the following figure. Go to step 3 on page 3-4.

    Introduction Dialog Box

    2 In the Introduction dialog box, click Next. The update program displays the Select Install Type dialog box, as shown in the following figure.

  • Upgrading to Integration Composer Release 6.2.1

    3-4 IBM Maximo Integration Composer: Installation Guide

    Select Install Type Dialog Box

    3 In the Select Install Type dialog box, select Upgrade and click Next. The update program displays the Choose Install Folder dialog box, as shown in the following figure.

    Choose Install Folder Dialog Box

    4 In the Choose Install Folder dialog box, accept the default location or enter a file path to specify the location where you installed Integration Composer. You can click Choose to browse to the desired location.

  • Upgrading to Integration Composer Release 6.2.1

    Upgrading to Integration Composer Release 6.2.1 3-5

    5 After you specify an installation location, click Next. The update program displays the Update Software Settings dialog box, as shown in the following figure.

    Update Software Settings Dialog Box

    6 In the Update Software Settings dialog box, select one of the following options and click Next:

    ! No

    Select this option if you do not want to change the previous software settings. If you select this option the update program displays the Installing IBM Maximo Integration Composer dialog box as it installs the modification. Go to step 14 on page 3-10.

    ! Yes

    Select this option to change the previous Integration Composer settings, for example database type. The update program displays the Database Type dialog box, as shown in the following figure.

  • Upgrading to Integration Composer Release 6.2.1

    3-6 IBM Maximo Integration Composer: Installation Guide

    Database Type Dialog Box

    7 In the Database Type dialog box, select the type of database you will use with the Integration Composer and click Next.

    The update program displays the Database Login Information dialog box.

    Database Login Information Dialog Box

    The fields displayed in this dialog box vary depending on the type of database you use.

    ! For a description of the fields for an Oracle database, see Oracle Database on page 2-6.

  • Upgrading to Integration Composer Release 6.2.1

    Upgrading to Integration Composer Release 6.2.1 3-7

    ! For a description of the fields for an SQL Server database, see SQL Server Database on page 2-6.

    ! For a description of the fields for a DB2 database, see DB2 Database on page 2-7.

    NOTE Make note of the values entered here. When you launch Integration Composer, you use the values entered in these fields to define connection parameters for the target Maximo data source.

    8 In the Database Login Information dialog box, enter login specifications for the database and click Next. The update program displays the Update Software Instances dialog box.

    Update Software Instances Dialog Box

    9 In the Update Software Instances dialog box, select one of the following options and click Next:

    ! Yes, disable software updates

    If you select this option, when the Integration Composer imports data into Maximo, it inserts or deletes software records, but it does not update software records. This is the preferred option.

    ! No, dont disable software updates

    If you select this option, when the Integration Composer imports data into Maximo, it updates existing software records.

    After you click Next, the update program displays the Choose Internet Browser File dialog box, as shown in the following figure.

  • Upgrading to Integration Composer Release 6.2.1

    3-8 IBM Maximo Integration Composer: Installation Guide

    Choose Internet Browser File Dialog Box

    10 In the Choose Internet Browser File dialog box, accept the default or enter another Internet browser file. You can click Choose to browse to the desired location.

    11 After you specify a browser file, click Next. The update program displays the Pre-Installation Summary dialog box, as shown in the following figure.

    Pre-Installation Summary Dialog Box

    12 In the Pre-Installation Summary dialog box, review the installation details and click Install. The update program displays the Installing IBM

  • Upgrading to Integration Composer Release 6.2.1

    Upgrading to Integration Composer Release 6.2.1 3-9

    Maximo Integration Composer dialog box, as shown in the following figure.

    Installing IBM Maximo Integration Composer Dialog Box

    NOTE If necessary, you can click Cancel to cancel the installation.

    As the update program installs Integration Composer 6.2.1, it displays the Overwrite Existing File dialog box, which gives you the option to overwrite the existing Integration Composer properties file (fusion.properties).

    Overwrite Existing File Dialog Box

    The following buttons are available on this dialog box:

    Button Description

    No Select this button if you do not want the update program to overwrite the existing fusion.properties file.

    No to All (Does not apply. Used when overwriting multiple files.)

    Yes to All (Does not apply. Used when overwriting multiple files.)

    Yes Select this button if you do want the update program to overwrite the existing fusion.properties file.

  • Upgrading to Integration Composer Release 6.2.1

    3-10 IBM Maximo Integration Composer: Installation Guide

    13 In the Overwrite Existing Files dialog box, select one of the following options:

    ! No, if you do not want the update program to overwrite the existing fusion.properties file.

    ! Yes, if you want the update program to overwrite the existing fusion.properties file.

    The update program closes the Overwrite Existing Files dialog box and completes the update.

    When the update is complete, the update program displays the Installation Complete dialog box, as shown in the following figure.

    Installation Complete Dialog Box

    14 In the Installation Complete dialog box, click Done. The update program closes the dialog box. The update is complete.

  • Verifying Installation

    Upgrading to Integration Composer Release 6.2.1 3-11

    Verifying Installation

    To verify that Integration Composer 6.2.1 is installed correctly, complete the following steps:

    1 Sign in to the Integration Composer application.

    2 From the Help menu in the IBM Maximo Integration Composer main window, select About IBM Maximo Integration Composer.

    The Integration Composer displays the About IBM Maximo Integration Composer window.

    3 Verify that the number in the Version field is 6.2.1. If the Integration Composer displays this number, Integration Composer 6.2.1 was successfully installed.

  • Verifying Installation

    3-12 IBM Maximo Integration Composer: Installation Guide

  • © Copyright IBM Corp. 2007 4-1

    This chapter provides instructions for removing the Integration Composer application.

    NOTE When the uninstall utility removes Integration Composer, one or more files might remain in the Integration Composer installation directory. You can delete these files.

    Uninstalling IBM Maximo Integration Composer

    When you install IBM Maximo Integration Composer, the installer also installs a utility to remove the Integration Composer application. For release 6.2 and later, this utility is stored in the Uninstall_Integration_Composer folder in the Integration Composer installation directory. If you use an earlier release of Integration Composer, the utility is stored in the Uninstall_Maximo Fusion Release 6.0 directory.

    To uninstall the Integration Composer, complete the following steps:

    1 From the directory where the Integration Composer is installed, type the appropriate command:

    ! For installations prior to release 6.2: cd Uninstall_Maximo_Fusion

    ! For release 6.2 installations: cd Uninstall_Integration_Composer

    2 Select one of the following options:

    ! If you installed the Integration Composer using the X Window application, type the appropriate command:

    ! For installations prior to release 6.2: sh ./Uninstall_Maximo_Fusion

    ! For release 6.2 installations: sh ./Uninstall_Integration_Composer

    ! If you installed the Integration Composer using console mode, type the appropriate command:

    ! For installations prior to release 6.2:

    sh ./Uninstall_Maximo_Fusion -i console

    ! For release 6.2 installations:

    sh ./Uninstall_Integration_Composer -i console

    Uninstalling IBM Maximo Integration Composer 4

  • Uninstalling IBM Maximo Integration Composer

    4-2 IBM Maximo Integration Composer: Installation Guide

    In console mode, you are prompted to enter information line by line. The information you enter and the sequence in which you enter it are similar to the process described in the following instructions, which describe the installation using the X Window application.

    3 Press Enter. The uninstall utility displays the Uninstall IBM Maximo Integration Composer dialog box, as shown in the following figure.

    Uninstall IBM Maximo Integration Composer

  • Uninstalling IBM Maximo Integration Composer

    Uninstalling IBM Maximo Integration Composer 4-3

    4 To remove Integration Composer, click Uninstall. The uninstall utility displays the Uninstall IBM Maximo Integration Composer progress dialog box as it removes the application.

    Uninstall IBM Maximo Integration Composer Progress Dialog Box

    If necessary, you can click Cancel to end the process.

  • Uninstalling IBM Maximo Integration Composer

    4-4 IBM Maximo Integration Composer: Installation Guide

    5 When the removal of the Integration Composer is complete, the uninstaller displays the Uninstall Complete dialog box, as shown in the following figure.

    Uninstall Complete Dialog Box

    6 Click Done. Removal of IBM Maximo Integration Composer is finished.

    NOTE When the utility removes Integration Composer, one or more files might remain in the Integration Composer installation directory. You can delete these files.

  • © Copyright IBM Corp. 2007 Notices-1

    Notices

    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:

    IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.

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

    IBM World Trade Asia CorporationLicensing2-31 Roppongi 3-chome, Minato-kuTokyo 106-0032, Japan

    The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:

    INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 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

  • Notices-2 IBM Maximo Integration Composer: Installation Guide

    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:

    IBM Corporation2Z4A/10111400 Burnet RoadAustin, TX 78758 U.S.A.

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

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

    If you are viewing this information softcopy, the photographs and color illustrations may not appear.

    Trademarks

    AIX, IBM, IBM Corporation, the IBM logo, Tivoli, and WebSphere are registered trademarks of the International Business Machines Corporation in the United States, other countries, or both.

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

    Microsoft, Windows, and Internet Explorer are registered trademarks of Microsoft Corporation in the United States, other countries, or both.

  • Notices-3

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

    Sun, Sun Microsystems, the Sun logo, and Solaris are trademarks of Sun Microsystems, Inc.

    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, and service names may be trademarks or service marks of others.

  • Notices-4 IBM Maximo Integration Composer: Installation Guide

    IBM Maximo Integration Composer Installation Guide for UNIXContentsAbout This GuideAudienceRelated DocumentationSupport

    Chapter 1: IBM Maximo Integration Composer OverviewIntegration Composer Hardware/Software RequirementsIntegration Composer Components

    Chapter 2: Installing IBM Maximo Integration Composer Release 6.2.1Installation PrerequisitesInstallation ChecklistInstalling IBM Maximo Integration Composer 6.2.1

    Chapter 3: Upgrading to Integration Composer Release 6.2.1Updates Included in Release 6.2.1Upgrade PrerequisitesUpgrade ChecklistUpgrading to Integration Composer Release 6.2.1Verifying Installation

    Chapter 4: Uninstalling IBM Maximo Integration ComposerUninstalling IBM Maximo Integration Composer

    Notices