Beruflich Dokumente
Kultur Dokumente
William Cary
Solution Architect Council Leader
Bradley K. Downing
Senior Managing Consultant
Contents
Introduction ..................................................................................................................................... 3
Technical Overview ........................................................................................................................ 3
Architectural Principles .............................................................................................................. 3
IBM Worklight mobile application platform .............................................................................. 4
IBM Worklight Components Overview...................................................................................... 5
Worklight Studio..................................................................................................................... 5
Application Center .................................................................................................................. 6
Worklight used by Maximo Anywhere....................................................................................... 7
Maximo Anywhere Components ................................................................................................ 8
Recommended Deployment Scenarios ....................................................................................... 9
Product Licensing Metric and Compliance Considerations............................................................ 9
Use Scenarios ............................................................................................................................ 10
License Limitations Pertaining to Worklight ............................................................................ 10
Recommendations and Best Practices .......................................................................................... 10
Device Encryption .................................................................................................................... 10
Secure Communication Protocol (SSL) .................................................................................... 11
Enterprise DMZ ........................................................................................................................ 11
Worklight Server Installation .................................................................................................... 11
Maximo Anywhere Installation ................................................................................................ 11
System Requirements and Supported Configurations .................................................................. 12
Installation Procedures .................................................................................................................. 12
Worklight Server/DB2/Multi Instance ...................................................................................... 14
Worklight Server/DB2/Multi Schema ...................................................................................... 16
Worklight Server/Oracle/Multi Instance................................................................................... 19
Worklight Server/Oracle/Multi Schema ................................................................................... 21
Maximo Anywhere Install/Deployment ................................................................................... 23
Installing and Configuring Work Light Studio ......................................................................... 25
SSL Configuration .................................................................................................................... 26
Enabling Data Encryption for Maximo Anywhere ................................................................... 27
Post Installation Query Configuration ...................................................................................... 28
Cautions and Limitations .............................................................................................................. 29
Troubleshooting ............................................................................................................................ 28
Logging ..................................................................................................................................... 30
Known Problems / Explanations or Solutions .......................................................................... 31
2
Getting Started with Maximo Anywhere 7.5
Introduction
Maximo Anywhere 7.5 is built on IBM’s Worklight mobile development platform. This
development approach enables the Maximo Anywhere mobile roadmap to include all of IBM’s
Smarter Infrastructure (SI) solutions. The core of IBM SI includes Maximo, Maximo Industry
Solutions, SmartCloud Control Desk, and TRIRIGA. With this single mobile solution, all of
these tools can be enhanced with mobile capabilities to satisfy mobile strategies across your
entire enterprise
In this initial release of Maximo Anywhere, the Android mobile operating system 4.x or later is
supported for Maximo Work Management. Our strategy involves the eventual support for all of
the more popular mobile operating systems (Android, Apple iOS, and Microsoft Windows
operating), thus allowing you full freedom to utilize the most appropriate devices for your
industry. The Maximo Anywhere product will support all variations of the connected and
disconnected environments that you work with today.
The new technology in Maximo Anywhere provides a configuration tool set which allows you to
be in total control of how your users access IBM SI Solutions. You will be able to configure our
mobile apps to suite your users specific roles and enterprise business requirements.
The intent of this guide is to provide a condensed, straight forward step by step approach to
deploying Maximo Anywhere in your enterprise. Since there is considerable documentation
available through IBM’s InfoCenter, Support documents, and DeveloperWorks Wiki’s and more,
this document will leverage those resources as references when you may like additional
information. This document may be printed to simplify use in an installation scenario but may be
most valuable when used online where the links can be accessed.
Additional Resources:
Technical Overview
Architectural Principles
IBM has developed several architectural principles to enhance the user experience. These
principles employed in the platform and application development process
3
Getting Started with Maximo Anywhere 7.5
Mobile Device and Experience
IBM chose the Worklight Platform as the starting point for Smarter Infrastructure (SI) Mobile
Solutions. The SI Mobile Apps are Hybrid Applications (Web Standards + bridge to native
features). IBM Seeks to employ Persona and Task based apps that are simple & intuitive.
IBM took great care in considering when the device connects to ensure data integrity through the
synchronization process while maximizing device battery life, by leveraging the Worklight 5.0.6
data management APIs for local storage. The SI Mobile solution uses these APIs and augments
the solution with planned and intermittent disconnected scenarios.
Accelerate Development
• Server-enforced authentication
• App authenticity and user-app-device binding
4
Getting Started with Maximo Anywhere 7.5
• Secure and syncable on-device storage
• App version enforcement
IBM Worklight goes beyond mobile app UI creation to deliver mobile optimized, standards-
based, middleware and tools for enterprise-grade mobile applications and services creation
Worklight Studio
5
Getting Started with Maximo Anywhere 7.5
Supports auto-complete and validation
Universality
Diverse support for enterprise integration technologies and back-end information systems
Read-only & Transactional Capabilities
Adapters support read-only and transactional access modes to back-end systems
Fast Development
Simple XML configuration and JavaScript APIs
Security
Fine-grained access controls
Transparency
Uniform exposure of back-end data for all adapter types
Application Center
6
Getting Started with Maximo Anywhere 7.5
Worklight used by Maximo Anywhere
Maximo Anywhere is a Hybrid App using Worklight code, HTML5 and some device functions:
Html, Javascript,css for common code across platforms which allows faster development
and maintenance
Android SDK, cordoba plugins where device specific feature needed
Access to native features: GPS, barcode Scanning through camera, offline maps, email.
(More to come in future releases)
Disconnected – local data storage based on Worklight Json Store
7
Getting Started with Maximo Anywhere 7.5
Maximo Anywhere Components
Environment Descriptions
The administration computer has the “source” files for Maximo and the tools for managing the
environment. The source files are built into an enterprise archive (EAR) file for deployment to
the WebSphere application server. The WebSphere server provides a web environment where
clients connect to the Maximo Application. The Maximo application connects to the database to
store and retrieve data. This simplified environment to be scaled in many ways but the basics
remain true.
The administration computer has the “source” or “build” files for the Worklight and Maximo
Anywhere build environment. The WAR file for Worklight is deployed to the WebSphere
server. The Maximo Anywhere mobile applications are built and deployed to the Worklight
server that has been deployed to WebSphere. The Worklight server has an embedded application
center for distributing and maintaining mobile applications with connected users.
Mobile devices connect to the app center to install and maintain their mobile applications. At
runtime, Maximo Anywhere mobile applications retrieve and send data through the Worklight
server which communicates with the supported base Smarter Infrastructure application using
Worklight Adapter Technology. Note: Worklight Adapter Technology uses OSLC.
8
Getting Started with Maximo Anywhere 7.5
Recommended Deployment Scenarios
Development
– Anywhere Source, Worklight Studio, Worklight Source on Mobile Admin Computer
– Maximo Source on Maximo Admin Computer
– WebSphere, Maximo, Worklight Runtime, Maximo Anywhere Runtime on WebSphere
Test/QA/Pre-Prod/Prod
– Anywhere Source, Worklight Studio, Worklight Source on Mobile Admin Computer
– Maximo Source on Maximo Admin Computer
– WebSphere, Maximo on Maximo WebSphere Cluster
– Worklight Runtime, Maximo Anywhere Runtime on Worklight WebSphere Cluster
If a user is a mobile user ONLY, then the license to the bundle(s) that they access is all the
license entitlement that they require. If on the other hand, as part of their role, the mobile user
also returns to their desk periodically and accesses Maximo via their desktop computer, then the
user must also have base Maximo product entitlements that correspond to their use of Maximo
(i.e. Express, Limited Use Authorized User, or Authorized User).
The Maximo Anywhere product has Worklight components embedded within it. Customers are
able to use the Worklight components for the purpose of running the Maximo Anywhere mobile
applications. There are a few situations which will help to understand the boundaries of the
Worklight use.
If a customer accesses another data source besides Maximo (also TRIRIGA and SCCD
starting in the phase 2 Anywhere product), such as ERP, Production system, another Asset
Management system, then the changes to the mobile apps necessitate the need to obtain
full Worklight license coverage.
If a customer creates a brand new mobile application for Maximo (i.e. a mobile version of
a custom application they created within base Maximo), then the changes necessitate the
need to obtain full Worklight license coverage.
If a customer creates a brand new mobile app over and above Maximo (or TRIRIGA or
SCCD) for another enterprise system within their organization (which we expect a large
degree of customers to do) then the creation of the new app necessitates the need to obtain
full Worklight license coverage.
Note: Clones are exempt from this license boundary as long as the business intent of the
original mobile app is not changed (i.e create a contracts app from work execution app)
Device Encryption - Maximo Anywhere 7.5 installs mobile applications on mobile devices
with device level encryption disabled by default. Mobile devices have some level of protection
through password authentication but the data itself is accessible if the device password is
compromised. In addition to authentication protection, some enterprise remote device
management solutions (from your company) may include device level encryption. Maximo
Anywhere does not store large quantities of data on the device in a format that might
compromise the base application. With all this in mind, some enterprises may still require
maximum protection of any data on a mobile device.
If enterprise policy requires maximum security of device data IBM recommends that device level
encryption be enabled. This action will encrypt the JSON stores on the device so that
unauthorized users cannot access the data at any time. Enabling device level encryption means
that JSON stores must be decrypted at user login time. Decrypting may add time to the login
10
Getting Started with Maximo Anywhere 7.5
process. In our tests, login without encryption enabled took under 10 seconds and with
encryption enabled, it took under 30 seconds.
IBM recommends using SSL for all communications over systems not controlled by your
enterprise. Even with encrypted data on your mobile devices, the communication channel should
also be protected.
Enterprise DMZ – There is nothing in the Maximo Anywhere components that requires the
use of a secure network. Yet for the above considerations, IBM recommends using an HTTP
server outside the enterprise firewall in the DMZ at the entry to the enterprise network. All
Worklight, Maximo Anywhere and base application components should be behind the firewall.
This added level of security along with device encryptions and use of SSL will ensure the most
secure approach to implementing Maximo Anywhere.
Maximo Anywhere Installation – The Worklight Studio, and Maximo Anywhere install
on the same administration computer. This computer is often called the Maximo Anywhere
11
Getting Started with Maximo Anywhere 7.5
development or build computer. Since the Anywhere administration computer is really just
where the source and build files for the application deployment are stored and built, these files
do not need to be on the server where Worklight is running. You can think of the administration
computer as really the Maximo Anywhere development environment where the source files are
modified and built into deployment packages. When it is time to deploy, the Maximo Anywhere
packages will be deployed to the Worklight runtime application.
Our tests show that a single Worklight server can support many mobile devices. If high
availability is a factor, at least two Worklight servers should be configured in a cluster and load
balanced so that in the event of a failure, Worklight will continue to be available.
The link below provides the most up to date information for minimum prerequisites and other
specifications. Please review this content in detail.
https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/IBM%20Maxim
o%20Asset%20Management/page/Maximo%20Anywhere%20system%20requirements
Installation Procedures
Whether you have an existing Maximo implementation or you are starting a new one, Maximo
Anywhere 7.5 mobile solutions are designed to “plug in” to your system using dedicated
components combined with state of the art Open Service for Lifecycle Collaboration (OSLC)
integration communications.
Before you begin, you should understand the difference between a multi-instance database and a
multi-schema database. A multi-instance database environment is one where a database server is
configured with distinct database instances for connectivity and storage of data. A multi-schema
database environment is one where a single database instance is configured and database objects
12
Getting Started with Maximo Anywhere 7.5
such as tables and indexes are setup under unique users/owners. In multi-schema, there is only
one database but owners within that database have access to different objects.
Out of the box, Worklight expects to be in a multi-instance environment. In cases where multi-
schema is required, please follow the installation procedures closely for your database
environment.
The following sections describe the procedure for installing the Maximo Anywhere software.
Architectural considerations are delineated, so please refer to the section that applies to your
system. The first six steps are common to all architectures.
Maximo Anywhere
Worklight Server
2) Extract the contents of the Maximo Anywhere package into a folder called "Launchpad"
5) Click on Install Required Components, point to your Maximo directory and install
Maximo Integration Framework and Maximo Anywhere Enablement and
information center to your current Maximo environment as you would any other Maximo
FP install.
a. IBM recommends that you choose to manually defer the update and deployment
option.
6) Once complete, manually run updatedb from ibm\smp\maximo\tools\maximo folder.
Then rebuild and redeploy the maximo.ear file.
Note: Worklight is shipped with WebSphere Liberty, a lighter version of WebSphere which does
not require configuration for Worklight deployment. The following steps include steps for
configuring the full versions of WebSphere. Those steps are identified by the words “On the
WebSphere Server”.
To use the included WebSphere Liberty product, select “Install WebSphere Application Server
Liberty Profile” from the application server panel. If you are using Liberty, steps identified by
“On the WebSphere Server” can be skipped.
If you are not using the included WebSphere Liberty option, before you begin the Worklight
Server installation, confirm that a WebSphere profile has been setup in your WebSphere
environment for Worklight. See the following link for more information on WebSphere profile
management:
http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/topic/com.ibm.websphere.base.doc/ae/tpro_
profiles.html
13
Getting Started with Maximo Anywhere 7.5
Worklight Server/DB2/Multi Instance
7) Before beginning the Worklight Install, create the DB2 user that you will use for
Worklight and assign the user to the DB2ADMIN group such as DB2USERS on the
operating system hosting your DB2 database. Note: The DB2 user is created at the
Operating System level. Create an OS user for DB2 to use with the Worklight DB. We
create a user called “wluser” as an example. Replace instances of wluser with the
username you create.
8) Run the following statements to create the required databases and grant permissions to
the Worklight database user you created above.
9) Click on the 'Install Maximo Anywhere Work Manager' and check the box beside 'IBM
Worklight Server for Worklight Consumer Edition'
10) Select the Work Light Version 5.0.6 Install Package and click next.
11) Choose your shared install directory path then click next then choose the installation
directory for Worklight, click next again.
12) On the database configuration screen choose IBM DB2 Enterprise Server Edition V9.7
and later.
13) On the setting screen enter the following data and click next three times
14
Getting Started with Maximo Anywhere 7.5
Port: port to the db2 server (generally 50000 for windows, 50005 for UNIX platforms)
User name: WLUSER created previously
Password: WLUSER password created previously.
IBM DB2 Driver for JDBC: Download the driver from the link provided on the install
screen, extract the driver, and point this installer field to it.
14) For full WebSphere installs, on the application server choice screen choose 'Use pre-
installed application server' then choose 'WebSphere Application Server (Liberty Profile,
7.0,8.0,8.5 Full Profile)' and click next.
15) For full WebSphere installs, select the directory for your WebSphere Application Server
that contains the Worklight Profile (e.g c:\IBM\WebSphere\AppServer.)
16) For full WebSphere installs, choose the Worklight Profile and then Select the Worklight
Server and enter your WASADMIN username and password.
17) For full WebSphere installs, select the Installation Mode, either Single user or Multiple
users. If multiple users select the appropriate OS group and continue until you can click
install.
18) For full WebSphere installs, if prompted for an install package point to your disk1 folder
in Launchpad\masterSetupDisk.
This will install and deploy the Worklight Server to WebSphere Full Profile. You can verify the
appcenterconsole and worklight console are running using the following URL.
http://{yourhostname}:{yourport}/worklight/console
http:// {yourhostname}:{yourport}/appcenterconsole
15
Getting Started with Maximo Anywhere 7.5
Worklight Server/DB2/Multi Schema
7) Before beginning the Worklight Install, create the DB2 user that you will use for
Worklight and assign the user to the DB2ADMIN group such as DB2USERS on the
operating system hosting your DB2 database. Note: The DB2 user is created at the
Operating System level. Create an OS user for DB2 to use with the Worklight DB. We
create a user called “wluser” as an example. Replace instances of wluser with the
username you create.
8) Create your Worklight Database and grant access to the DB User using the DB2
Command Line Processor using the following command:
9) Click on the 'Install Maximo Anywhere Work Manager' and check the box beside 'IBM
Worklight Server for Worklight Consumer Edition'
10) Select the Work Light Version 5.0.6 Install Package and click next.
11) Choose your shared install directory path then click next then chose the installation
directory for Worklight, click next again.
12) On the database configuration screen choose 'Install Apache Derby 10.8 Release (not for
production use)
13) Click next until you reach to Application server choice page. Choose Install WebSphere
Application Server Liberty Profile.
16
Getting Started with Maximo Anywhere 7.5
14) Click next until you see Install then click Install. If prompted for a Disk Location point to
the Disk 1 Folder you extracted to Launchpad\masterSetupDisk.
15) Remove the Liberty Profile and Derby Databases after the install is successful by deleting
the c:\ProgramData\IBM\Worklight folder.
16) Create the Worklight Database tables and set their individual Schema's using the
following scripts and pointing to the db creation scripts installed with Worklight
previously
17) Create the WebSphere Data Sources to connect to DB2 in the WebSphere Console.
18) Download the DB2 JDBC Driver JAR files and copy to
{WAS_HOME}/optionalLibraries/IBM/Worklight/5.0.6/db2
19) Expand Resources - > JDBC - > JDBC Providers - > Click on New and provide the
following information
20) Expand Resources - > JDBC -> Data Sources - > Click New Data Source
17
Getting Started with Maximo Anywhere 7.5
Data source Name: Worklight Schema
JNDI Name: jdbc/WorklightDS
21) Click “Next” and select the JDBC Provider you created then enter the database
information for your DB2 Worklight
22) On the Setup Security Alias Screen, click on Global J2C authentication alias at the
bottom and enter the information for your Work Light Database User. Once created go
back and under Component-Managed Authentication Alias, choose the Alias you created
the click next and finished.
23) In the Data Source you just created, click on WebSphere Application Server Data Source
Properties and check the "Non-transaction data source" box.
24) Again in the Data Source you just created, click on Custom Properties and select the
property "currentSchema". Set this to the Schema for the Worklight Database
(WRKSCHM)
25) Repeat steps 20 - 24 for the Application Center Schema and the Work Light Reports
Schema using the following information
26) Restart the WebSphere services then test the connection on your data sources.
27) Once your data sources have been tested you will need to modifying the
worklight.properties inside the worklight war file. Open the file in a archive tool and edit
the properties file.
wl.db.type=DB2
wl.reports.db.type=DB2
29) Comment out the JDBC string as data sources are being used to make the connection by
adding # infront of wl.db.url and wl.reports.db.url so it looks like
#wl.db.url
#wl.reports.db.url
18
Getting Started with Maximo Anywhere 7.5
30) Save the properties file back into the war
31) Manually configure WebSphere for Worklight server and deploy the Worklight war
using the Worklight step by step documentation
http://pic.dhe.ibm.com/infocenter/wrklight/v5r0m6/index.jsp?topic=%2Fcom.ibm.workli
ght.help.doc%2Fadmin%2Fc_manually_configuring_app_server.html
7) Before beginning the Worklight Install, create 3 databases using the Oracle Database
Configuration Assistant called WRKLGHT, WLREPORT and APPCNTR.
NOTE: Select the following character sets. Unicode (AL32UTF8) character set and
UTF8 - Unicode 3.0 UTF-8 national character set.
8) Run the following statements to create the Worklight user on the databases you created
above and grant the proper permissions.
CONNECT system/<system_password>@WRKLGHT
CREATE USER wluser IDENTIFIED BY wluser;
GRANT CONNECT TO wluser;
GRANT RESOURCE TO wluser;
GRANT CREATE VIEW TO wluser;
DISCONNECT;
CONNECT system/<system_password>@WLREPORT
CREATE USER wluser IDENTIFIED BY wluser;
GRANT CONNECT TO wluser;
GRANT RESOURCE TO wluser;
GRANT CREATE VIEW TO wluser;
DISCONNECT;
CONNECT system/<system_password>@APPCNTR
CREATE USER wluser IDENTIFIED BY wluser;
GRANT CONNECT TO wluser;
GRANT RESOURCE TO wluser;
GRANT CREATE VIEW TO wluser;
DISCONNECT;
9) Click on the 'Install Maximo Anywhere Work Manager' and check the box beside 'IBM
Worklight Server for Worklight Consumer Edition'
10) Select the Work Light Version 5.0.6 Install Package and click next.
11) Choose your shared install directory path then click next then chose the installation
directory for Worklight, click next again.
12) On the database configuration screen choose Oracle 11g Standard/Enterprise Editions
Release 1 and Later
19
Getting Started with Maximo Anywhere 7.5
13) On the setting screen enter the following data and click next three times
14) On the application server choice screen choose 'Use pre-installed application server' then
choose 'WebSphere Application Server (Liberty Profile, 7.0,8.0,8.5 Full Profile)' and
click next.
15) Select the directory for your WebSphere Application Server that contains the Worklight
Profile for example: c:\IBM\WebSphere\AppServer\profiles. Choose the Worklight
Profile and then Select the Worklight Server and enter your WASADMIN username and
password.
20
Getting Started with Maximo Anywhere 7.5
16) Select the Installation Mode, either Single user or Multiple users. If multiple users select
the appropriate OS group and continue until you can click install
This will install and deploy the Worklight Server to WebSphere Full Profile. You can verify the
appcenterconsole and Worklight console are running using the following URL.
http://{yourhostname}:{yourport}/worklight/console
http:// {yourhostname}:{yourport}/appcenterconsole
7) Click on the 'Install Maximo Anywhere Work Manager' and check the box beside 'IBM
Worklight Server for Worklight Consumer Edition'
8) Select the Work Light Version 5.0.6 Install Package and click next.|
9) Choose your shared install directory path then click next then chose the installation
directory for Worklight, click next again.
10) On the database configuration screen choose 'Install Apache Derby 10.8 Release (not for
production use)
11) Click next until you reach to Application server choice page. Choose Install WebSphere
Application Server Liberty Profile. Note: Even though you may not be using WebSphere
Liberty, this will streamline the installation process.
12) Click Next until you see Install then click Install. If prompted for a Disk Location point
to the Disk 1 Folder we extracted to Launchpad\masterSetupDisk.
13) If you are not using the WebSphere Liberty installed, remove the Liberty Profile and
Derby Databases after the install is successful by deleting the
c:\ProgramData\IBM\Worklight folder.
14) Create a Worklight database for your Schemas using the Oracle Database Configuration
Assistant.
15) Create 3 separate users for your Schemas on the Worklight Database (WORKLIGHT,
WORKLIGHTREPORTS, APPCENTER) and grant the appropriate permissions.
CONNECT system/system_password@WORKLIGHTDB
CREATE USER wluser IDENTIFIED BY wluser_password;
GRANT CONNECT, RESOURCE, CREATE VIEW TO wluser;
DISCONNECT;
CONNECT system/system_password@WORKLIGHTDB
CREATE USER WORKLIGHTREPORTS IDENTIFIED BY WORKLIGHTREPORTS_password;
GRANT CONNECT, RESOURCE, CREATE VIEW TO WORKLIGHTREPORTS;
21
Getting Started with Maximo Anywhere 7.5
DISCONNECT;
CONNECT system/system_password@WORKLIGHTDB
CREATE USER APPCENTER IDENTIFIED BY APPCENTER_password;
GRANT CONNECT, RESOURCE, CREATE VIEW TO APPCENTER;
DISCONNECT;
16) Create the tables in the Worklight database for each of the schemas, ensure you are
running the scripts on the correct schema's.
CONNECT WORKLIGHT/WORKLIGHT_password@WORKLIGHTDB
@worklightserver_home/WorklightServer/databases/create-worklight-oracle.sql
DISCONNECT;
CONNECT WORKLIGHTREPORTS/WORKLIGHTREPORTS_password@WORKLIGHTDB
@worklightserver_home/WorklightServer/databases/
create-worklightreports-oracle.sql
DISCONNECT;
CONNECT APPCENTER/APPCENTER_password@WORKLIGHTDB
@worklightserver_home/ApplicationCenter/databases/create-appcenter-oracle.sql
DISCONNECT;
17) Download the Oracle JDBC Driver for use with WebSphere Datasources.
18) Log into the WebSphere Console and expand Resources - > JDBC - > JDBC Providers
and click on New and enter the following properties.
19) Save the Driver, then go back in and specify the path to your Oracle JDBC driver
downloaded earlier.
20) Expand Resources - > JDBC -> Data sources and click on New. Set the JNDI name to
jdbc/WorklightDS provide a description and click next.
21) Choose Select an existing JDBC provider and select the Oracle JDBC Driver you created
earlier from the list.
22) Set the URL to the JDBC path for your Oracle Database
(e.g jdbc:oracle:thin:@{yourserver}:1521:WORKLIGHTDB)
23) On the same data sources create two new custom properties
user: wluser
password: password for wluser user
24) Repeat steps 20 to 23 for the following JNDI, specifying the Worklight database and the
user and password in custom properties for the corresponding schema's
22
Getting Started with Maximo Anywhere 7.5
JNDI name jdbc/WorklightReportsDS.
JNDI name jdbc/AppCenterDS.
26) Once your data sources have been tested you will need to modify the worklight.properties
inside the Worklight war file. Open the file in an archive tool and edit the properties file.
27) Remove the comments on the #wl.db.type and #wl.reports.db.type properties by
removing # and replace with your corresponding database type in this case you would
have.
wl.db.type=Oracle
wl.reports.db.type=Oracle
28) Comment out the JDBC string as data sources are being used to make the connection by
adding # infront of wl.db.url and wl.reports.db.url so it looks like
#wl.db.url
#wl.reports.db.url
30) Manually configure WebSphere for Worklight server and deploy the Worklight war
using the Worklight step by step documentation
http://pic.dhe.ibm.com/infocenter/wrklight/v5r0m6/index.jsp?topic=%2Fcom.ibm.workli
ght.help.doc%2Fadmin%2Fc_manually_configuring_app_server.html
1) Choose IBM Maximo Anywhere from the Installation Manager 'Install Maximo
Anywhere Work Manager' Screen.
2) Complete the license agreements and on the 'Configuration for IBM Maximo Anywhere
screen' enter the following properties. Note: Use lower case for the context root to
simplify the user experience so they will not need to enter upper case characters in the
URL.
Worklight Server
-----------------
Protocol: http or https
Hostname: Hostname of your Worklight console
Port: Port uses to the access the Worklight console
Context root: worklight
Application Center
23
Getting Started with Maximo Anywhere 7.5
-------------------
Url: URL to the application center and port. e.g http://appcenterhost:9081/
Context Root: applicationcenter
Username: Username defined for your app center console
Password: Password defined for your app center console.
Android Platform
-----------------
SDK Directory: Location of your android SDK install folder
AP Version: Version of the Android API for example: android-18
4) Ensure your build.properties and deploy.properties in the following folder have the
correct properties.
MaximoAnywhere\platform\mobile\config
build all-gen
build all-dist
http://pic.dhe.ibm.com/infocenter/wrklight/v5r0m6/index.jsp?topic=%2Fcom.ibm.workli
ght.help.doc%2Fadmin%2Fc_manually_configuring_app_server.html
build all-deploy
24
Getting Started with Maximo Anywhere 7.5
9) Access your Worklight Console and Application Center Console and ensure the mobile
applications WorkApproval and WorkExecution exist.
10) Download the applications using the IBM Admin Center application to connect to the
App Center Console on the device, or test using Google Chrome and preview common
resources.
1) Open the Launchpad and choose 'IBM Worklight STudio for Worklight Consumer
Addition'
3) Accept the license agreement and proceed with entering the installation directory. Ensure
32 bit is checked as WLStudio doesn't suppoer 64-bit. Click Next
5) Choose the path of your Oracle JRE, (this must be a 32 bit installation of 1.6 Java) and
click next to finish the installation.
6) If you installed WL Studio onto a server with an existing eclipse installation, update the
eclipse.ini using the steps in the following document.
http://pic.dhe.ibm.com/infocenter/wrklight/v5r0m6/index.jsp?topic=%2Fcom.ibm.workli
ght.help.doc%2Fdevenv%2Ft_next_steps.html
7) Launch Worklight Studio from the IBM Software Delivery Folder in your start menu.
10) Check the box beside developer tools and click next twice, review the license agreement
and click finish and restart WL Studio
25
Getting Started with Maximo Anywhere 7.5
11) Once you enter the WL Studio again and choose your previous workspace you will be
prompted for your Android SDK location, specify the directory to your Android SDK and
click apply.
12) Right Click in the Project Explorer and Choose Import, expand General and select
"Existing Projects into Workspace". Click Next.
13) Choose Select root directory and point to your MaximoAnywhere folder and click
Finish.
14) From the windows menu tab choose preferences, expand ant and select runtime.
16) Open the Ant view by going to the Window tab - > Show View - > Other - > Ant
17) Drag the build.xml from your Project Explorer to the Ant view you previously opened.
18) Confirm your properties files in the project explorer are correct and pointing to localhost
and port 8080 for the build in worklight server then double click on all-gen from the Ant
View
19) Right click and refresh the Project Explorer, once done right click again and choose
Import - > Import - > Import existing projects into workspace then select the following
path and click ok and let the workspace build.
MaximoAnywhere\platform\mobile\target\GEN\PROJ
20) Once your MaximoAnywhere eclipse project shows up, right click on it and choose 'Start
Worklight Server'
22) Expand MaximoAnywhereProject - > apps - > Right click on ' WorkApproval' -> Choose
'Run As' -> Build All and Deploy
23) Expand MaximoAnywhereProject - > apps - > Right click on ' WorkExecutionl' ->
Choose 'Run As' -> Build All and Deploy
SSL Configuration
1) Open your browser and navigate to the your Maximo environment using HTTPS. Download
the certificate using your browser to a file (worklight_ssl.cer)
26
Getting Started with Maximo Anywhere 7.5
2) Import the Certificate into the Worklight Default KeyStore (This is done using the keytool
bunbled with Java).
ssl.keystore=conf/default.keystore.worklight
ssl.keystore.type=jks
ssl.keystore.password=worklight
<connectivity>
<connectionPolicy xsi:type="http:HTTPConnectionPolicyType"
cookiePolicy="IGNORE_COOKIES">
<protocol>${worklight.adapter.protcol}</protocol>
<domain>${worklight.adapter.domain}</domain>
<port>${worklight.adapter.port}</port>
<sslCertificateAlias>worklight</sslCertificateAlias>
</connectionPolicy>
<loadConstraints maxConcurrentConnectionsPerNode="50" />
</connectivity>
5) Modify your deploy.properties so the following properties are changed for https
adapter.connection.protocol=https
adapter.connection.port=9443 ( or corresponding SSL port)
build.cmd all-gen
build.cmd all-dist
http://pic.dhe.ibm.com/infocenter/wrklight/v5r0m6/index.jsp?topic=%2Fcom.ibm.worklight.help
.doc%2Fadmin%2Fc_manually_configuring_app_server.html
7) Deploy the Anywhere application to the Worklight Console and the AppCenter Console by
running
build.cmd all-deploy
27
Getting Started with Maximo Anywhere 7.5
1) Open up the build.properties from MaximoAnywhere\platform\mobile\config
2) Search for enableDataEncryption and change the value from false to true.
Once you have completed installation you will need to configure queries to download your work
to the application. To do this you must go to the Work Order Tracking application in order to
create a query for the Work Execution application.
1) Create a public query that will return the data you desire for your technicians in the field.
Once you are satisfied with the query results save the query and make note of the name
you created. Note: It must be a public query.
2) Edit the app.xml file for the work execution application. Navigate to the
{maximoanywhere_home}\MaximoAnywhere\apps\{application_name} directory, on the
Maximo Anywhere admin workstation. Open the app.xml file with the XML editor of
your choice.
3) Add a query to the work list view. The work list view is the first view that is defined in
the UI section of the application definition. Perform the following steps:
a) In the <queries> element for the work list view, add a child element called <query>.
b) Use the queryBase attribute to specify the name of the public query in Maximo Asset
Management. The query name is case sensitive.
c) Use the label attribute to specify the query label that is displayed in the work list
menu.
d) Optional: To define this query as the default query for the work list view, specify the
query label as the value of the label attribute for the parent <view> element.
NOTE: In the following example, we add three queries to the work list view for the Work
Execution app:
28
Getting Started with Maximo Anywhere 7.5
4) Add the query that you specified above to the primary resource. The primary resource is
the first resource that you defined in the data section of the application definition. Follow
these steps:
a) In the queryBases element for the primary resource, add a child element called
queryBase.
b) Use the “name” attribute to specify the name of the public query in Maximo. The
query name is case sensitive.
In this example, we add the same three queries used in the above example, to the primary
resource, workOrder, for the Work Execution app:
<resource providedBy="/oslc/sp/WorkManagement"
describedBy="http://jazz.net/ns/ism/work/smarter_physical_infrastucture#WorkOrder"
name="workOrder" pageSize="100" class="application.business.WorkOrderObject">
<{A whole bunch of attributes appear here}>
<queryBases>
<queryBase name="WorkIOwn">
<queryBase name="WorkforMyLabor">
<queryBase name="WorkforMyCrew">
</queryBases>
<{More XML stuff here}>
</resource>
c) Save the file.
d) Build and deploy the application.
Once you have completed this exercise you will be able to down load work orders to the device
according to the queries you created.
Because this is an initial offering using this new technology, the standards used to ensure
upgradability of applications is still being developed. Any changes to applications will likely
have to be manually migrated to new versions. In addition, changes to the business logic cannot
be supported at this time.
29
Getting Started with Maximo Anywhere 7.5
Troubleshooting
Logging
\\ProgramData\IBM\Installation Manager\logs
\\IBM\MaximoAnywhere\platform\mobile\target
Mobile logging
From the overflow menu on your mobile device select Settinges--> Advanced Settings -->
Logging, On the Logging Data screen from the overflow menu select one of the following: Error,
Info or Debug logging. Return to the worklist and reproduce the issue. Once you have this done,
Go to the Logging Data screen from the overflow menu, and select Email Log. Disable logging
when complete.
Server Logging
WebSphere Full Profile
If using a Full WAS Profile you would find the Server logging in the normal WebSphere logs
location for your Worklight Server.
IBM\WebSphere\AppServer\profiles\WorklightProfiles\logs\WorklightServer\SystemOut.log
IBM\WebSphere\AppServer\profiles\WorklightProfiles\logs\WorklightServer\SystemErr.log
For more information about WebSphere profiles see the following link:
http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/topic/com.ibm.websphere.base.doc/ae/tpro_profi
les.html
The server logs for the WebSphere Liberty Profile Setup are found in the following directory.
\\ProgramData\IBM\Worklight\WAS85liberty-server\wlp\usr\servers\worklightServer\logs
30
Getting Started with Maximo Anywhere 7.5
OSLC logging
From the Goto Menu choose System Configuration - > Platform Configuration - > Logging.
Filter for OSLC and change the logger from ERROR to INFO or DEBUG depending on detail of
logging needed. Ensure an appender is set (Console, Rolling or Custom), then apply the settings
from the Select Actions Menu.
If the Console is set this will write to your Maximo SystemOut Logs in the following directory:
IBM\WebSphere\AppServer\profiles\MaximoProfile\logs\MaximoServer\SystemOut.log
If you are using a different appender then Console it will write to the path setup for your Root
Logging Folder. You can check this from the Select Actions Menu.
Problem
1. If you happen to see this message when you start up the Worklight Server in Worklight
Studio/JETTY server:
Resolution/Workaround:
1. Copy MaximoAnywhereProject/server/conf/worklight.properties to
MaximoAnywhere/platform/mobile/target/GEN/PROJ/server/conf/worklight.properties
2. Refresh your MaximoAnywhereProject
3. Perform 'Build Project' on MaximoAnywhereProject
4. Perform 'Start Worklight Server' on MaximoAnywhereProject and it should come up.
Reason Why:
If you are running the jetty server, the worklight.properties cannot have any worklight settings. If
you use the build scripts to execute the ‘all-dist’ command, it will update the
worklight.properties with information from the config/worklight.war.
Problem
31
Getting Started with Maximo Anywhere 7.5
2. When trying to launch build.cmd command, the following error is displayed:
Resolution/Workaround:
3. When trying to deploy Mobile Anywhere applications (build.cmd all-deploy), the following
error is displayed:
Resolution/Workaround:
1. In deploy.properties, ensure the following entry has the appending backslash (/) at the end:
worklight.appcenter.server.url
i.e. http://hostname:9081/
Problem
4. During the Maximo Anywhere installation, when selecting the Oracle JDK, the following
error is displayed:
"The Oracle JRE bit mode must be the same as the bit mode of the product installation."
Resolution/Workaround:
32