IBM Maximo Mobile Applicationspublib.boulder.ibm.com/.../en_US/PDF/64_mx_mobile_install.pdf · and...

GC23-8718-00

Release 6.4

Installation Guide

IBM Maximo Mobile Applications

This edition applies to version 6, release 4 of IBM Maximo Mobile Applications 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.

Sentry Spelling-Checker Engine © 2000 Wintertree Software, Inc.

Maximo Discovery MSDE Copyright © Microsoft® Corporation.

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

Contents

About This Publication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vIntended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vRelated Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vIBM Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Chapter 1: Installing Maximo Mobile Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1Installation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2Device Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2Stopping the Maximo Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2Creating File and Database Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2Installing Maximo Mobile Applications to your Maximo Environment . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3Installing the Product Enablers for Maximo Mobile Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4Refreshing the Maximo Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6

Chapter 2: Packaging Maximo Mobile Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1Maximo Mobile Applications Installation Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1Packaging Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2Configuring the mobiletools.properties File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2Running the importall.cmd Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3Configuring the mobiledeployment.properties File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4Configuring the mobile.properties File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4Running the packagemobile.cmd Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7Connecting the Maximo Application Server to a Mobile Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7Copying the Contents of the devicesetup Folder to the Mobile Device . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10

Configuring Bar Coding for an Intermec Mobile Device (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . 2-10Modifying Shortcuts for Intermec Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11Modifying the mobile.properties for Intermec Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12

Configuring Bar Coding for a Motorola (Symbol) Mobile Device (Optional) . . . . . . . . . . . . . . . . . . 2-12Modifying Shortcuts for Motorola (Symbol) Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13

Copying CDC Application Bundles to the Mobile Device. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14Copying CDC Application Bundles to the Laptop or Tablet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15

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

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Index-1

© Copyright IBM Corp. 2007 iii

iv IBM Maximo Mobile Applications: Installation Guide

About This Publication

This section explains how this guide can help you to use IBM® Maximo®

Mobile applications. It also provides information about other IBM Corporation resources available to you, such as additional documentation and support.

Intended Audience

This guide is for users of IBM Maximo Mobile applications running on mobile devices.

Related Information

For more information about the IBM Maximo Mobile applications, refer to the following documentation:.

IBM Support

IBM Software Support provides assistance with product defects.

Before contacting IBM Software Support, your company must have an active IBM software maintenance contract, and you must be authorized to submit problems to IBM. For information about the types of maintenance contracts available, see "Enhanced Support," in the Software Support Handbook at techsupport.services.ibm.com/guides/services.html.

Complete the following steps to contact IBM Software Support with a problem:

1 Define the problem, gather background information, and determine the severity of the problem. For help, see the "Contacting IBM," in the

Document Description

IBM Maximo Mobile Inventory Manager User�s Guide

Describes the Mobile Inventory Manager application.

IBM Maximo Mobile Work Manager User�s Guide

Describes the Mobile Work Manager application.

IBM Maximo Mobile Applications Configuration Guide

Provides information on how you can configure a mobile application, including adding/removing fields, changing labels, and cloning.

© Copyright IBM Corp. 2007 v

http://support.mro.com

IBM Support

Software Support Handbook at techsupport.services.ibm.com/guides/beforecontacting.html.

2 Gather diagnostic information.

3 Submit your problem to IBM Software Support in one of the following ways:

a Online: Click Submit and track problems on the IBM Software Support site at www.ibm.com/software/support/probsub.html.

b By telephone: For the telephone number to call in your country, go to the Contacts page of the IBM Software Support Handbook at techsupport.services.ibm.com/guides/contacts.html.

If you submit a problem that is a software defect or for missing or inaccurate documentation, IBM Software Support creates an Authorized Program Analysis Report (APAR). The APAR describes the problem in detail.

Whenever possible, IBM Software Support provides a workaround that you can implement until the APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the Software Support Web site daily, so that other users who experience the same problem can benefit from the same resolution.

vi IBM Maximo Mobile Applications: Installation Guide

IBM Maximo Mobile Applications extends Maximo applications to remote workers. It uses familiar application installation and configuration processes that are consistent with the enterprise deployment of IBM Maximo. IBM Maximo Mobile Applications includes the following applications:

! Mobile Inventory Manager! Mobile Work Manager

These applications work in a connected or disconnected mode with mobile PDA (Personal Digital Assistant) devices. The supported mobile devices run on the Connected Device Configuration (CDC) platform.

The Maximo Mobile applications run on top of Maximo and were developed using J2ME TM (Java 2, Micro Edition). The screens that make up the applications use an XML structure identical to Maximo.

The IBM Maximo Mobile Applications installation CD has the following top-level content:

! Documentation folder � contains mobile documentation guides! Maximo Mobile applications executable (maximomobile.exe) � the mobile

install executable file

Installation Checklist

This checklist lists the installation topics in this chapter.

[ ] 1 Overview of Maximo Mobile Applications � See page 1-2

[ ] 2 Device Requirements � See page 1-2.

[ ] 3 Stopping the Maximo Application Server � See page 1-2.

[ ] 4 Creating File and Database Backups � See page 1-2.

[ ] 5 Installing Maximo Mobile Applications to Your Maximo Environment � See page 1-3.

[ ] 6 Installing the Product Enablers for IBM Maximo Mobile Applications � See page 1-4.

[ ] 7 Refreshing the Maximo database � See page 1-6

Installing Maximo Mobile Applications 1

© Copyright IBM Corp. 2007 1-1

System Requirements

You must have Maximo 6.2.1 or later to run IBM Maximo Mobile Applications, Release 4. For specific system requirements, see your IBM Maximo Installation Guide.

Device Requirements

Mobile devices require the following components:

! Minimum of 64MB of RAM! Processor running Microsoft® Windows® Mobile 5.0 ! File transfer software, such as Microsoft® ActiveSync®

Mobile laptop/tablet devices require the following component:

! Java Virtual Machine Runtime Environment Java 2 Platform Standard Edition (J2SETM), Version 1.4.x.

Memory Usage on Mobile Devices

If you have a 64MB device with memory storage and programs split 50/50, it might not be able to support IBM WebSphere Everyplace Micro Environment 6.x, the Java Virtual Machine (JVM). In this situation, ensure there is more than 64 MB of memory on the device.

General Communication Requirements

In order for the mobile devices to communicate with core Maximo, an environment that can support the HTTP protocol is required. For example, LAN TCP/IP, Wi-Fi, cellular, satellite communications, or anything else that can support the HTTP protocol.

Stopping the Maximo Application Server

Before beginning the installation process, ensure that all users exit Maximo, then stop all Maximo application servers and services and exit all other programs.

See the IBM Maximo Installation Guide for more information about how to start and stop the Maximo application server.

Creating File and Database Backups

Before you install the Maximo Mobile applications, create a backup of your <maximo_root> folder and your database.

System Requirements

1-2 IBM Maximo Mobile Applications: Installation Guide

ximo Environment

Installing Maximo Mobile Applications to your Maximo Environment

Running the Maximo Mobile applications executable creates mobile properties, command, and jar files in the following new directories:

! mobileapplications! mobiledeployment! mobiletools

Before beginning this procedure, check that you have completed your Maximo directory and database backups.

To install Maximo Mobile applications, complete the following steps:

1 Stop the Maximo application server.

2 Insert the IBM Maximo Mobile Applications Software CD into the CD-ROM drive.

3 Using Windows Explorer, double-click maximomobile.exe in the root of your CD-ROM drive.

The installation program opens with the Maximo Mobile Applications Introduction screen,

4 Click Next.

The Choose Install Folder screen opens with a suggested installation folder of C:\Maximo.

NOTE This guide also uses <maximo_root> to see the drive and folder location where you install Maximo. For example, if you install Maximo on the D: drive in folder Maximo, then <maximo_root> is equal to D:\Maximo.

5 Specify the install folder by accepting C:\Maximo or clicking Choose... to browse to a different one; then click Next.

! If you do not have the required patch level of Maximo, you receive an error message. Install the patch and run the Maximo Mobile Applications installation program again.

! If you have the previous version of Maximo Mobile Applications installed, you receive a message recommending that you back up the previous version. If you have already done this, click Next to continue.

The Pre-Installation Summary screen opens and shows you a summary of your installation choices, including where you want to install the product and the disk space required.

Installing Maximo Mobile Applications to your Ma

Installing Maximo Mobile Applications 1-3

6 Click Install.

The installation program displays the message �Installing... MOBILE� while it copies files and folders to <maximo_root>, which is C:\Maximo in this example.

When the file copying finishes, the Install Complete screen opens. You have completed the base installation of Maximo Mobile applications to your Maximo environment.

7 From the Install Complete screen, click Next.

The Update IBM Maximo Mobile screen opens.

NOTE Your server must be connected to the Internet to continue with these steps.

8 Select the Check for Updates to IBM Maximo Mobile check box, then click Done.

The Welcome to PowerUpdate! screen opens.

9 Click Next to have PowerUpdate search for updates to Maximo Mobile Applications.

NOTE You can click Exit if you do not want to search for updates. You can check for updates at a later time by running update.exe, located in the PowerUpdateClientMobile folder.

10 If you clicked Next in the preceding step, the Checking for Update screen opens. PowerUpdate begins to look for updates.

! If updates are found, follow the onscreen instructions.

! If there are no updates, the update program displays a message: �Your Software is Already Up to Date.� Click Exit.

Installing the Product Enablers for Maximo Mobile Applications

Before you deploy the new maximo.ear file and perform other mobile configuration tasks, install the product enablers for each Maximo Mobile application you have purchased. The product enablers let you access to the mobile applications.

The following procedure is applicable for both the Mobile Inventory Manager and the Mobile Work Manager product enablers, which you install from separate CDs. If you use both applications, you must install the product enabler for each application.

Complete the following steps:

1 Insert the IBM Maximo Mobile for Work Manager (or Inventory Manager) Product Enabler CD into your CD-ROM drive.

Installing the Product Enablers for Maximo Mobile Applications


obile Applications

2 Using Windows Explorer, double-click setup.exe in the root of your CD-ROM drive.

3 From the drop-down list at the bottom of the first screen, select English and click OK. The Welcome screen opens.

4 Click Next.

The Choose Maximo Home Directory screen opens with a suggested installation folder of C:\Maximo.

5 Specify the installation folder by accepting C:\Maximo or clicking Choose... to browse to a different one; then click Next.

The Pre-Configuration Message screen opens.

6 Click Install.

An installation progress bar screen opens. When the installation is complete, the Get Additional Package Information screen opens.

7 Perform one of the following steps:

! If you have additional product enablers to install, select Yes, then click Done. The Package Utility closes.

Repeat steps 1 through 6 to install another product enabler.

NOTE The full complement of Maximo Mobile applications includes two product enabler CDs, one for each application.

! If you have no additional product enablers to install, select No, then click Done. The Package Utility now builds a new maximo.ear file and a new maximohelp.ear file. A progress screen displays progress.

After the new .ear files are built the Package Utility displays an Install Complete screen.

8 Click Done to close the utility.

Deploy the updated maximo.ear and maximohelp.ear files to your application server to complete the installation process.

NOTE Delete the following entries from your console before you re-deploy the EAR files:

! maximo! maximohelp

See �Deploying the EAR files� in the IBM Maximo Installation Guide for instructions on how to deploy .ear files from an administration console.

Installing the Product Enablers for Maximo M

Installing Maximo Mobile Applications 1-5

Refreshing the Maximo Database

Refreshing the Maximo Database

With the Maximo application server stopped, run updatedb.bat to refresh the database design with mobile application tables.


1 Open a command prompt, and navigate to <maximo_root>\tools\maximo.

2 Type updatedb.bat and press Enter. You will receive the following message: �Product Mobile has extensions but a_customer.xml file does not exist. Do you want to continue (Y/N)?�

3 Type Y and press Enter to continue.

4 The update is complete when you see a series of �Import complete: successful� messages.

5 Type exit and press Enter to close the command prompt window. If there are errors, refer to the log file in <maximo_root>\tools\maximo\log for more information.

6 Start the Maximo application server.


Maximo Mobile Applications Installation Components

The Maximo Mobile applications installation program creates mobile-specific command and configuration files in the directory where you installed Maximo, for example, C:\Maximo.

The following configuration file and command script are for mobile application tools and setup:

! mobiletools.properties � a properties file associated with the importall.cmd process. You configure the settings in this file to point to the IP address (or hostname) and port number of the Maximo application server.

! importall.cmd � a process that imports all mobile application metadata, such as data definitions and screen layouts defined in XML files, into the Maximo database. This process uses the mobiletools.properties file to connect to the Maximo application server.

The following configuration files and command script package mobile application bundles:

! mobiledeployment.properties � the settings in this file enable the packagemobile process to connect to the Maximo application server and create mobile application bundles.

! mobile.properties � the packagemobile process embeds this configuration file in each application bundle (.jar) created for a mobile device. The mobile application uses the connectivity settings in this file to connect to the Maximo application server. This file also contains application-specific settings.

! packagemobile.cmd � if you are packaging more than one mobile application at a time, use this process to package all mobile application bundles (.jar files) and connectivity information to a running Maximo application server. You manually copy the application bundles to the mobile device where they can be enabled and run. This process uses configuration information stored in mobile.properties.

Before you deploy mobile applications to a mobile device, perform the following tasks:

! Import mobile applications metadata to the Maximo database! Package mobile application bundles

Packaging Maximo Mobile Applications 2

© Copyright IBM Corp. 2007 2-1

Packaging Checklist

To import mobile metadata to the Maximo application server, you run the importall.cmd process. To create mobile application bundles, you run either the packagemobile.cmd or packagemobileapp.cmd process.

Before you run the command files, configure the following files:

! mobiletools.properties! mobiledeployment.properties! mobile.properties

Packaging Checklist

This checklist lists the topics in this chapter, which describe how to set up the mobile applications and then package the mobile application bundles.

[ ] 1 Configuring the mobiletools.properties File � See page 2-2.

[ ] 2 Running the importall.cmd Process � See page 2-3.

[ ] 3 Configuring the mobiledeployment.properties File � See page 2-4.

[ ] 4 Configuring the mobile.properties File � See page 2-4

[ ] 5 Running the packagemobile.cmd Process � See page 2-7.

[ ] 6 Connecting the Maximo Application Server to a Mobile Device� See page 2-7.

[ ] 7 Copying the Contents of the Devicesetup Folder to the Mobile Device � See page 2-10.

[ ] 8 Configuring Bar Coding for an Intermec Mobile Device (Optional) � See page 2-10.

[ ] 9 Configuring Bar Coding for a Motorola (Symbol) Mobile Device (Optional) � See page 2-12.

[ ] 10 Copying CDC Application Bundles to the Mobile Device � See page 2-14.

[ ] 11 Copying CDC Application Bundles to the Laptop or Tablet Device � See page 2-15

Configuring the mobiletools.properties File

You configure the settings in this file so that the importall.cmd process can connect to the Maximo application server.


1 Open Windows Explorer and navigate to <maximo_root>\mobiletools\maximo.

2 Right-click mobiletools.properties and open the file with a text editor.


Running the importall.cmd Process

3 Enter the following configuration values:

4 Choose File > Save.

5 Close the file.

Running the importall.cmd Process

After configuring the mobiletools.properties file, you run the importall process to import mobile application metadata, such as XML definitions, into the Maximo database. This process uses the mobiletools.properties file to connect to the Maximo application server.

Use the importall command if you have changed more than one Maximo mobile application. Run the importmetadata command if you have changed only one mobile application.


1 Start or check that the Maximo application server is running.

2 Open a command prompt and navigate to <maximo_root>\mobiletools\maximo.

3 Type importall.cmd and press Enter.

Upon completion of the import process, you see a �BUILD SUCCESSFUL� message.

NOTE If you installed only one product enabler, you might see errors in the command prompt window. You can ignore these errors as long as you see the �BUILD SUCCESSFUL� message.

4 Exit the command prompt window.

Properties Setting Value

maximo.mobile.hostname IP address or hostname of the Maximo application server

maximo.mobile.port Port number of the Maximo application server

maximo.mobile.ssl If you are using a Secure Socket Layer (SSL) environment, then set to �true.� Otherwise, leave �false.�

maximo.mobile.username Enter a user name, such as �maxadmin,� that has access and privileges to the Maximo database.

maximo.mobile.password Enter a password for the mobile �power� user entered above, such as �maxadmin�.

Packaging Maximo Mobile Applications 2-3

Configuring the mobiledeployment.properties File

5 Review the application server log files to check that no errors occurred during the import process.

Configuring the mobiledeployment.properties File

You configure the settings in this file so that the packagemobile process can connect to the Maximo application server.


1 Open Windows Explorer and navigate to <maximo_root>\mobiledeployment.

2 Right-click mobiledeployment.properties, and then open the file with a text editor.



5 Close the file.

Configuring the mobile.properties File

The packagemobile process embeds the mobile.properties file into each mobile application bundle (.jar file). This file also contains application-specific settings.


1 Open Windows Explorer and navigate to <maximo_root>\mobiledeployment.





maximo.mobile.username Enter a user name, such as �maxadmin,� that has access and privileges to the Maximo database.

maximo.mobile.password Enter a password for the mobile �power� user entered above, such as �maxadmin�.



2 Right-click mobile.properties and open the file with a text editor.






maximo.mobile.contextname Leave the default of �/maximomobile/mobileservices.� This setting points the mobile device to the mobile context location on the Maximo application server.

maximo.mobile.barcode If you use the mobile device for bar coding, enable one of the following values based on the mobile device manufacturer:

! SYMBOL! INTERMEC! CUSTOM (for devices not

supported out of the box and requiring customization, contact IBM Global Services)

To enable a setting, uncomment the line by removing the // prefix.

maximo.mobile.intermeclag If you use an Intermec mobile device for bar coding, enable this setting to handle the barcode read lag.


maximo.mobile.rfid If you use the mobile device for RFID (Radio Frequency Identification), enable one of the following values based on the mobile device manufacturer:

! SYMBOL! INTERMEC! CUSTOM (for devices not

supported out of the box and requiring customization, contact IBM Global Services)





5 Close the file.

maximo.mobile.mobilewo.multipletimers

If you are using the Mobile Work Manager application, you can set labor timers for multiple work orders running at the same time by uncommenting the �true - multiple timers can be running...� line item. Otherwise, uncomment the �false� timer line item if multiple labor timers cannot run simultaneously.

maximo.mobile.docextractfolder Used with the Mobile Work Manager application, this setting specifies the Attached Documents Extract folder. All extracted documents are put into this folder's subfolders. If this setting is commented out, it defaults to /maximoattachments.

NOTE: A folder name cannot contain any of the following characters: \ / : * ? " < > |

maximo.mobile.docdownloadsizelimitkb

Used with the Mobile Work Manager application, this setting specifies the Attached Documents download file size limit in KB (1KB = 1024 Bytes). If this setting is commented out, then the default is not to limit the size.

maximo.mobile.docdownloadexcludeext

Used with the Mobile Work Manager application, this setting specifies the types of Attached Documents you want to exclude from downloading (for example, you want to exclude CAD drawings). It is a comma-separated list of extensions (for example: png,doc,txt). If this setting is commented out, then the default is not to limit any extension.



Running the packagemobile.cmd Process

Running the packagemobile.cmd Process

Run the packagemobile process if you are packaging more than one mobile application at a time. The packagemobile process creates mobile application bundles on the Maximo application server. You copy these bundles to the mobile device. This process creates folders for mobile application packages in the <maximo_root>\mobiledeployment\default\en\cdc-applications folder.

NOTE The en folder is a language-specific folder for an English installation of Maximo. Your language code can vary.

You copy the bundled files, for example mobileinv.jar and mobilewo.jar, located in the application folders to the mobile device.


1 Open a command prompt and navigate to <maximo_root>\mobiledeployment.

2 Type packagemobile.cmd and press Enter.

Upon completion of the import process, you see a �BUILD SUCCESSFUL� message.

NOTE If you installed only one product enabler, you might see errors in the command prompt window. You can ignore these errors as long as you see the �BUILD SUCCESSFUL� message.

3 Exit the command prompt window.

4 Confirm that the application bundles exist in the <maximo_root>\mobiledeployment\default\en\cdc-applications folder. If they do not, check the application server log files.

Connecting the Maximo Application Server to a Mobile Device

You must establish a connection between your server and the mobile device so that you can copy over the mobile application bundles and complete the installation process. Check that you have physically connected the mobile device to your computer. Use file transfer software, such as Microsoft ActiveSync, to exchange data between the mobile device and server.


1 Choose Start > Programs > Microsoft ActiveSync to open the ActiveSync connection screen.



ActiveSync Connection Screen

Microsoft ActiveSync lest you to create a connection (partnership) between your mobile device and desktop computer via USB cable, Bluetooth, or infrared connection.

2 Choose File > Get Connected... to open the Get Connected screen and create a connection with the mobile device.

ActiveSync Get Connected Screen

The text on this screen reminds you to:

! Connect the mobile device cable to your computer! Turn on the mobile device! Place the device in its cradle

3 Click Next to open the New Partnership screen.



ActiveSync New Partner Screen

Choose one of the following options:

! Click Yes to set up a partnership with synchronization of data

! Click No to connect without synchronization but the ability to move files between the mobile device and your computer.

4 Click Next to display the connected confirmation screen.

ActiveSync Connection Confirmation Screen

5 Minimize the ActiveSync connection screen on your desktop.


Copying the Contents of the devicesetup Folder to the Mobile Device


Before you copy application bundles to the mobile device, copy the files from the <maximo_root>\mobiledeployment\devicesetup\J2ME folder. To do so, complete the following steps:

1 Copy the contents of the J2ME folder to the root of your mobile device.

2 If the ActiveSync connection screen is not already open, choose Start > Programs > Microsoft ActiveSync and get connected.

3 Using Microsoft Windows Explorer, open the <maximo_root>\mobiledeployment\devicesetup\J2ME folder.

Using ActiveSync, choose Tools > Explore Pocket PC to open the mobile device�s file structure on your desktop.

4 Copy the contents of the <maximo_root>\mobiledeployment\devicesetup\J2ME folder to the root of your mobile device.

When copying files, ActiveSync displays a warning that it might have to convert files when synchronizing data between the mobile device and server.

File Conversion Warning

Configuring Bar Coding for an Intermec Mobile Device (Optional)

To configure an Intermec mobile device for bar coding, complete the following steps:

1 Go to the Intermec Supply Chain Management Web site: http://www.intermec.com

2 Go to Support > Downloads and search for Tool Kit IDL 2.50

3 Download and install the Tool Kit to the default directory (C:\Program Files\Intermec).

4 Copy the file:



C:\Program Files\Intermec\Developer Library\Data Collection Resource Kit\Runtime\JavaDataCollection.cab�

to the root folder\ on your mobile device.

5 Copy the file:

C:\Program Files\Intermec\Developer Library\Data Collection Resource Kit\Runtime\WCEnnn\nnn\Armv4\DC_Net.CAB

to the root folder\ on your mobile device (where nnn is your Microsoft Mobile version).

6 Click the following files to run them on the device:

! JavaDataCollection.cab

! DC_Net.CAB

7 Copy the file:

C:\Program Files\Intermec\JavaLib\DataCollection.jar

to the maximo\lib folder on your mobile device.

8 Copy the file:

C:\Windows\itcscan.dll

to the \J9\PPRO11\bin folder on your mobile device.

9 Disable the device�s Virtual Wedge feature.

a Click Settings>Intermec Settings > Data Collection > Virtual Wedge > Check/UnCheck Virtual Wedge.

b Click File > SaveSettings.

c Click File > Exit.

10 Modify the contents of the shortcut. For more information, see "Modifying Shortcuts for Intermec Users."

11 Modify the contents of the mobile.properties. For more information, see "Modifying the mobile.properties for Intermec Users."

Modifying Shortcuts for Intermec Users

To modify shortcuts, complete the following steps:

1 Copy the shortcut from your mobile device to your desktop.

2 Using Notepad, open the shortcut.

3 Modify the contents of the shortcut by appending it with the following addition:



;\maximo\lib\DataCollection.jar

The following examples show the contents of the old shortcut and the new shortcut.

Example: Old shortcut

255#"\J9\PPRO11\bin\j9w.exe" "-classpath" "\maximo\lib\mobilewo.jar;-Xmx64m" "-jcl:ppro11" "-Dpbmic.lic=\maximo\lib\pbmic.lic" "-Dmobiledb=mobilewo" "com.mro.mobileapp.WOApp"

Example: New shortcut

255#"\J9\PPRO11\bin\j9.exe" "-classpath" "\maximo\lib\mobilewo.jar;-Xmx64m;\maximo\lib\DataCollection.jar" "-jcl:ppro11" "-Dpbmic.lic=\maximo\lib\pbmic.lic" "-Dmobiledb=mobilewo" "com.mro.mobileapp.WOApp"

4 Save the changes you made to the shortcut.

5 Send the modified shortcut back to your mobile device.

Modifying the mobile.properties for Intermec Users

To modify the mobile.properties file, complete the following steps.

1 Open the mobile.properties file

2 Insert the following setting in the Barcode Settings section:

maximo.mobile.intermeclag=15000

3 Click Save.

4 Rebuild your mobile jar files

Example: Intermec Barcode Settings in the mobile.properties File

// Barcode settings// possible values for maximo.mobile.barcode property are//SYMBOL - Enables barcoding for Symbol Devices//INTERMEC - Enables barcoding for Intermec Devices//CUSTOM - Enables customized barcoding for device not supported out of box//Please note that code changes are needed for this.maximo.mobile.barcode=INTERMECmaximo.mobile.intermeclag=15000

Configuring Bar Coding for a Motorola (Symbol) Mobile Device (Optional)

To configure a Motorola (Symbol) mobile device for bar coding, complete the following steps:

1 Go to the Motorola (Symbol) Support Central web site:



http://support.symbol.com

2 Click Software Downloads.

3 Click Mobile Computers.

4 Click Developer & SW Tools.

5 Click Symbol Mobility Developer Kit v1.3 for Java.

6 Download and install the Symbol Mobility Developer kit to the default directory (C:\Program Files\Symbol Mobility Developer Kit for Java\v1.3).


8 Choose Tools > Explore Pocket PC to open the mobile device�s file structure on your desktop.

9 Copy the file:

C:\Program Files\Symbol Mobility Developer Kit for Java\v1.3\bin\symbolclasses.jar

to the maximo\lib folder on your mobile device.

10 Copy the file:

C:\Program Files\Symbol Mobility Developer Kit for Java\v1.3\bin\symboljavaapi.dll

to the \J9\PPRO11\bin folder on your mobile device.

11 Modify the contents of the shortcut. For more details, see "Modifying Shortcuts for Motorola (Symbol) Users."

12 Shut down, and then restart your mobile device to enable bar coding.

Modifying Shortcuts for Motorola (Symbol) Users

To modify shortcuts, complete the following steps:

1 Copy the shortcut from your mobile device to your desktop.

2 Using Notepad, open the shortcut.

3 Modify the contents of the shortcut by appending it with the following addition:

;\maximo\lib\symbolclasses.jar

The following is an example of the contents of the old shortcut and an example of the new modified shortcut.


Copying CDC Application Bundles to the Mobile Device

Example: Old shortcut

255#"\J9\PPRO11\bin\j9w.exe" "-classpath" "\maximo\lib\mobilewo.jar;-Xmx64m" "-jcl:ppro11" "-Dpbmic.lic=\maximo\lib\pbmic.lic" "-Dmobiledb=mobilewo" "com.mro.mobileapp.WOApp"

Example: New shortcut

255#"\J9\PPRO11\bin\j9w.exe" "-classpath" "\maximo\lib\mobilewo.jar;-Xmx64m;\maximo\lib\symbolclasses.jar" "-jcl:ppro11" "-Dpbmic.lic=\maximo\lib\pbmic.lic" "-Dmobiledb=mobilewo" "com.mro.mobileapp.WOApp

4 Save the changes you made to the shortcut.

5 Send the modified shortcut back to your mobile device.

Copying CDC Application Bundles to the Mobile Device

To complete the mobile applications installation process, copy one or more of the mobile application .jar files, depending on what you purchased, to the maximo\lib folder on your mobile device.



2 Choose Tools > Explore Pocket PC to open the mobile device�s file structure on your desktop.

3 Click maximo > lib to open the lib folder.

4 Open Windows explorer and navigate to the \cdc-applications folder. The path is <maximo_root>\mobiledeployment\default\en\cdc-applications. The cdc-applications folder contains mobile application folders which hold .jar files. For example, the paths to the Mobile Inventory Manager and Mobile Work Manager files are:

! mobileinv\mobileinv.jar! mobilewo\mobilewo.jar


5 Depending on your installation, drag one or both of the .jar files into the \lib folder. ActiveSync displays a message that it is converting the .jar files into a mobile device format. When finished, the .jar files are converted into Executable Jar File types.

Your installation is now complete.


Copying CDC Application Bundles to the Laptop or Tablet

6 In Maximo, set up a query to determine which work records Maximo will send to your mobile device.

a On your Maximo application server, log into Maximo.

b Go to the Security Groups (Mobile) application.

c Create a new security group with IBM Maximo Mobile privileges, or modify an existing security group to have IBM Maximo Mobile privileges.

! On the Applications tab, click the Mobile subtab.

! In the Applications table window, click Mobile Work Management.

! Select the Read?, Insert?, and Save? check boxes.

! In the Options for Mobile Work Management table window, grant the appropriate privileges.

! Click Save Group.

For more information, see the Security Groups (Mobile) online help.

On the Mobile Data tab, create a query for the records you want to transfer to your mobile device. For more information, see the Security Groups (Mobile) online help.

7 Open the mobile device to the <maximo_root> folder. Click a shortcut link for the mobile application you want to open and log in.

See the following guides for information about using or configuring mobile applications:

! IBM Maximo Mobile Inventory Manager User�s Guide! IBM Maximo Mobile Work Manager User�s Guide! IBM Maximo Mobile Applications Configuration Guide


Before you copy application bundles to the laptop or tablet, copy the files from the <maximoroot>\mobiledeployment\J2SE folder. To do so, complete the following steps:

1 Copy the contents of the J2SE folder to the root of your laptop or tablet.

1 Open the following file in Notepad:

C:\setEnv.cmd

(where C is the root of your laptop or tablet)



2 Change the location of the JAVA_HOME to where the Java Virtual Machine Runtime Environment Java 2 Platform Standard Edition (J2SE), Version 1.4.x is installed. For example:

set JAVA_HOME=C:\Java\j2re1.4.2_07.

3 Save and close the file.

4 Open Windows explorer on the computer that contains your Maximo installation and navigate to the <maximo_root>\mobiledeployment\default\en\cdc-applications folder.


The cdc-applications folder contains mobile application folders that hold .jar files. For example, the paths to the Mobile Inventory Manager and Mobile Work Manager files are:

! mobileinv\mobileinv.jar

! mobilewo\mobilewo.jar

5 Depending on your installation, copy one or both of the .jar files into the IBM maximo mobile\lib folder on the laptop or tablet device.

Your installation is now complete.

6 Go to the maximo folder on the laptop or tablet and double-click the command file for the mobile application you want to open and log in.

See the following guides for information about using or configuring mobile applications:

! IBM Maximo Mobile Inventory Manager User�s Guide! IBM Maximo Mobile Work Manager User�s Guide! IBM Maximo Mobile Applications Configuration Guide


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

© Copyright IBM Corp. 2007 Notices-1

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-2 IBM Maximo Mobile Applications: Installation Guide

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

Notices-4 IBM Maximo Mobile Applications: Installation Guide

Index

C

configuration filemobile.properties 2-1mobiledeployment.properties 2-1mobiletools.properties 2-1

configuringbar coding for a Symbol device 2-12bar coding for an Intermec device 2-10mobile.properties 2-4mobiledeployment.properties 2-4mobiletools.properties 2-2

connectingmobile device to application server 2-2, 2-4, 2-7packagemobile process to application server 2-4

copyingapplication bundles to the mobile device 2-14device folders to the mobile device 2-10, 2-15mobile objects to application server database 2-3

creatingmobile application bundles on an application server 2-7

customer support v

I

importall.cmdrunning 2-3

Intermec device 2-10

L

license keysinstalling for mobile applications 1-4

M

maximo databaserefreshing with updatedb.bat 1-6

maximomobile.exe 1-3Microsoft ActiveSync 2-7mobile application bundles 2-14mobile application components

mobile applications 2-1mobile applications

packaging overview 2-1mobile device

software requirements 1-2mobile device files 2-10, 2-15mobile installation

installing license keys 1-4running maximomobile.exe 1-3

mobile processpackagemobile.cmd 2-1

mobile.properties 2-1configuring 2-4

mobiledeployment.properties 2-1configuring 2-4

mobiletools.properties 2-1configuring 2-2

O

online support voverview 2-1

P

packagemobile.cmd 2-1running 2-7

R

runningimportall.cmd 2-3Microsoft ActiveSync 2-7packagemobile.cmd 2-7

S

software requirementsfor mobile device 1-2

support, online vSymbol device 2-12

© Copyright IBM Corp. 2007 Index-1

Index

U

updatedb.bat 1-6

Index-2 IBM Maximo Mobile Applications: Installation Guide

IBM Maximo Mobile Applicationspublib.boulder.ibm.com/.../en_US/PDF/64_mx_mobile_install.pdf · and...

Documents

Transcript of IBM Maximo Mobile Applicationspublib.boulder.ibm.com/.../en_US/PDF/64_mx_mobile_install.pdf · and...