IBM Maximo Mobile Applications

Release 6.4

Installation Guide

GC23-8718-00

Note Before using this information and the product it supports, read the information in “Notices” on page Notices-1.

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

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.

Contents

About This Publication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v Related Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v IBM Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v Chapter 1: Installing Maximo Mobile Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 Installation Checklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Device Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Stopping the Maximo Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Creating File and Database Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 Installing Maximo Mobile Applications to your Maximo Environment . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Installing the Product Enablers for Maximo Mobile Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Refreshing the Maximo Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6 Chapter 2: Packaging Maximo Mobile Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 Maximo Mobile Applications Installation Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 Packaging Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Configuring the mobiletools.properties File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2 Running the importall.cmd Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Configuring the mobiledeployment.properties File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 Configuring the mobile.properties File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 Running the packagemobile.cmd Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7 Connecting the Maximo Application Server to a Mobile Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7 Copying the Contents of the devicesetup Folder to the Mobile Device . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10 Configuring Bar Coding for an Intermec Mobile Device (Optional) . . . . . . . . . . . . . . . . . . . . . . . . . 2-10 Modifying Shortcuts for Intermec Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11 Modifying the mobile.properties for Intermec Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12 Configuring Bar Coding for a Motorola (Symbol) Mobile Device (Optional) . . . . . . . . . . . . . . . . . . 2-12 Modifying Shortcuts for Motorola (Symbol) Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13 Copying CDC Application Bundles to the Mobile Device. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14 Copying 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:. 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.

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

© Copyright IBM Corp. 2007

v

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

Installing Maximo Mobile Applications

1

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

© Copyright IBM Corp. 2007

[

]

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 –

[

]

6 Installing the Product Enablers for IBM Maximo Mobile Applications –

[

]

7 Refreshing the Maximo database – See page 1-6

See page 1-3. See page 1-4.

1-1

System Requirements

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 folder and your database.

1-2

IBM Maximo Mobile Applications: Installation Guide

Installing Maximo Mobile Applications to your Maximo 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 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 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

1-3

Installing the Product Enablers for Maximo Mobile Applications

6 Click Install. The installation program displays the message “Installing... MOBILE” while it copies files and folders to , 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.

1-4

IBM Maximo Mobile Applications: Installation Guide

Installing the Product Enablers for Maximo Mobile Applications

2 Using Windows Explorer, double-click setup.exe in the root of your CDROM 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 redeploy 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 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. Complete the following steps:

1 Open a command prompt, and navigate to \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 \tools\maximo\log for more information.

6 Start the Maximo application server.

1-6

IBM Maximo Mobile Applications: Installation Guide

Packaging Maximo Mobile Applications

2

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: ! !

© Copyright IBM Corp. 2007

Import mobile applications metadata to the Maximo database Package mobile application bundles 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

[

]

7 Copying the Contents of the Devicesetup Folder to the Mobile Device – See

page 2-7.

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. Complete the following steps:

1 Open Windows Explorer and navigate to \mobiletools\maximo.

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

IBM Maximo Mobile Applications: Installation Guide

Running the importall.cmd Process

3 Enter the following configuration values: 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”.

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. Complete the following steps:

1 Start or check that the Maximo application server is running. 2 Open a command prompt and navigate to \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.

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. Complete the following steps:

1 Open Windows Explorer and navigate to \mobiledeployment.

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

3 Enter the following configuration values: 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”.

4 Choose File > Save. 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. Complete the following steps:

1 Open Windows Explorer and navigate to \mobiledeployment.

2-4

IBM Maximo Mobile Applications: Installation Guide

Configuring the mobile.properties File

2 Right-click mobile.properties and open the file with a text editor. 3 Enter the following configuration values: 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.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. To enable a setting, uncomment the line by removing the // prefix.

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) ! !

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

Packaging Maximo Mobile Applications

2-5

Configuring the mobile.properties File Properties Setting

Value

maximo.mobile.mobilewo.multipleti mers

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

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

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.

4 Choose File > Save. 5 Close the file.

2-6

IBM Maximo Mobile Applications: Installation Guide

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 \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. Complete the following steps:

1 Open a command prompt and navigate to \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

\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. Complete the following steps:

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

Packaging Maximo Mobile Applications

2-7

Connecting the Maximo Application Server to a Mobile Device 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.

2-8

IBM Maximo Mobile Applications: Installation Guide

Connecting the Maximo Application Server to a Mobile Device 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.

Packaging Maximo Mobile Applications

2-9

Copying the Contents of the devicesetup Folder to the Mobile Device

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

\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

\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: 2-10

IBM Maximo Mobile Applications: Installation Guide

Copying the Contents of the devicesetup Folder to the Mobile Device 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:

Packaging Maximo Mobile Applications

2-11

Copying the Contents of the devicesetup Folder to the Mobile Device ;\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=INTERMEC maximo.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: 2-12

IBM Maximo Mobile Applications: Installation Guide

Copying the Contents of the devicesetup Folder to the Mobile Device 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).

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

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.

Packaging Maximo Mobile Applications

2-13

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. Complete the following steps:

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

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

NOTE

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

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.

2-14

IBM Maximo Mobile Applications: Installation Guide

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

Copying CDC Application Bundles to the Laptop or Tablet Before you copy application bundles to the laptop or tablet, copy the files from the \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)

Packaging Maximo Mobile Applications

2-15

Copying CDC Application Bundles to the 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 \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.

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

2-16

IBM Maximo Mobile Applications: Installation 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 Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.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 Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 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 Corporation 2Z4A/101 11400 Burnet Road Austin, 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 file mobile.properties 2-1 mobiledeployment.properties 2-1 mobiletools.properties 2-1 configuring bar coding for a Symbol device 2-12 bar coding for an Intermec device 2-10 mobile.properties 2-4 mobiledeployment.properties 2-4 mobiletools.properties 2-2 connecting mobile device to application server 2-2, 2-4, 2-7 packagemobile process to application server 2-4 copying application bundles to the mobile device 2-14 device folders to the mobile device 2-10, 2-15 mobile objects to application server database 2-3 creating mobile application bundles on an application server 2-7 customer support v

I importall.cmd running 2-3 Intermec device 2-10

software requirements 1-2 mobile device files 2-10, 2-15 mobile installation installing license keys 1-4 running maximomobile.exe 1-3 mobile process packagemobile.cmd 2-1 mobile.properties 2-1 configuring 2-4 mobiledeployment.properties 2-1 configuring 2-4 mobiletools.properties 2-1 configuring 2-2

O online support v overview 2-1

P packagemobile.cmd 2-1 running 2-7

R L license keys installing for mobile applications 1-4

M maximo database refreshing with updatedb.bat 1-6 maximomobile.exe 1-3 Microsoft ActiveSync 2-7 mobile application bundles 2-14 mobile application components mobile applications 2-1 mobile applications packaging overview 2-1 mobile device © Copyright IBM Corp. 2007

running importall.cmd 2-3 Microsoft ActiveSync 2-7 packagemobile.cmd 2-7

S software requirements for mobile device 1-2 support, online v Symbol device 2-12

Index-1

Index

U updatedb.bat 1-6

Index-2

IBM Maximo Mobile Applications: Installation Guide