Professional Documents
Culture Documents
Version 7.1.1
Note
Before using this information and the product it supports, read the information in Notices on page 29.
This edition applies to version 7, release 1, modification 1 of IBM Maximo Mobile Suite and to all subsequent
releases and modifications until otherwise indicated in new editions.
Copyright International Business Machines Corporation 2007, 2009.
US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Chapter 1. Overview of the installation
and configuration processes . . . . . . 1
Mobile device requirements .
. 1
.
.
.
.
.
.
.
.
.
.
.
.
11
11
11
13
13
13
. 15
. 16
. 17
.
.
.
.
.
17
17
18
18
18
. 19
. 19
. 20
. 20
. 23
.
.
.
.
23
23
24
24
. 25
. 25
. 26
. 27
28
Notices . . . . . . . . . . . . . . 29
Trademarks .
. 30
Index . . . . . . . . . . . . . . . 33
iii
iv
Procedure
1. Ensure that you are running the required version of IBM Maximo Asset
Management.
a. In a command prompt, navigate to the maximo_root\applications\maximo
directory.
b. Enter version.bat to view the product, configuration, and fix pack levels.
2. Create a backup of your maximo_root folder and database.
3. Install any updates to the Maximo database.
a. On the application server, go to the Database Configuration application.
b. If required updates are listed, select the Apply Configuration Changes
from the Select Action menu.
4. Stop the application server.
Procedure
1. Open the installation launchpad by double-clicking the launchpad.exe file,
which is on the product DVD.
2. From the launchpad, select Install the Product.
3. Select the name of the application that you are installing.
4. Complete the installation wizard, and then click Done.
5. In the Middleware Login Information window, click the WebSphere Admin tab
and enter the password for the WebSphere Application Server manager.
6. Click the WebSphere Remote tab and enter the password for the Remote
Administrator user.
7. Complete the wizard, and then click Done.
Procedure
1. In the Security Groups (Mobile) application on the application server, enter the
name of the security group that is responsible for installation.
2. On the Applications tab, click the Mobile tab, then select the access rights for
the application to which you are granting the security group access rights. The
Mobile Installer application must be granted read access rights for the
installation process to be successful.
3. Save the updated profile. Log out for the changes to take effect.
Procedure
1. In the maximo_root\applications\maximo\mobileweb\webmodule\WEB-INF
directory, open the web.xml file.
2. Set the useAppServerSecurity attribute to true.
3. Delete the opening <!- - and closing - - > tags to uncomment the lines after the
<login-config> and <security-constraint> tags.
4. Rebuild the .ear file and deploy it to the application server.
5. Synchronize the users and groups from LDAP into the system by setting the
VMMSYNC (for a WebSphere application server) or LDAPSYNC (for a
WebLogic application server) cron task to active.
10
Procedure
1. In the maximo_root\mobiletools\profiles\common\appsetup folder, right-click
the mobile.properties file and open it with a text editor.
2. Enter the property values for Maximo Mobile Suite.
3. Save your configuration.
Procedure
1. On the application server, navigate to the maximo_root\mobiletools folder.
2. Right-click the mobiletools.properties file and open it with a text editor.
3. Configure the properties for the host name, port, SLL, user name and
password.
4. Save the file.
Value to be entered
maximo.mobile.hostname
maximo.mobile.port
maximo.mobile.ssl
11
Property
Value to be entered
maximo.mobile.username
maximo.mobile.password
maximo.mobile.contextname
maximo.mobile.barcode
maximo.mobile.rfid
12
maximo.mobile.datafetchsize
maximo.mobile.snapshot
maximo.mobile.snapshot.chunksizekb
Property
Value to be entered
maximo.mobile.refreshdata.numberrec
Procedure
1. Start the application server.
2. In a command prompt, navigate to the maximo_root\mobiletools\maximo folder.
3. Enter importall.cmd.
Procedure
1. In a command prompt, navigate to the maximo_root\mobiletools\maximo folder.
2. Enter translatemobile.cmd.
3. Restart the application server.
Procedure
1. In a command prompt, navigate to the maximo_root\mobiletools\maximo folder.
2. Enter packagemobile.cmd and wait for the Build Successful message.
3. Exit the command window and close the application server for your changes to
take effect.
13
14
Procedure
1. On the application server, navigate to the maximo_root\mobiletools\maximo
folder. Select the installation file for your device, depending on whether you
are using Windows Mobile version 5 or 6, and whether your mobile device has
an Xscale or ArmV4T processor.
2. Connect the mobile device to Microsoft ActiveSync. On the application server,
select the CEAppMgr.cmd file. Wait for the files to be automatically copied onto
the device.
3. On the mobile device, select Device as the location for the installation files, and
click Install.
4. Click OK.
5. Select a profile to download and install the profile.
6. Close the application for the changes to take effect.
15
Procedure
From the source_root\mobiletools\devicesetup\DESKTOP directory, copy the
IBM_maximo_Mobile folder onto the personal computer for mobile workers.
2. Right-click the setEnv.cmd file, and open it with a text editor.
3. Edit the JAVA_HOME environment variable by inserting the path to the folder
where the JRE folder is installed on the personal computer. Save the text editor
file.
1.
16
Procedure
1. From the Mobile Data Manager application, specify the group for whom record
duplication is prevented.
2. Select Select Action Asset Manager Options.
3. Specify the attribute that uniquely defines the asset. For example, the
SERIALNUM attribute uses the serial number of an asset to validate the
uniqueness of the record.
4. Save the record.
Procedure
1. From the Mobile Data Manager application, specify the group for which you
want to allow independent status changes.
2. Select Select Action Mobile Work Manager Options Status Changes.
3. Specify for which work orders or tickets a mobile worker can send an
independent status change to the application server.
4. Click OK.
Procedure
1. In the Domains application, open the LOCASSETSTATUS domain.
2. Create a new synonym domain with the following values:
Internal Value
Value
Description
OPERATING
MISSING
Asset missing
17
3. Click OK.
Procedure
1. In the Cron Task Setup application, retrieve the MOBILETXN cron task and
click the Polling Frequency tab.
2. In the Instances field, enter the number of polling instances to run at the same
time. The default value is 1 polling instance per polling period.
3. Specify the number of minutes between each polling instance. The default
value is 1 minute.
Example
A polling instance value of 5 with a polling period value of 2 means that five
transactions are processed every 2 minutes.
Procedure
1. In the Cron Task Setup application, retrieve the MOBILEDEVCLEANUP cron
task.
2. In the NOOFDAYS parameter, enter the number of days after which
transactions are removed from mobile devices. The default value is 10 days.
3. Save the cron task.
Procedure
1. Navigate to the maximo_root\mobiletools\profiles\pda folder.
2. In the Profiles folder, copy the pda folder and rename it Intermec, Symbol, or
Custom if you are not using Intermec or Motorola Symbol mobile devices.
18
3. In the new profile folder, edit the profile.properties file by changing the
maximo.mobile.profile.name=PDA attribute to the name given to the new
profile. For example, maximo.mobile.profile.name=SYMBOL.
4. In the common\appsetup folder, copy the mobile.properties file to the
new_profile\appsetup folder.
5. In the mobile.properties file, delete // to enable the required Intermec or
Motorola Symbol bar code driver.
Procedure
1. Go to the Intermec Supply Chain Management Web site at www.intermec.com.
2. Download the IDL Resource Kit - Data Collection and install it in your
C:\Program Files directory.
3. Open Microsoft ActiveSync and navigate to the Tools\Explore Pocket PC
folder.
4. Copy the files in the following table to the specified locations.
Source location
Name of file
Target location
C:\Program
Files\Intermec\Developer
Library\Data Collection
Resource
Kit\Runtime\WCE420\
PocketPC 2003\processor
type: Armv4 or xScale\
JavaDataCollection.cab
maximo_root\mobiletools\
profiles\Intermec profile
folder\devicesetup
C:\Program
Files\Intermec\Developer
Library\JAVALib\
DataCollection.jar
maximo_root\mobiletools\
profiles\Intermec profile
folder\devicesetup\Maximo\
lib
C:\Windows
itcscan.dll
maximo_root\mobiletools\
profiles\Intermec profile
folder\\devicesetup\J9\
PPRO11\bin
19
Procedure
1. Navigate to the maximo_root\mobiletools\profiles\pda\devicesetup\Maximo\
lib directory.
2. Right-click the properties file for each application to open it with a text editor.
3. At the end of the text file, enter \maximo\lib\DataCollection.jar. Before you
update the properties file, it contains the following data:
# App parameters
jvm.parameters="-Xjit:count=0" "-jcl:ppro11" "-classpath" "\maximo\lib\
db2ejdbc.jar;\maximo\lib\mobilepreboot.jar;"
After you edit the properties file, it contains the following data:
# App parameters
jvm.parameters="-Xjit:count=0" "-jcl:ppro11" "-classpath" "\maximo\lib\
db2ejdbc.jar;\maximo\lib\mobilepreboot.jar;maximo\lib\DataCollection.jar"
Procedure
1. Go to the Motorola Symbol Support Central Web site at support.symbol.com.
2. Search for the Symbol Mobility Developer Kit for Java and download the latest
version that is compatible with your device.
3. Install the developer kit in your C:\Program Files\Symbol Mobility Developer
Kit for Java\ directory.
4. Open Microsoft ActiveSync and navigate to the Tools\Explore Pocket PC
folder.
5. Copy the files in the following table to the specified locations.
Source location
Name of file
Target location
C:\Program Files\Symbol
Mobility Developer Kit for
Java\v1.3\bin\
symbolclasses.jar
maximo_root\mobiletools\
profiles\Symbol profile
folder\devicesetup\Maximo\
lib
C:\Program Files\Symbol
Mobility Developer Kit for
Java\v1.3\bin\
symboljavaapi.dll
maximo_root\mobiletools\
profiles\Symbol profile
folder\devicesetup\Windows
20
Procedure
1. Navigate to the maximo_root\mobiletools\profiles\pda\devicesetup\Maximo\
lib directory.
2. Right-click the properties file for the application to open it with a text editor.
3. At the end of the text file, enter \maximo\lib\symbolclasses.jar. Before you
edit the properties file, it contains the following data:
# App parameters
jvm.parameters="-Xjit:count=0" "-jcl:ppro11" "-classpath" "\maximo\lib\
db2ejdbc.jar;\maximo\lib\mobilepreboot.jar;"
After you edit the properties file, it contains the following data:
# App parameters
jvm.parameters="-Xjit:count=0" "-jcl:ppro11" "-classpath" "\maximo\lib\
db2ejdbc.jar;\maximo\lib\mobilepreboot.jar;maximo\lib\symbolclasses.jar"
21
22
Procedure
1. In the Mobile Data Manager application, enter the name of the user group for
which you want to limit the available records on the mobile device.
2. Select an application, and then select a data group.
3. Create a query for each data group. For example, you can create a query for
assets so that only assets that are active for 180 days or fewer can be queried
from a mobile device. Repeat the process for all data groups and user groups in
the applications.
Procedure
1. In the Mobile Data Manager module on the application server, create a query
for a user group in an application.
2. Before you save the query, select Download by Default from the query creation
screen.
3. Save the query.
Procedure
1. In the Mobile Data Manager application on the application server, create a
query for a user group in an application.
2. Before you save the query, click Count Records from the query creation screen.
3. Enter the user name of the user for whom you want to count the records from
the query being sent to a mobile device.
4. Click OK.
Copyright IBM Corp. 2007, 2009
23
Procedure
1. After the queries are created in the Mobile Data Manager application on the
application server, select the Select Action menu.
2. Select Analyze Mobile Data.
3. Select an application, then enter a user name to analyze.
4. Select Full Refresh or Work List Refresh. A full refresh displays all the data on
a mobile device, and a work list refresh displays the work list items and the
supporting data on the device. Analyzing the data may take several minutes
because the data transfer to the mobile device is being simulated.
Procedure
1. After the queries are created in the Mobile Data Manager application on the
application server, click the Select Action menu.
2. Select Supporting Data.
3. Select an application, and then select a data group. The supporting data is
listed.
4. To remove the supporting data from all groups and users, clear the Download
check box of the data group name of the supporting data.
5. Save your changes.
24
mobilewo.xml
mobileinv.xml
mobileam.xml
Procedure
1. Open the XML definition file for the application that you want to configure.
2. Add or change the attribute for the XML tag. For example, by adding the
size=3 attribute to the <textbox> tag, the length of a field is 3.
3. Save the XML definition file.
25
Condition
Action
notfound
instant
instantask
The <scanevent> tag creates or displays the record after the insertonscan attribute
activates the system to create a record.
The following table lists the required attributes for the <scanevent> tag.
Table 2. Required attributes for the <scanevent> tag
Attribute
Description
ID
type
event
The name of the event that handles the information that is read from the
scanner.
targetid
value
Example
You are configuring the XML definition file for Maximo Mobile Work Manager,
and want the table for work orders to be configured for bar code scanning. In the
<table> tag for work orders in the mobilewo.xml definition file, you enter the
following code:
<table id="woresultstbl" rowsperpage="9" toolbar="tabletbar" filterpage="wofilter"
rowstyleevent="setworkliststyle" enablebarcode="true" insertonscan="notfound">
<scanevent id="woresultstbl_scan" type="view" event="gotoworklistmainpage"/>
26
XML tag
Attribute
Adding fields
<textbox>
dataattribute
<textbox>
size
<textbox>
label
Limiting maximum
characters in a field
<textbox>
maxdatalength
XML tag
Attribute
<mobilembo>
usequeries= true
<mobilembo>
queryrequired=true
If queryrequired=false, all
the data for this data group
is downloaded.
enablebarcode= true
<table>
filtercondition
<textbox>
displaymode= required
<textbox>
inputmode= read-only
Validating a domain
<textbox>
domain
domainattribute
XML tag
Attribute
<table>
insertonscan= notfound,
instant, or instantask
<table>
enablebcevent
Scanning event
<scanevent>
ID
type = view (default) or
type=insert
event
<tablecolumn>
scantype= primary or
secondary
27
Procedure
1. Navigate to the maximo_root\mobiletools\maximo folder. Right-click the
properties file and open it with a text editor.
2. Change the following attributes:
XML tag
Attribute
Action
<sectionrow>
colspacing
<section>
rowspacing
Procedure
1. Open a command prompt and navigate to the maximo_root\mobiletools\maximo
directory.
2. Enter cloneapp appname clonename. For example, to duplicate the Mobile Work
Management application, enter cloneapp mobilewo mobilewo1.
3. Click OK when the Clone Successful message is displayed.
28
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 users 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:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 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 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.
29
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:
U.S.A. 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 information 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 IBMs 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
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of
International Business Machines Corporation in the United States, other countries,
or both. If these and other IBM trademarked terms are marked on their first
occurrence in this information with a trademark symbol ( or ), these symbols
indicate U.S. registered or common law trademarks owned by IBM at the time this
information was published. Such trademarks may also be registered or common
law trademarks in other countries. A current list of IBM trademarks is available on
the Web at Copyright and trademark information at www.ibm.com/legal/
copytrade.shtml
Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered
trademarks or trademarks of Adobe Systems Incorporated in the United States,
and/or other countries.
30
Java and all Java-based trademarks and logos are trademarks of Sun Microsystems,
Inc. in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of
Microsoft Corporation in the United States, other countries, or both.
Other company, product, and service names may be trademarks or service marks
of others.
Notices
31
32
Index
A
application data
importing 13
application server
installing Maximo Mobile Suite
attributes
adding 27
modifying 27
B
bar code scanning
adding a library 20, 21
attributes 25
creating a profile 18
dependencies 25
enabling 19, 20
Intermec 20
Intermec mobile device 19
Motorola Symbol 21
Motorola Symbol mobile device
record creation 25
20
Maximo database
backing up 3
updating 3
Maximo Mobile
installing 5
Maximo Mobile Suite
properties 11
middleware
installing 15
installing on a mobile device 15
installing on a personal computer
overview 15
mobile applications
cloning 28
mobile device
counting records 23
download data 23
Intermec 20
managing data 23
Motorola Symbol 21
preparing to install 11
properties 11
requirements 1
cloning
mobile applications 28
configuration
overview 17
cron tasks
polling frequency 18
removing transactions 18
customizing
overview 25, 28
packaging
overview 13
planning
overview 3
polling frequency
cron tasks 18
profile
bar code scanning 18
properties
Maximo Mobile Suite 11
17
T
16
transactions
processing 18
queues 18
removing 18
translating
Maximo Mobile Suite
13
V
values
validating
25
X
XML definition files
configuring 25
overview 25
domain validation
attributes 25
dependencies 25
queries
creating 23
managing 23
I
importing
application data
installation
packaging 11
planning 3
updates 3
status changes
sending separately from records
statuses
creating asset statuses 17
R
record creation
bar code scanning 25
records
creating unique records
13
M
managing data
analyzing 24
counting records 23
creating queries 23
mobile device 23, 24
removing data groups
17
24
security
authenticating users 9
granting access rights 7
groups 7
LDAP servers 9
setup process
overview 1
33
34
Printed in USA