with ibm corp....the r epository stor es the apps that can be installed on mobile devices. the r...

66
IBM Maximo Anywhere Version 7 Release 6 Planning, installation, and deployment IBM

Upload: others

Post on 04-Aug-2020

0 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

IBM Maximo AnywhereVersion 7 Release 6

Planning, installation, and deployment

IBM

Page 2: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

NoteBefore using this information and the product it supports, read the information in “Notices” on page 57.

This edition applies to version 7, release 6, modification 0 of IBM Maximo Anywhere and to all subsequent releasesand modifications until otherwise indicated in new editions.

© Copyright IBM Corporation 2013, 2016.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Page 3: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Contents

Chapter 1. Planning to deploy MaximoAnywhere . . . . . . . . . . . . . . 1System architecture and components . . . . . . 1System requirements for Maximo Anywhere,MobileFirst Server, and MobileFirst Studio . . . . 4Deployment topologies . . . . . . . . . . . 6

Development environment. . . . . . . . . 7Single-server deployment of Maximo Anywhereand MobileFirst Server . . . . . . . . . . 8Multiple-server deployment of MaximoAnywhere and MobileFirst Server . . . . . . 10

Installation overview . . . . . . . . . . . 12Installation planning worksheet . . . . . . . 14Installation checklist for Maximo Anywhere . . . 15

Chapter 2. Installing the MaximoAnywhere components. . . . . . . . 19Installing the Maximo Asset Management requiredcomponents . . . . . . . . . . . . . . 19Installing MobileFirst Server . . . . . . . . . 19

Setting the Java heap size on the JVM forWebSphere Application Server or WebSphereApplication Server Liberty . . . . . . . . 20Installing MobileFirst Server by using theinstallation program . . . . . . . . . . 20Installing the MobileFirst Server AdministrationServices . . . . . . . . . . . . . . 22

Preparing the Maximo Anywhere environment . . 23Installing the Android development tools . . . 23Installing the iOS development tools . . . . . 25Installing the Windows development tools . . . 27

Installing Maximo Anywhere . . . . . . . . 28Creating a MobileFirst runtime environment . . . 29Installing an integrated development environment 30Silent mode: Installing Maximo Anywhere . . . . 31

Recording a response file for silent installation . 31Installing the required components in silentmode . . . . . . . . . . . . . . . 32Installing Installation Manager in silent mode . . 33

Parameters for silent mode installation . . . 33Installing Maximo Anywhere in silent mode . . 34

Setting up Maximo Asset Management for MaximoAnywhere . . . . . . . . . . . . . . . 35

Adding users to the Maximo Anywhere securitygroups . . . . . . . . . . . . . . . 35Maximo Anywhere security groups in MaximoAsset Management . . . . . . . . . . . 36Enabling Maximo Asset Managementapplications for maps and labor reporting . . . 37Maximo Asset Management system options thataffect mobile apps . . . . . . . . . . . 37

Upgrading Maximo Anywhere . . . . . . . . 38Application definition changes in version 7.6.0 . 39

Chapter 3. Building and deployingMaximo Anywhere apps . . . . . . . 41Application deployment process for MaximoAnywhere apps . . . . . . . . . . . . . 41Deploying Maximo Anywhere apps to MobileFirstServer . . . . . . . . . . . . . . . . 43

Deploying apps from the command line toWebSphere Application Server . . . . . . . 43Deploying apps by using MobileFirst Studio . . 44Properties files . . . . . . . . . . . . 47Maximo Anywhere directory structure . . . . 48Configuring MySQL Database . . . . . . . 48

Adding digital signatures to Maximo Anywhereapps . . . . . . . . . . . . . . . . . 49Deploying apps to a secure server . . . . . . . 50Installing Maximo Anywhere apps on mobiledevices . . . . . . . . . . . . . . . . 50

Installing Maximo Anywhere apps on Windowsdevices . . . . . . . . . . . . . . . 50

Testing apps . . . . . . . . . . . . . . 51Setting up the Android emulator . . . . . . 52

Chapter 4. Uninstalling MaximoAnywhere, MobileFirst Server, andMobileFirst Studio . . . . . . . . . . 55

Notices . . . . . . . . . . . . . . 57Trademarks . . . . . . . . . . . . . . 59Terms and conditions for product documentation. . 59IBM Online Privacy Statement . . . . . . . . 60

© Copyright IBM Corp. 2013, 2016 iii

Page 4: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

iv Planning, installation, and deployment

Page 5: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Chapter 1. Planning to deploy Maximo Anywhere

IBM® Maximo Anywhere must be deployed with selected IBM MobileFirstPlatform Foundation components to an enterprise system that includes OpenServices for Lifecycle Collaboration (OSLC) provider capabilities.

The installation of Maximo Anywhere involves deploying components that arespecific to Maximo Anywhere and other components that are specific toMobileFirst.

During the Maximo Anywhere installation, you must perform tasks that areoutlined in the IBM MobileFirst Platform Foundation version 6.3.0 IBM KnowledgeCenter (www.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/wl_welcome.html). Before you install Maximo Anywhere, read the installation anddeployment information.

To access the documentation, you must have an internet connection.

System architecture and componentsMaximo Anywhere and MobileFirst form a mobile application platform thatintegrates with the Maximo® Asset Management enterprise system. MaximoAnywhere provides the content that is required to build mobile apps for MaximoAsset Management. The MobileFirst components function as middleware byenabling integration with the enterprise system and by supporting the deploymentof apps to mobile devices.

Maximo Integration Framework is included in the Maximo Asset Management 7.6environment. This framework is required to enable the integration betweenMaximo Asset Management and external applications. The Integration Frameworkincludes the OSLC capabilities and service providers that are used by the MaximoAnywhere apps to retrieve and process enterprise data.

OSLC is installed on the Maximo Asset Management administrative workstation aspart of the Maximo Anywhere package.

The following figure shows the system architecture of Maximo Anywhere andhighlights the relationship with key components in Maximo Asset Managementand MobileFirst.

© Copyright IBM Corp. 2013, 2016 1

Page 6: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Application Center

MobileFirst server

Mobile device

Maximo Anywhere

app

Local data store

Build EAR file

Native appsConsole

Login

module

Adapter

Maximo enterprise

application

OSLC service

provider

DataInstall

Runtime environment

Build environment

Maximo Anywhere build server

Adapter

Maximo Anywhere project

App

Data

Build and deploy

Maximo

administrative

workstation

Maximo database

MobileFirst

database

MobileFirst

The following required components must be deployed to the Maximo AssetManagement environment to support the Maximo Anywhere apps:

Maximo Integration Framework 7.5.1.2This framework is required to enable the integration between MaximoAsset Management and external applications. The Integration Frameworkincludes the OSLC capabilities and service providers that are used by theMaximo Anywhere apps to retrieve and process enterprise data. ForMaximo Asset Management 7.5 environments, you must install theIntegration Framework manually. Maximo Asset Management 7.6environments include the Integration Framework.

IBM OSLC Content package 7.6.0OSLC resources define the metadata for business objects of OSLC serviceproviders. The OSLC resources are used by the mobile apps to retrieve andprocess application data from the service providers in Maximo AssetManagement.

Maximo Anywhere Enablement 7.6.0The enablement package includes application files, license enablement files,

Figure 1. Maximo Anywhere system architecture and components

2 Planning, installation, and deployment

Page 7: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

and cron task automation. The enablement package also includes theAnywhere Administration application, which is deployed as part of theMaximoAnywhere project.

The following components are deployed when you implement Maximo Anywhere:

IBM Maximo AnywhereA collection of resources that are required for integration and deploymenton the MobileFirst platform. These resources include aMobileFirst-compatible project and an OSLC adapter. The OSLC adaptermanages communications between MobileFirst Server and the providerapplication, Maximo Asset Management. Before run time, the MaximoAnywhere project WAR, the applications, and the OSLC adapter must bedeployed to MobileFirst Server. The mobile apps can be configured, tested,and deployed to an emulator or a mobile device.

IBM MobileFirst™ Platform Server for MobileFirst Consumer EditionA runtime container for the OSLC adapter and server-based applicationcomponents. MobileFirst Server includes an administrative console and anapp store for publishing mobile apps within the organization. MobileFirstServer must be deployed to an application server. The same applicationserver can be used to deploy both Maximo Asset Management andMobileFirst Server.

Application CenterThe Application Center is an enterprise app store that you can use fordeploying the Maximo Anywhere apps to mobile devices in yourorganization. Application Center is automatically installed with MobileFirstServer. Application Center is composed of a server component, arepository, the Application Center console, and a mobile client app.v Server component:

The server component is a Java™ Enterprise application that must bedeployed in a web application server, such as WebSphere® ApplicationServer.The server component consists of an administration console and amobile client. The mobile client installs the apps that are available to theclient component.Several services compose the Application Center server component, suchas a service that lists the available apps, and a service that delivers theapp binary files to the mobile device.

v Repository:The repository stores the apps that can be installed on mobile devices.The repository is a database that also stores information, such asfeedback about the apps, and the amount of storage that an app uses.

v Application Center console:The Application Center console is a web application that is used tomanage the repository. You must have system administrator privileges toaccess the Application Center console.

v Mobile client:The mobile client runs on mobile devices and is used to install the appsthat reside in the repository.

IBM MobileFirst Platform Studio for MobileFirst Consumer Edition (Optional)An Eclipse-based integrated development environment that can bedeployed with Maximo Anywhere.

Chapter 1. Planning to deploy Maximo Anywhere 3

Page 8: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

MobileFirst Studio is installed as an Eclipse add-on by using a P2 Eclipseupdate. MobileFirst Studio is used to configure and test the MaximoAnywhere apps, and to manage the build and deployment process.

The following items are not included in the Maximo Anywhere product license.However, you can deploy these items to the Maximo Anywhere environment toextend and complement the capabilities that are available in the product itself.

Map servicesThe map view uses positioning data that is provided by Maximo AssetManagement. Maximo Asset Management can be configured to obtain thispositioning data from ArcGIS, an external geographic information system.You can also configure the map view to show a route and directionsbetween work order locations. To support this configuration, you musthave permissions from the map service provider, Esri.

Mobile Device ManagementYou can deploy IBM MaaS360 Mobile Device Management with MaximoAnywhere to complement the mobile app management capabilities thatMobileFirst provides. IBM MaaS360 Mobile Device Management providesmobile device management capabilities, including security management,for your mobile organization.

System requirements for Maximo Anywhere, MobileFirst Server, andMobileFirst Studio

Your environment must meet all of the software and hardware requirements forMaximo Anywhere, MobileFirst Server, and MobileFirst Studio.

A complete list of hardware and software requirements for your product isavailable in the Maximo Anywhere information in the System Requirementssection of the Maximo Asset Management wiki (www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/IBM%20Maximo%20Asset%20Management/page/Maximo%20Anywhere%20system%20requirements).

The MobileFirst system requirements are available in the IBM Support Portal(www.ibm.com/support/docview.wss?uid=swg27024838).

Administrative user rights are required for all computers that are used for theMaximo Anywhere 7.6.0 installation.

Enterprise system

Tivoli®'s process automation engine is the enterprise platform for productssuch as IBM Maximo Asset Management, IBM TRIRIGA® ApplicationPlatform, and Maximo industry solutions. The process automation engineand the supporting middleware together comprise the enterprise system.

Maximo Anywhere 7.6.0 must be installed with Maximo AssetManagement 7.5.0.6 or later, or version 7.6.

Maximo Integration Framework version 7.5.1.2 is also required and isincluded as an iFix for Maximo Asset Management 7.5.0.6 or later versions.If Maximo Asset Management 7.6 is installed, the correct version of theIntegration Framework might already be deployed. The installationprogram detects the required components if they are already installed.

4 Planning, installation, and deployment

Page 9: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

The Maximo Integration Framework component includes OSLC objectstructures that the enterprise system requires to support MaximoAnywhere. With OSLC integration, the enterprise applications can sharedata with Maximo Anywhere.

You can verify that the required components are installed by logging intoMaximo Asset Management and selecting Help > System Information.

Maximo Anywhere supports IBM Maximo Spatial Asset Management7.5.0.1 to provide positioning information that determines the location of awork order on a map. Maximo Spatial Asset Management is an optionalcomponent. If Maximo Spatial Asset Management is not in yourenvironment, positioning information is obtained by using non-linkedobjects.

Maximo Anywhere version 7.6.0

To configure, build, and deploy the Maximo Anywhere mobile apps, thefollowing prerequisite software must be installed.v The Oracle Java Development Kit (JDK) is a prerequisite for Android

development, and its subcomponent, the Java Runtime Environment(JRE), is required to run MobileFirst Studio.

v The Android SDK is required to build the Maximo Anywhere apps forAndroid mobile devices.

v To install mobile apps on iOS devices, a set of Apple-registered accountsis required so that you can build the iOS apps in your environment. Ifyou are installing Maximo Anywhere on a Mac OS X computer, youmust install the iOS development tools first.

v Xcode IDE is required to build the Maximo Anywhere apps so that theycan be deployed on iOS mobile devices.

v To set up an integrated development environment, you must installEclipse IDE for Java EE Developers and MobileFirst Studio.

v To preview the deployed applications in the MobileFirst Studio mobilebrowser simulater, you must install Google Chrome.

IBM MobileFirst Platform Server 6.3.0

MobileFirst Server is required to deploy Maximo Anywhere in aproduction environment.

You must deploy MobileFirst Server on a Windows, Linux, or AIX®

computer.

MobileFirst Server must be deployed to an application server. Theapplication server can be configured with a specific profile for MobileFirstServer.

If you plan to use Application Center to distribute Maximo Anywhere appsto iOS devices, you must configure the MobileFirst Server to listen throughSSL.

In a production environment, MobileFirst Server requires aproduction-grade database instance. You can configure an existing databaseserver for MobileFirst Server by creating a database instance or databaseschemas.

Application servers v IBM WebSphere Application Server Liberty

v IBM WebSphere Application Server

v Apache Tomcat

Chapter 1. Planning to deploy Maximo Anywhere 5

Page 10: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Databases v Apache Derby. Included in the installation image.

Apache Derby is supplied for evaluation and testing purposesonly and is not a production-grade database.

v IBM DB2®

v Oracle Database

v MySQL Database

For compatible products and versions, see the IBM MobileFirst PlatformFoundation 6.3.0 detailed system requirements (www.ibm.com/support/docview.wss?uid=swg27024838).

Restrictions:

v The Mac OS X operating system does not support MobileFirst Server. You caninstall MobileFirst Studio on a Mac OS X development environment, but youmust deploy MobileFirst Server to a computer with a different operating system.

v MobileFirst Server does not support Oracle WebLogic Server. If your enterpriseenvironment runs WebLogic Server, install one of the supported applicationservers to host MobileFirst Server.

v MobileFirst Server does not support Microsoft SQL Server.v IBM WebSphere Application Server and IBM WebSphere Application Server

Liberty do not support MySQL Database.

IBM MobileFirst Platform StudioYou must install Oracle JDK before you install MobileFirst Studio. TheOracle JDK includes the Java Runtime Environment (JRE), whichMobileFirst Studio requires to build the Maximo Anywhere applications.

To configure the mobile apps, install the required development tools incombination with MobileFirst Studio. For more information, see Installingan integrated development environment.

Mobile devices

The Maximo Anywhere mobile apps can be deployed to Android or iOSmobile devices. In a development environment, you can also test the appsin the MobileFirst Studio mobile browser simulator, the Android Emulator,or the iOS Simulator.

For a full list of operating systems and supported screen sizes, see theMaximo Anywhere system requirements (www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/IBM%20Maximo%20Asset%20Management/page/Maximo%20Anywhere%20system%20requirements).

Deployment topologiesA development environment is created by installing Maximo Anywhere andMobileFirst Studio on the same computer. A production environment is created byinstalling Maximo Anywhere and MobileFirst Server in a single-server ormultiple-server deployment.

Table 1: Supported application servers and databases.

6 Planning, installation, and deployment

Page 11: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

You use a development environment to configure and test the Maximo Anywheremobile apps before they are deployed to the production server. A test instance or adevelopment instance of Maximo Asset Management is required, either on thesame computer or on a remote computer.

You can set up a pre-production test environment or a small-scale productionenvironment on a single server. A single-server deployment features MaximoAnywhere and MobileFirst Server installed on the same computer. Apre-production instance of Maximo Asset Management is also required, either onthe same computer or on a remote computer. The pre-production instance ofMaximo Asset Management must closely match the production environment sothat the application configurations can be tested before you move to a productionenvironment.

For medium and large enterprises, creating a production environment involvesinstalling the components on more than one computer. MobileFirst Server mustfirst be deployed to an application server. A production instance of Maximo AssetManagement must be available on a different computer than the MaximoAnywhere and MobileFirst components.

MobileFirst Studio is an optional integrated development environment. If you wantto use MobileFirst Studio to test, configure, and build the Maximo Anywhereapplications, you must install it on the same computer as the Maximo Anywherecomponent.

The Maximo Anywhere computer functions as a build server from which theapplication build and deployment processes are run.

Cluster environments

To introduce high availability and scalability to your Maximo Anywheredeployment, you can set up a MobileFirst Server cluster environment. TheMobileFirst cluster can be integrated with a basic or advanced enterprise systemtopology.

You can create a cluster either by setting up multiple application server hostcomputers or by using multiple Java virtual machines (JVMs) that share theMobileFirst Server database instance. Each node of a MobileFirst Server clusterrequires a separate copy of the MobileFirst web application archive (WAR) projectfile.

If you plan to set up a clustered environment, configure the cluster before youinstall MobileFirst Server and Maximo Anywhere.

Hardware-based or software-based load balancers regulate the data activity acrossmultiple web servers. For more information, see the clustering information in theIBM MobileFirst Platform Foundation 6.3.0 IBM Knowledge Center.Related information:Optimizing system performance

Clustering of MobileFirst Server

Development environmentA development environment can be used to configure, test, and build the MaximoAnywhere mobile apps before they are deployed to a production environment.

Chapter 1. Planning to deploy Maximo Anywhere 7

Page 12: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

To create a development environment, you install MobileFirst Studio and MaximoAnywhere on a single computer. A test instance or a development instance ofMaximo Asset Management is also required, either on the same computer or on aremote computer.

Maximo Asset Management

MobileFirst Studio

Maximo Anywhere

Before you install MobileFirst Studio and Maximo Anywhere, you must install acollection of required components on the Maximo Asset Management computer.

MobileFirst Studio is an Eclipse-based integrated development environment. Youmust install MobileFirst Studio within an existing Eclipse client. Update yourEclipse environment by installing the development tools for the Android or iOSmobile platform.

Example: Creating an Android development environment

Dale is a system administrator who is responsible for implementing MaximoAnywhere in his enterprise. He wants to test and configure the Maximo Anywhereapps before he deploys them to the production environment. To do this, hedesignates one computer as a development environment.

Before Dale begins, he prepares the enterprise system to support MaximoAnywhere.

He creates a test instance or a development instance of Maximo Asset Managementand backs up the system.

On the computer where Maximo Asset Management is installed, he installs theMaximo Asset Management required components.

If using Maximo Asset Management 7.6, he runs the Configuration Tool to updatethe database and rebuild and redeploy the Maximo EAR files.

On a designated development computer, Dale installs Oracle JDK, Android SDK,and Eclipse. He then installs MobileFirst Studio as a P2 Eclipse update.

Dale starts the launchpad and installs Maximo Anywhere. During the installation,he selects Embedded Server within MobileFirst Studio.

When the installation is complete, Dale can configure and test the MaximoAnywhere mobile apps. He can build the apps and deploy them to the AndroidEmulator.

Single-server deployment of Maximo Anywhere andMobileFirst Server

For small enterprises, a single-server deployment can be used for productionpurposes. Larger enterprises can use a single-server deployment as apre-production test environment.

Figure 2. A Maximo Anywhere development environment

8 Planning, installation, and deployment

Page 13: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

To create a single-server deployment, you install MobileFirst Server and MaximoAnywhere on a single computer. A test instance or a production instance ofMaximo Asset Management is also required, either on the same computer or on aremote computer.

Maximo Asset Management

MobileFirst Server

Maximo Anywhere

You can configure an instance of WebSphere Application Server, WebSphereApplication Server Liberty, or Apache Tomcat for use with MobileFirst Server.

You can also configure an existing production database, such as DB2, OracleDatabase, or MySQL Database. MobileFirst Server includes a test database, ApacheDerby.

To configure the Maximo Anywhere applications for your organization, youmodify the properties files and the application definitions. You can build, deploy,and preview the mobile apps in the MobileFirst Operations Console. You can thendeploy the apps to the Application Center where mobile workers can downloadthem to a mobile device.

Example: Creating a single-server deployment

Ian is a system administrator who is responsible for implementing MaximoAnywhere in a small enterprise. He wants to create a small-scale productionenvironment.

Ian performs any necessary backup of the system and sets up a productioninstance of Maximo Asset Management.

He creates a production database instance on the Maximo database server.

He installs the required components on the computer where Maximo AssetManagement is installed.

If using Maximo Asset Management 7.6, he runs the Configuration Tool to updatethe database and rebuild and redeploy the Maximo EAR files.

On the same computer, he installs MobileFirst Server and uses the MobileFirstServer Configuration Tool to install the MobileFirst Server Administration Services.

Ian installs Maximo Anywhere and again uses the MobileFirst ServerConfiguration Tool to install the MobileFirst runtime environment.

When the configuration is complete, Ian can download the Maximo Anywhereapps from the Application Center and install them on a mobile device.

Figure 3. A single-server deployment of Maximo Anywhere and MobileFirst Server.

Chapter 1. Planning to deploy Maximo Anywhere 9

Page 14: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Multiple-server deployment of Maximo Anywhere andMobileFirst Server

A multiple-server deployment is suitable for medium and large enterprises and isdeployed by installing Maximo Anywhere and MobileFirst Server on separatecomputers. A production instance of Maximo Asset Management on a remotecomputer is also required.

If you use WebSphere Application Server as the enterprise application server, youcan create a new profile for MobileFirst Server. You must also create a databaseinstance or multiple database schemas on the enterprise database server.

The Maximo Anywhere build server is used to configure, build, and deploy theapps to MobileFirst Server. Mobile workers can then download the apps to theirmobile devices from the Application Center.

You can create a MobileFirst Server cluster and integrate it with a basic or anadvanced enterprise system topology. An enterprise system topology contains anOSLC provider cluster, which can consist of either multiple WebSphere ApplicationServer instances or multiple Oracle WebLogic Server instances.

Maximo Anywhere

apps

Firewall

Maximo Anywhere

build server

MobileFirst web server

load balancer

MobileFirst server

cluster

Application server

MobileFirst database

HTTP/HTTPS

HTTP/HTTPS

Web server load

balancer

OSLC provider

cluster

Application server

Maximo database

Enterprise system environment

The MobileFirst Server cluster supports only multiple instances of WebSphereApplication Server.

In an advanced enterprise system topology, you can isolate processes that requirethe use of an application server into separate clusters. For example, you can isolatethe user interface applications into one cluster and isolate cron tasks and reportingprocesses into other clusters.

Figure 4. A Maximo Anywhere multiple-server deployment (basic topology)

10 Planning, installation, and deployment

Page 15: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

The MobileFirst Server cluster and the OSLC provider cluster can be integrated inan advanced enterprise system topology.

Maximo

Anywhere

apps

Firewall

Maximo Anywhere

build server

MobileFirst

web server load

balancer

MobileFirst

server cluster

Application

server

HTTP/HTTPS

HTTP/HTTPSWeb server load

balancer

Enterprise system

environment

MobileFirst

database

Maximo

database

Reporting

database

OSLC provider

cluster

Application

server

User interface

cluster

Application

server

Integration

cluster

Application

server

Cron

cluster

Application

server

Reporting

cluster

Application

server

HTTP/HTTPS

Maximo Asset

Management

applications

Example: Creating a multiple-server deployment

Ian is a system administrator who is responsible for implementing MaximoAnywhere in a production environment.

Before he begins, he creates a database instance or multiple database schemas onthe production database server. MobileFirst Server can be configured to share theexisting database server with the enterprise system.

Ian installs or identifies an application server for use with MobileFirst Server. Forexample, he installs WebSphere Application Server Liberty or creates a newinstance of WebSphere Application Server.

Figure 5. A Maximo Anywhere multiple-server deployment (advanced topology)

Chapter 1. Planning to deploy Maximo Anywhere 11

Page 16: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

On the computer where Maximo Asset Management is installed, Ian starts thelaunchpad and installs the Maximo Asset Management required components.

If using Maximo Asset Management 7.6, he runs the Configuration Tool to updatethe database and rebuild and redeploy the Maximo EAR files.

On a designated host server computer, Ian starts the launchpad and installsMobileFirst Server. He starts the MobileFirst Server Configuration Tool and installsthe MobileFirst Server Administration Services.

On a separate computer, he starts the launchpad and installs Maximo Anywhere.During the installation, Ian specifies the host name of the MobileFirst Servercomputer.

When the installation is complete, Ian copies the MaximoAnywhere.war file from theMaximo Anywhere computer to the MobileFirst Server computer.

On the MobileFirst Server computer, Ian starts the MobileFirst ServerConfiguration Tool and adds a MobileFirst runtime environment.

When the configuration is complete, Ian can download the Maximo Anywhereapps from the Application Center and install them on a mobile device.Related tasks:Configuring the application serverRelated information:

Typical topologies of a MobileFirst instance

Clustering with Worklight Server

Installation overviewThe Maximo Anywhere installation involves preparing target computers andexisting middleware for installation, and installing key components for MaximoAnywhere and MobileFirst Server.

The Maximo Anywhere launchpad is a centralized interface where you can startthe installation programs. Maximo Anywhere and MobileFirst Server are installedby using IBM Installation Manager. Installation Manager is a tool that guides youthrough the installation of IBM products.

Before you install the product, you must extend the enterprise system to supportMaximo Anywhere.

Ensure that Maximo Asset Management 7.5.0.6 or later, or version 7.6 is installed.

On the Maximo Asset Management administrative workstation, start the MaximoAnywhere launchpad and install the required components to extend the enterprisesystem for Maximo Anywhere.

Before you install Maximo Anywhere and MobileFirst Server, ensure that yourenvironment contains an application server and a database instance.

If your enterprise environment runs IBM WebSphere Application Server, you cancreate a profile for MobileFirst Server.

12 Planning, installation, and deployment

Page 17: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

A cluster is created by implementing multiple host servers or by configuringmultiple JVMs. If you want to set up a MobileFirst cluster, do so before you installMobileFirst Server and Maximo Anywhere.

You must prepare the Maximo Anywhere environment by installing developmenttools. MobileFirst Studio is an optional component and can be installed as part ofthe Eclipse integrated development environment (IDE) workbench. For Androidapp development, the Android SDK and the Oracle JDK are both required to buildthe mobile apps. For iOS app development, XCode and Apple developer profilesare required on a Mac OS X computer.

Administrative user rights are required to install all of the components that aredelivered with Maximo Anywhere version 7.6.0. You must have root userauthorization for UNIX and Linux systems.

Required components

Maximo Asset Management requires a set of components to be deployed beforeMaximo Anywhere is installed. The Maximo Asset Management requiredcomponents include OSLC object structures and licenses to enable a set of extraapplications in Maximo Asset Management. Maximo Integration Framework mustalso be installed. The Service Address application is used with the map feature andthe Crews and Crew Types applications are used for labor reporting. TheAnywhere Administration application allows you to administer the MaximoAnywhere mobile apps from one central location.

Maximo Anywhere, MobileFirst Server, and MobileFirst Studio

Before you install Maximo Anywhere and the MobileFirst components, you mustinstall prerequisite software and configure the database server.

In most production environments, MobileFirst Server is installed on a differentcomputer than Maximo Anywhere. You must deploy MobileFirst Server to anapplication server before you install Maximo Anywhere. You can installMobileFirst Studio and Maximo Anywhere on the same target computer andstreamline the configuration and testing of the mobile apps before they aredeployed.

Silent installation

A silent installation is useful for installing Maximo Anywhere and MobileFirstServer in the following scenarios:v You are installing the components on a group of computers that are configured

in the same way.v You are installing the components on a production server that is behind a

firewall. The use of remote desktop access software can be restricted byfirewalls, so system administrators can be prevented from using the launchpadto install the components.

v You are installing the components on a computer that cannot display an Eclipseuser interface.

Silent installation eliminates the need to use the graphical user interface (GUI) ofthe installation program to collect installation data. You can run a silent installationof Maximo Anywhere, MobileFirst Server, and Installation Manager from acommand line.

Chapter 1. Planning to deploy Maximo Anywhere 13

Page 18: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Silent installations that are conducted with Installation Manager are defined by anXML response file. The response file can be used to install, update, and uninstallproducts.

You can use the Installation Manager GUI to record installation preferences andactions in a response file. By default, a response file is not recorded, so you mustenable the recording by setting the record environment variable to true before youstart the launchpad.

Installation planning worksheetUse the planning worksheet to record the information that you need during theinstallation process, such as system settings, properties, and user names.

Variable Default value Example value Your value

Maximo Anywhereinstallation directory

Windows: C:\IBM\Anywhere

UNIX and Linux:opt/ibm/Anywhere

MobileFirst ServerAdministration protocol

On Windows: http

On Mac OS X: https

MobileFirst ServerAdministration host name

hostname.yourdomain.com or1.234.567.89 or localhost

MobileFirst ServerAdministration port(Stand-alone server)

9080

MobileFirst ServerAdministration port(Embedded server)

10080

MobileFirst ServerAdministration context root

wladmin

MobileFirst ServerAdministration runtimecontext root

MaximoAnywhere

MobileFirst ServerAdministration user name

MobileFirst ServerAdministration password

Application Center protocol On Windows: http

On Mac OS X: https

Application Center hostname

hostname.yourdomain.com or1.234.567.89 or localhost

Application Center port On Windows, UNIX, andLinux: 9080

On Mac OS X: none

Application Center contextroot

applicationcenter

Application Center username

appcenteradmin

14 Planning, installation, and deployment

Page 19: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Variable Default value Example value Your value

Application Centerpassword

Android platform directory C:\Users\Administrator\Downloads\android-sdk_r22.6.2-windows\android-sdk-windows\platforms\android-19

Oracle JDK directory Windows: C:\ProgramFiles\Java

UNIX and Linux:/usr/java

Maximo Server protocol http

Maximo Server host name hostname.yourdomain.com or1.234.567.89 or localhost

Maximo Server port

Maximo Server context root maximo

Related reference:Installation program log files

Installation checklist for Maximo AnywhereYou can use the checklist to ensure that all installation steps completedsuccessfully. Print this topic and check each task as you complete it. To access thelinks, you must have an internet connection.

Preparing for installation

Done Task

Ensure that your environment meets all ofthe software and hardware requirements forMaximo Anywhere and IBM MobileFirstPlatform Foundation.

To build mobile apps for Windows devices,you must use a Windows computer. To buildmobile apps for iOS devices, you must use aMac OS X computer. Prepare your buildenvironment by installing the requireddevelopment tools for your chosen platform.

Print the installation planning worksheetand use it during the installation.

Installing IBM Maximo Anywhere

Done Task

On the computer where Maximo AssetManagement 7.5.0.6 or 7.6 is installed,download the Maximo Anywhere productsoftware from IBM® Passport Advantage®

and install the Maximo Asset Managementrequired components.

Chapter 1. Planning to deploy Maximo Anywhere 15

Page 20: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Done Task

Create or identify a database instance to usewith MobileFirst Server.

Install or identify an application server touse with MobileFirst Server.

On a designated server computer, installMobileFirst Server.

Install the MobileFirst Server AdministrationServices by using the MobileFirst ServerConfiguration Tool.

On a designated build computer, prepare theMaximo Anywhere environment.

On the build computer, install MaximoAnywhere.

On the MobileFirst Server computer, add aMobileFirst runtime environment by usingthe configuration tool.

On the computer where Maximo Anywhereis installed, run the build all command. Ifyour computer is a Windows system, use thebuild.cmd file. If your computer is a UNIXor Linux system, use the build.sh file. Thisstep generates the distributable files for theMaximo Anywhere project and deploysthem to MobileFirst Server.

Install the Maximo Anywhere apps onmobile devices.

Optional: To create an integrateddevelopment environment, installMobileFirst Studio on the computer whereMaximo Anywhere is installed.

Configuring IBM Maximo Anywhere and Maximo AssetManagement

Done Task

Add users to the Maximo Anywheresecurity groups.

Enable Maximo Asset Managementapplications for maps and labor reporting.

Set up Maximo Asset Management toinclude the following data:

v Ensure that your user has an associatedlabor code.

v Ensure that your user has authorization toat least his own labor code.

v Ensure that your user has a default insertsite defined.

v Ensure that your user has a default timezone defined.

16 Planning, installation, and deployment

Page 21: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Verifying the installation

Done Task

Test the Maximo Anywhere apps on mobiledevices.

Chapter 1. Planning to deploy Maximo Anywhere 17

Page 22: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

18 Planning, installation, and deployment

Page 23: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Chapter 2. Installing the Maximo Anywhere components

After you plan your environment, you install Maximo Anywhere and MobileFirston one or more computers.

Installing the Maximo Asset Management required componentsYou extend Maximo Asset Management with components that include OSLC objectstructures and licenses that enable a set of applications.

Before you begin

Install Maximo Asset Management 7.5.0.6 or later, or version 7.6.

Procedure1. On the computer where Maximo Asset Management is installed, download the

Maximo Anywhere product software from IBM Passport Advantage® andextract the installation image to a local directory.

2. Start the launchpad by double-clicking the launchpad file. If your computer is a64-bit system, use the launchpad64 file.

3. On the Install IBM Maximo Asset Management Required Components pane,click Install. If you are using Maximo Asset Management 7.5.0.6 or later, youmust select the installation directory first.

4. Complete the installation wizard.5. If you are using Maximo Asset Management version 7.6, allow the IBM Tivoli

process automation engine configuration utility to start and select UpdateDatabase and Build and Deploy Application EAR Files to complete theconfiguration.

6. If you are using Maximo Asset Management 7.5.0.6 or later, change to thetpae_home\maximo\tools\maximo directory and run updatedb. Then, build anddeploy the Maximo EAR files.

7. Verify that the required components are installed by logging in to MaximoAsset Management and selecting Help > System Information. Ensure that IBMMaximo Integration Framework 7.5.1.2 or later is listed as one of the installedcomponents.

What to do next

If you plan to install Maximo Anywhere and MobileFirst Server on differentcomputers, copy the installation image to the target computers.Related information:

Building and deploying EAR files for basic configurations

Installing MobileFirst ServerThe installation program automatically creates a database instance for theMobileFirst Server environment. It also configures the application server that youassign to MobileFirst Server.

© Copyright IBM Corp. 2013, 2016 19

Page 24: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Before you begin

Before you install MobileFirst Server, consider whether to use the automatedmethod or to create a database instance manually. By using the manual method,you can also create database schemas on a single instance. After, you mustmanually configure the application server to add the databases that you created.

For more information about planning the creation of databases, see the IBMMobileFirst Platform Foundation IBM Knowledge Center (www.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.installconfig.doc/install_config/c_wlserver_plan_install.html).

Setting the Java heap size on the JVM for WebSphereApplication Server or WebSphere Application Server Liberty

To improve the performance of the MobileFirst Server, you must increase the javaheap size that is used by the Java virtual machine (JVM). You can set the Java heapsize for the application server by modifying the jvm.options file.

About this task

You can also modify the Java heap size for other types of application server.

You specify the minimum and maximum Java heap sizes as follows:v Minimum Java heap: -Xms<value in MB>mv Maximum Java heap: -Xmx<value in MB>m

By default, the WebSphere Application Server and WebSphere Application ServerLiberty are configured with the following JVM settings:-Xms4m-Xmx488m

You can override the default values by modifying the values in the jvm.optionsfile in the installation directory.

Procedure1. Stop the server by running the following command:

websphere_home\bin\server stop

2. Browse to the websphere_home\usr\servers\defaultServer\type directory andopen the jvm.options file for editing.

3. Specify the following values to set the Java heap size:-Xms128m-Xmx512m

4. Save and close the jvm.options file.5. Start the server by running the following command:

websphere_home\bin\server start

Installing MobileFirst Server by using the installation programIn a Maximo Anywhere deployment, MobileFirst Server includes three maincomponents: MobileFirst Server Administration Services, MobileFirst OperationsConsole, and Application Center. You must deploy MobileFirst Server to anapplication server.

20 Planning, installation, and deployment

Page 25: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Before you beginv Ensure that you installed the required components on the Maximo Asset

Management administrative workstation.v The installer for WebSphere Application Server Liberty is provided with

MobileFirst.v Ensure that your environment includes one of the application servers that

MobileFirst supports. For more information, see the system requirements forMaximo Anywhere, MobileFirst Server, and MobileFirst Studio.

v If you are using WebSphere Application Server in your enterprise environment,create a new profile for MobileFirst Server.

v To improve performance, set the Java heap size on the JVM for WebSphereApplication Server or WebSphere Application Server Liberty before you installMobileFirst Server.

About this task

To ensure that the launchpad program runs correctly, do not use any spaces in thedirectory path where the launchpad file is located.

During the installation, you might be required to exit the launchpad and restart thelaunchpad on a different computer.

When you start Installation Manager, you can check for the latest fix packs. YourIBM login credentials are required to access the fix pack download site.

Procedure1. Start the launchpad by double-clicking the launchpad file. If your computer is a

Windows system, use the launchpad64.exe file. If your computer is a UNIX orLinux system, use the launchpad.sh file.

2. On the Install IBM MobileFirst Server pane, click Install.3. On the MobileFirst Information pane, select Stand-alone MobileFirst Server

and complete the installation wizard.

What to do next

In certain circumstances, you might be required to restart the application server(www.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.installconfig.doc/admin/c_completing_the_installation.html).Related tasks:“Setting the Java heap size on the JVM for WebSphere Application Server orWebSphere Application Server Liberty” on page 20To improve the performance of the MobileFirst Server, you must increase the javaheap size that is used by the Java virtual machine (JVM). You can set the Java heapsize for the application server by modifying the jvm.options file.Related information:

Planning the creation of databases

Creating a profile for a WebSphere Application Server

Manually installing MobileFirst Server administration

Manually installing Application Center

Chapter 2. Installing the Maximo Anywhere components 21

Page 26: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Installing the MobileFirst Server Administration ServicesAfter MobileFirst Server is installed, you must install and configure theAdministration Services by using the MobileFirst Server Configuration Tool.

Before you begin

Verify that the Application Center Console is installed by entering the ApplicationCenter URL in a web browser. The default URL is: http://localhost:9080/appcenterconsole/login.html.

About this task

Use the planning worksheet to collect the values that you enter, so that they can beused later in the installation.

For more information about the tasks that can be completed by using theMobileFirst Server Configuration Tool, see the IBM MobileFirst PlatformFoundation 6.3.0 IBM Knowledge Center (www.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.installconfig.doc/install_config/t_wlconsole_install.html).

Procedure1. On the computer where MobileFirst Server is installed, start the Server

Configuration Tool.

Option Description

On Windows In the Start menu, click IBM MobileFirstPlatform Server 6.3 > Server ConfigurationTool.

On Linux In the desktop menu, click IBM MobileFirstPlatform Server 6.3 > Server ConfigurationTool.

On Mac OS X In the Finder, browse to themf_server_home/shortcuts/ directory anddouble-click the configuration-tool.sh file.

2. Select Create a MobileFirst Server Configuration.3. Specify a name for the configuration and click OK. For example, enter

MFAnywhereConfig.4. On the Configurations Details pane, record the context root value for the

MobileFirst Administration Services in the planning worksheet. Click Next. Thedefault context root value is /wladmin.

5. On the Console Settings pane, record the context root value for the MobileFirstOperations Console in the planning worksheet. The context root value can beused to log in to the MobileFirst Operations Console and administer theMaximo Anywhere apps after Maximo Anywhere is installed. The defaultcontext root value is /worklightconsole.

6. In the Database Properties window, specify the database properties that youselected during the MobileFirst Server installation.

7. In the Application Server Choice window, specify the Application Centerproperties that you selected during the MobileFirst Server installation. Recordthe user name and password values in the planning worksheet. The user nameand password are required to access the MobileFirst Administrative Services aspart of the Maximo Anywhere installation. Click Save and Deploy.

22 Planning, installation, and deployment

Page 27: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

8. Restart the application server.9. Verify that the MobileFirst Operations Console is installed by entering the

console URL in a web browser. The default URL is: http://localhost:9080/worklightconsole/login.html.

Preparing the Maximo Anywhere environmentBefore you can build and deploy the Maximo Anywhere apps, you must set up thecomputer on which Maximo Anywhere is installed.

About this task

To build the apps for iOS mobile devices, a Mac OS X computer with specificsoftware is required.

Procedure1. Prepare the environment for building the mobile apps:

Android Install the Android development tools.

iOS Install the iOS development tools.

Windows Install the Windows development tools

2. Install Maximo Anywhere.3. Create a MobileFirst runtime environment.4. Deploy the apps from the command line.5. Optional: Install an integrated development environment.

Installing the Android development toolsOracle JDK and Android SDK are required to build Android mobile apps.

About this task

If you install the integrated development environment, which includes MobileFirstStudio and Eclipse, you must also install the Android Development Tools (ADT)plug-in.

Procedure1. Install Oracle JDK version 7.0.

a. From the Oracle Java SE downloads page (www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html), download the JavaSE Development Kit for your operating system.

b. Run the executable file and proceed through the installation program.c. Set the JAVA_HOME environment variable and specify the path to the

directory where the JDK was installed:

Chapter 2. Installing the Maximo Anywhere components 23

Page 28: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Windows 1. Go to your computer's Advanced SystemSettings.

2. On the Advanced tab, click EnvironmentVariables.

3. Under System Variables, click New.

4. Specify JAVA_HOME as the variable nameand enter the path to the JDK installationdirectory as the variable value.

Environment variable values cannot beseparated by a space. If the Javainstallation directory contains a space inthe path name, specify the shortenedpath name. For example, on Windowsoperating systems, enterC:\Progra~1\Java\jdk1.7.0_55

5. Close all open windows.

6. Verify that the JAVA_HOME systemenvironment variable is defined byopening a new command prompt andrunning the following command:

SET JAVA_HOME

A value is returned such as:

JAVA_HOME=C:\Progra~1\Java\jdk1.7.x

Linux or UNIX 1. At a command line, run the followingcommand:

vi ~/.bash_profile

2. Set the variables by running thefollowing command and replacing thejava_path variable with the Java path thatyou specified:

export JAVA_HOME=java_pathexport PATH=$JAVA_HOME/bin:$PATH

3. Save and close the .bash profile, and runthe following command to apply thechanges:

source ~/.bash_profile

4. Verify that the JAVA_HOME systemenvironment variable is defined byopening a new command line andrunning the following command:

echo $JAVA_HOME

2. Install the Android SDK:a. Go to the Android developers' website (developer.android.com/sdk/

index.html) and click Other Download Options.b. In the SDK Tools Only section, download the SDK for your operating

system and extract the compressed file on your computer.c. Start the installation wizard.

24 Planning, installation, and deployment

Page 29: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

On Windows: From the extracted directory, run the SDKManager.exe file.

On Linux or OS X: Open a terminal and navigate to theandroid_home/tools/ directory, then run thefollowing command:

android sdk

d. Under Tools, select Android SDK Tools Revision 22 or later and the latestAndroid SDK build tools. Also select an Android package with an API of 19or greater and click Install Packages.

3. Optional: Install an integrated development environment.4. If you installed Eclipse in step 3, install the Android Development Tools (ADT)

plug-in:a. In Eclipse, select Help > Install New Software > Add.b. In the Add Repository window, specify the following URL in the Location

field: https://dl-ssl.google.com/android/eclipse/.c. In the Name field, specify Android Development Tools and click OK.d. On the Available Software pane, click Select All > Next > Next > Finish.e. Restart Eclipse and specify a workspace directory.f. Open the Eclipse Preferences window and specify the Android SDK path.

Click Apply > OK to apply the changes.g. On the Welcome to Android Development pane, select Use existing SDKs

and browse to the SDK directory. Click OK > Next > Finish.

Installing the iOS development toolsOracle JDK and Xcode are required to build iOS mobile apps. You use your AppleID to enroll in a developer program.

About this task

To build the app for iOS mobile devices, a Mac OS X computer is required.

You can enroll in the iOS Developer Program as an individual or a company inwhich an individual is a one-person team.

You can also enroll in the iOS Developer Enterprise Program as a company, whichauthorizes you to create proprietary in-house iOS apps. The procedure for settingup the iOS Developer Enterprise account might include extra steps.

The person who creates the team becomes the team agent who is the legal contactand administrator of the team and has all privileges and full access to MemberCenter and iTunes Connect. The team agent is required to complete steps 5-7. iOSdevelopers might require the assistance of the team agent to complete theprocedure.

You create provisioning profiles to manage the use of iOS apps that you develop.

A development provisioning profile regulates the development and testing of apps to aspecific number of devices. Development provisioning profiles for the apps mustcontain the IDs of the devices on which the app is installed. You can register moreiOS devices and add them to the provisioning profiles.

Chapter 2. Installing the Maximo Anywhere components 25

Page 30: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

A distribution provisioning profile provides access to the app store from all of thedevices in your enterprise. However, Maximo Anywhere supports only one globalapp ID for a distribution provisioning profile.

Procedure1. Install Oracle JDK version 7.0.

a. From the Oracle Java SE downloads page (www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html), download the JavaSE Development Kit for your operating system.

b. Run the executable file and complete the installation program.c. In a terminal, go to the home directory cd ~.d. Enter echo $JAVA_HOME.e. If the result is empty, enter sudo nano .bash_profile. This step requires

your system password.f. In the .bash_profile file window, enter export JAVA_HOME=$(/usr/libexec/

java_home), and save and close the file.g. To reload the terminal and read what you put in the files, enter source

~/.bash_profile.h. Enter echo $JAVA_HOME. Verify that the path is /Library/Java/

JavaVirtualMachines/jdk_version/Contents/Home.2. Create an Apple ID by registering as an Apple developer in the Apple

Registration Center (developer.apple.com/programs/register/).3. Download and install Xcode IDE, including the iOS SDK and Simulator, from

the Mac App Store (www.apple.com/osx/apps/app-store.html).4. Add your Apple ID to Xcode (developer.apple.com/library/ios/

documentation/IDEs/Conceptual/AppStoreDistributionTutorial/AddingYourAccounttoXcode/AddingYourAccounttoXcode.html).

5. If you are the team agent, in Xcode create the certificate(developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingCertificates/MaintainingCertificates.html)for the provisioning profile.v Create a developer certificate for a development provisioning profile.

Download the certificate and add it to the Keychain application(support.apple.com/kb/PH7297).

v Create a distribution certificate for a distribution provisioning profile.Download the certificate to your local environment.

6. Register the App IDs (developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html).Create a unique ID for each app that you support. The app ID that youspecify must be unique: Apple does not allow duplicate app IDs.The following table contains examples of bundle IDs that can be specified forthe Maximo Anywhere apps. Replace the company_name value with yourcompany name.

App name Example bundle ID

Asset Audit com.company_name.maximoanywhere.AssetAudit

Asset Data Manager com.company_name.maximoanywhere.AssetDataManager

Inspection com.company_name.maximoanywhere.Inspection

Issues and Returns com.company_name.maximoanywhere.IssuesReturns

26 Planning, installation, and deployment

Page 31: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

App name Example bundle ID

Physical Count com.company_name.maximoanywhere.PhysicalCount

Service Request com.company_name.maximoanywhere.ServiceRequest

Transfers and Receiving com.company_name.maximoanywhere.Transfers

Work Approval com.company_name.maximoanywhere.WorkApproval

Work Execution com.company_name.maximoanywhere.WorkExecution

To specify an identifier to represent a single app, click Explicit App ID andenter a unique ID for the app. Repeat this step for each app that you support.To specify a bundle ID that can represent all of the apps, click Wildcard AppID and enter a bundle ID that can represent all of the apps, such ascom.company_name.maximoanywhere*. This option creates a single provisioningprofile for all of the Maximo Anywhere apps.

7. From the maximoanywhere_home\MaximoAnywhere\apps\app_name directory, openthe application_descriptor.xml file and change the bundle ID strings tomatch the bundle IDs that you created.

8. Register the Device IDs in Member Center (developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html). You can locate the uniquedevice identifier (UDID) by connecting your device to the Mac OS X computerwhile Xcode or iTunes are running.

9. Create a provisioning profile.a. Create a distribution provisioning profile for each app by using Member

Center (developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html). When you generate a distribution provisioningprofile, you are not required to provide IDs of the devices.

b. Download the profile to your Mac OS X computer. Every time that theprovisioning profile is updated, you must download the profile to thebuild server.

c. Open the build.properties file, comment out the provisionprofileproperty, and add the profile identifier.

When you run the app build and deployment process, the provisioningprofiles are collected and stored in the iOS application archive file (IPA).

10. Run the following command:./build.sh clean all

Installing the Windows development toolsMicrosoft Visual Studio is required to build apps for Windows devices.

Before you beginv Ensure that your Windows computer is running a supported operating system.

For more information, see the System Requirements section of the Maximo AssetManagement wiki (www.ibm.com/developerworks/ community/wikis/home?lang=en#!/wiki/IBM%20Maximo%20Asset %20Management/page/Maximo%20Anywhere%20system%20requirements).

v Windows devices require Visual C++ redistributable packages, which must beinstalled if they are not already on the device.

Chapter 2. Installing the Maximo Anywhere components 27

Page 32: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

About this task

You must install either Visual Studio Express for Desktop or Visual Studio Expressfor Windows.

Restriction: Visual Studio Express for Web is not supported.

Procedure1. From the Visual Studio website (www.visualstudio.com/en-us/downloads/

download-visual-studio-vs.aspx), select a supported version of Visual StudioExpress and click Download.

2. Run the wdexpress_full.exe file.3. Complete the installation wizard.

Installing Maximo AnywhereThe Maximo Anywhere component contains the project and the mobile apps.

Before you beginv Ensure that the required components are installed on the computer where

Maximo Asset Management is installed.v If you are installing a production environment, ensure that MobileFirst Server is

installed.v For Mac OS X installations, ensure that the JAVA_HOME environment variable is

set.

About this task

To ensure that the launchpad program runs correctly, do not use any spaces in thedirectory path where the launchpad file is located.

During the installation, you must provide details about the type of server that isused in the deployment.

Restriction: The Maximo Anywhere launchpad program is not supported on MacOS X.

Procedure1. Start the launchpad.

Option Description

Windows, Linux, or UNIX Double-click the launchpad file. If yourcomputer is a Windows system, use thelaunchpad64.exe file. If your computer is aUNIX or Linux system, use the launchpad.shfile.

Mac OS X 1. From the Maximo Anywhere installationimage, open the Install > IM folder andexpand the installer.macOS compressedfile.

2. Ensure that the path to the Userinstexecutable file does not contain anyspaces or parentheses. Double-click theUserinst executable file.

28 Planning, installation, and deployment

Page 33: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

2. On the Install IBM Maximo Anywhere pane, click Install.3. If you deployed MobileFirst Server to a stand-alone application server, select

Stand-alone MobileFirst Server. If you are setting up an integrateddevelopment environment with MobileFirst Studio, select Embedded Serverwithin MobileFirst Studio and complete the installation wizard.

4. If you installed MobileFirst Server on a different computer, copy theMaximoAnywhere.war file to the MobileFirst Server computer.

Creating a MobileFirst runtime environmentAfter Maximo Anywhere is installed, you must set up and configure a MobileFirstruntime configuration by using the MobileFirst Server Configuration Tool.

About this task

Use the installation planning worksheet to record the values that you enter so thatthey can be used later in the installation.

Procedure1. On the computer where MobileFirst Server is installed, start the Server

Configuration Tool.

Option Description

On Windows In the Start menu, click IBM MobileFirstPlatform Server 6.3 > Server ConfigurationTool.

On Linux In the desktop menu, click IBM MobileFirstPlatform Server 6.3 > Server ConfigurationTool.

2. Select Add a MobileFirst runtime environment to a configuration and specifya name for the new runtime environment. For example, enter MaximoAnywhere.Use the scroll bar to see the MobileFirst project configuration.

3. On the MobileFirst runtime environment pane, browse to theMaximoAnywhere.war file that was generated on the Maximo Anywherecomputer. Specify the MobileFirst project context root and click Next. Thisvalue must match the runtime context root that you specified during theMaximo Anywhere installation.

4. Specify the database settings in the subsequent panes and click Save andDeploy. After the runtime configuration is saved, you can redeploy theMaximoAnywhere.war file at any time by selecting it in the MobileFirst ServerConfiguration Tool.

5. Restart MobileFirst Server.6. On the computer where Maximo Anywhere is installed, run the build all

command. If your computer is a Windows system, use the build.cmd file. Ifyour computer is a UNIX or Linux system, use the build.sh file. This stepgenerates the distributable files for the project and deploys them to MobileFirstServer.

Chapter 2. Installing the Maximo Anywhere components 29

Page 34: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Results

After the deployment is complete, the MaximoAnywhere project and apps areavailable in the MobileFirst Operations Console and the Application CenterConsole.

Installing an integrated development environmentTo create a development environment, you must install a set of development toolson the build computer. You can use an integrated development environment to testand configure mobile apps before you deploy them to mobile devices.

Before you beginv Ensure that you installed the development tools for the mobile device platform.v To preview the apps in the MobileFirst Studio mobile browser simulator, install

Google Chrome.

About this task

MobileFirst Studio is an Eclipse-based development environment that can be usedto configure the Maximo Anywhere apps. You install MobileFirst Studio from theEclipse integrated development environment (IDE) workbench. A set of platformdevelopment tools are also required to build and deploy the mobile apps.

You can use the mobile browser simulator, the Android Emulator, or the iOSSimulator to view and test the mobile apps.

You can customize the mobile apps when they are deployed. For more information,see the Configuring Maximo Anywhere mobile apps section of the IBM KnowledgeCenter.

Procedure1. Install Eclipse IDE:

a. Go to www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/keplersr1 and download Eclipse IDE for Java EE Developersversion 4.3.2 (Kepler) for your operating system.

b. Extract the compressed folder and run the Eclipse application to install thesoftware.

2. Set up your Eclipse development environment:a. Check whether the Eclipse JSDT plug-in is installed. The JavaScript

Development Tool (JSDT) plug-in helps you navigate through the JavaScript code in Eclipse.1) Select Help > About Eclipse and click Eclipse Web Tools Platform

(WTP)

2) Browse for Eclipse JavaScript Development Tools in the About EclipseFeatures window.

b. If the JavaScript Development Tools plug-in is not already installed,complete the following steps:1) Select Help > Install New Software > Add.2) In the Add Repository window, specify the following URL in the

Location field: http://download.eclipse.org/webtools/repository/kepler.

3) In the Name field, specify Eclipse WTP.

30 Planning, installation, and deployment

Page 35: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

4) Select Web Tools Platform (WTP) 3.5.1 (or later) > JavaScriptDevelopment Tools and install the plug-in.

c. Set Google Chrome as the default web browser by selecting Window >Preferences > General > Web Browser > Use external web browser. Selectthe Chrome check box and click OK to apply your changes.

3. Install MobileFirst Studio Consumer Edition:a. In Eclipse, select Help > Install New Software > Add.b. In the Add Repository window, click Archive.c. Browse to the MobileFirstStudio.zip file in the Install directory of the

Maximo Anywhere installation image and click Open > OK.d. On the Available Software pane, select IBM Worklight Studio Development

Tools and click Next > Next > Finish.e. Restart Eclipse to apply the changes.

4. Import the MaximoAnywhere project into MobileFirst Studio.a. In Eclipse, click File > Import > General, select Existing Projects into

Workspace and click Next.b. Click Select root directory and specify the path to \ibm\Anywhere.c. Select the MaximoAnywhere project and click Copy projects into workspace.

Click Finish.d. In the Project Explorer pane, expand all nodes. Right-click the

OSLCGenericAdapter folder and select Run As > Deploy Worklight Adapter.e. Right-click the application folder and click Run As > Run on Worklight

Development Server.f. To preview the app, right-click the application folder and click Run As >

Preview.

Silent mode: Installing Maximo AnywhereYou can run a silent installation of Maximo Anywhere, MobileFirst Server, andInstallation Manager from a command line. Silent installations that are conductedwith Installation Manager are defined by an XML response file.

Recording a response file for silent installationA response file collects data and records the selections that you make when youuse the Installation Manager. If you want to run a silent installation, you mustrecord the installation settings.

About this task

When you use the Installation Manager to install the components, an XMLresponse file can be recorded. The response file can be used for future silentinstallations of Maximo Anywhere and MobileFirst Server. Once your system is setup to record a response file, the response file is overwritten with each subsequentuse of the installation program.

To record a response file, set the record environment variable to true before youstart the launchpad. Alternatively, if you want to run the installation program froma command line, use the -record parameter.

Chapter 2. Installing the Maximo Anywhere components 31

Page 36: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Procedure1. Open a command line and run the following command:

On Windows set record=true

On UNIX or Linux export record=true

2. Start the Maximo Anywhere launchpad and proceed with the installation.3. Click Finish. A response file is generated in the user home directory. The

response file is marked with a time stamp, for example,tpaeInstallerRsp20130716105150.xml.

Installing the required components in silent modeFor Maximo Asset Management 7.5.0.6 or later, the required components can beinstalled silently by running an executable file on the computer where MaximoAsset Management is installed. In a Maximo Asset Management 7.6 environment,you use Installation Manager to install the required components in silent mode.

About this task

The process automation engine executable file is called install.exe orinstall.bin. You reuse this file to install the Maximo Anywhere components.

Procedure

Maximo Asset Management version 7.5.0.6 or later:

1. From the Install directory of the Maximo Anywhere installation image, copythe Payload.zip folder to the directory where the install.exe or install.binis stored. The default directory is C:\IBM\SMP\madt on Windows or/opt/IBM/SMP/madt on UNIX or Linux systems.

2. From the samples folder of the Maximo Anywhere installation image, copy theresponse_install_Anywhere_Enablement.xml file to a local directory.

3. Verify that the response file contains the Maximo Asset Managementinstallation directory. The default value is C:\\IBM\\SMP on Windows or/opt/IBM/SMP on UNIX and Linux.

4. Change to the directory where the installation executable file is stored and runthe following command:

Windows install.exe -f response file path andname

For example, run the following command:

install.exe -f C:\temp\response_install_Anywhere_Enablement.xml

UNIX or Linux ./install.bin -f response file path andname

For example, run the following command:

./install.bin -f /temp/response_install_Anywhere_Enablement.xml

Maximo Asset Management version 7.6 or later:5. Open the response file for editing and modify the values for your operating

system. Ensure that the value for the repository location is correct.

32 Planning, installation, and deployment

Page 37: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

6. Change directory to the tools directory where Installation Manager wasinstalled and run the following command:imcl -input responsefilename -log logfilename -acceptLicense

Specify the path and name of the existing response file and log file that youwant to use. The -acceptLicense parameter is used to accept the licenseautomatically. For example, on Windows, run the following command:imcl -input C:\tmp\response_install_Anywhere_Enablement.xml-log C:\tmp\silent_install_log.xml -acceptLicense

Related information:Silent installation properties

Installing Installation Manager in silent modeInstallation Manager is the tool that is used to install Maximo Anywhere andMobileFirst Server. Installation Manager can itself be installed in silent mode.

About this task

The Installation Manager folder includes the silent-install.ini initialization file,which contains default parameters and values that are required for silentinstallation. You can use the initialization file to set the values for the silentinstallation process. A range of parameters can be modified in thesilent-install.ini file.

Procedure1. Browse to the Install\IM folder of the Maximo Anywhere installation image

and copy the Installation Manager folder for your system to a local directory.For example, copy the installer.win64 if your computer is running aWindows 64-bit operating system.

2. Optional: To modify the installation parameters, edit the silent-install.inifile.

3. From a command line, change to the directory where you copied theInstallation Manager folder and run one of the following commands. Specifythe path and the name of the log file that you want to create:

Windows installc.exe –-launcher.inisilent-install.ini -loglogfilename-acceptLicense

UNIX or Linux ./installc --launcher.inisilent-install.ini -loglogfilename-acceptLicense

For example, run the following command for Windows:installc.exe –-launcher.ini silent-install.ini -log C:\tmp\silent_install_log.xml -acceptLicense

Related information:

Install Installation Manager silently

Parameters for silent mode installationYou can modify the silent-install.ini initialization file by updating theparameters for your environment.

Chapter 2. Installing the Maximo Anywhere components 33

Page 38: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Parameter Description

-vm Specifies the Java launcher. In silent mode,always use java.exe on Windows, and javaon other operating systems.

-nosplash Suppresses the splash screen.

--launcher.suppressErrors Suppresses the JVM error dialog.

-silent Runs the Installation Manager program insilent mode.

-input Specifies that an XML response is used asthe input for the Installation Managerprogram.

-log Generates a log file that records the result ofthe silent installation. The log file is an XMLfile, for example, c:\mylogfile.xml or/root/mylogs/mylogfile.xml

Installing Maximo Anywhere in silent modeYou can generate a response file by completing a successful installation of MaximoAnywhere with the Installation Manager. Alternatively, you can use a sampleresponse file that is provided in the samples directory of the Maximo Anywherecompressed folder.

Before you begin

Installation Manager must be installed on the target computer.

Copy a generated response file or a sample response file with the necessarychanges to the target computer.

A sample response file is provided for your operating system in the samples folderof the Maximo Anywhere installation image.

For Windows installations, use the response_install_Maximo_Anywhere_Win.xmlresponse file.

For Mac OS X installations, use theresponse_install_Maximo_Anywhere_UnixMac.xml response file.

About this task

You can copy the Maximo Anywhere response file to multiple computers to runsilent installations. However, ensure that all values in the response file are valid forthe target system.

Procedure1. Open the response file for editing and modify the values for your operating

system. Ensure that the value for the repository location is correct.2. Change directory to the tools directory where Installation Manager was

installed and run the following command:imcl -input responsefilename -log logfilename -acceptLicense

34 Planning, installation, and deployment

Page 39: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Specify the path and name of the existing response file and log file that youwant to use. The -acceptLicense parameter is used to accept the licenseautomatically. For example, on Windows, run the following command:imcl -input C:\tmp\response_install_Maximo_Anywhere_Win.xml-log C:\tmp\silent_install_log.xml -acceptLicense

Setting up Maximo Asset Management for Maximo AnywhereYou must add users to the predefined Maximo Anywhere security groups andenable applications in Maximo Asset Management.

Adding users to the Maximo Anywhere security groupsWhen mobile workers manage records, they must have the authority to use theMaximo Anywhere mobile apps. You authorize access to the Maximo Anywhereapps by adding users to the predefined security groups in Maximo AssetManagement.

About this task

The user and group association are retrieved from Maximo Asset Managementduring authentication. If the user does not belong to the security group that isassociated with the app, login fails. For each app, this security control isimplemented in the application definition file. In this file, the requiredRoleattribute specifies the security group that is authorized to use the app.

By default, the Maximo Anywhere security groups do not include any users. Youmust add the relevant users, including predefined users such as MAXADMIN,before you deploy the associated apps.

Procedure1. In the Users application of Maximo Asset Management, create the user records

(www.ibm.com/support/knowledgecenter/SSLKT6_7.6.0/com.ibm.mbs.doc/user/t_add_users.html).

2. In the Security Groups application, select the Maximo Anywhere group(www.ibm.com/support/knowledgecenter/SSLKT6_7.6.0/com.ibm.mbs.doc/securgroup/t_assign_sites_security_groups.html) to which you want to add auser.

3. If your user is in a MAXADMIN group, clear the independent flag for thatsecurity group.

4. From the Users tab, click New Row.5. Select a user. The associated user information populates the other fields.6. Save your changes.

What to do next

The Maximo Anywhere security groups do not include authorizations for specificsites, labor, storerooms, or GL components. You must create separate securitygroups to implement security controls for these items.

Users of the Maximo Anywhere Work Execution app must have a labor record. If auser does not have a labor record, login fails.

Chapter 2. Installing the Maximo Anywhere components 35

Page 40: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Maximo Anywhere security groups in Maximo AssetManagement

Maximo Asset Management includes predefined security groups for the MaximoAnywhere apps. You use these security groups to grant authorization to use theMaximo Anywhere apps. The number of authorized users for each app mustcomply with the terms of the Maximo Anywhere product license.

App authorizations

The following security groups are included in the required components that aredeployed during installation to the Maximo Asset Management environment:

ANYWHERE_TECHNICIANGrants authorization to use the Maximo Anywhere Work Execution app.

ANYWHERE_APPROVERGrants authorization to use the Maximo Anywhere Work Approval app.

ANYWHERE_PHYSICAL_COUNTGrants authorization to use the Maximo Anywhere Physical Count app.

ANYWHERE_INSPECTORGrants authorization to use the Maximo Anywhere Inspection app.

ANYWHERE_ASSET_AUDITORGrants authorization to use the Maximo Anywhere Asset Audit app.

ANYWHERE_ASSET_MANAGERGrants authorization to use the Maximo Anywhere Asset Data Managerapp.

ANYWHERE_ISSUES_RETURNSGrants authorization to use the Maximo Anywhere Issues and Returns app.

ANYWHERE_SERVICE_REQUESTGrants authorization to use the Maximo Anywhere Service Request app.

ANYWHERE_TRANSFERSGrants authorization to use the Maximo Anywhere Transfers and Receivingapp.

These security groups are used to implement security at two levels:v Authorization to use the associated mobile app. This type of control is provided

by the app itself. Only users who belong to the associated security group can login to the app. If you remove a user from the associated security group,authorization is revoked the next time that the user logs in to the app throughthe server.

v Authorization to read, create, and update data for the OSLC resources that areused in the associated mobile app. This type of control is provided by theMaximo application that is registered with the object structure for the resource.The security group identifies the authorizing application for each object structureand specifies the application-level signature options that are required to providethe appropriate level of data access. Users who belong to the security groupautomatically have the appropriate level of access for all data operations in theassociated app.

By default, these security groups do not include any users. You must add therelevant users, including system users such as MAXADMIN, before you deploy theassociated apps.

36 Planning, installation, and deployment

Page 41: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

The Maximo Anywhere security groups do not include authorizations for specificsites, labor, storerooms, or GL components. You must create separate securitygroups to implement security controls for these items.

Product license compliance

The terms of your Maximo Anywhere license specify the number of users that areentitled to use each mobile app. To comply with the terms of your product license,the number of users in the Maximo Anywhere security groups must not exceed thenumber of users that are entitled to use the associated apps.

Enabling Maximo Asset Management applications for mapsand labor reporting

The Maximo Anywhere required components contain licenses for more MaximoAsset Management applications. You enable the Service Address application foruse with the map feature and the Crews and Crew Types applications are used forlabor reporting.

About this task

This procedure grants access to administrators to configure the features of theapplications.

Procedure1. In Maximo Asset Management, go to the Security Groups application and select

the group to which you want to grant access. For example, specify MAXADMIN.2. On the Applications tab, select Grant access for the applications that you want

to enable.3. Save the group.Related concepts:Map positioning information

Maximo Asset Management system options that affect mobileapps

The settings that you define in the Organizations application in Maximo AssetManagement apply to the relevant enterprise system applications and to theassociated mobile apps.

The options that affect the mobile apps are system-wide. You cannot define settingsthat are organization-specific or site-specific.

The following table specifies the options that affect the mobile apps. Configurableoptions are accessed from the Select Action menu in the Organizations applicationand are grouped by business object.

Option group Option description Example

Timer Options Automatically change thework order status fromApproved to In Progresswhen a user starts a labortimer.

If a work order is approved,the status automaticallychanges to In Progress whenyou start the timer.

Chapter 2. Installing the Maximo Anywhere components 37

Page 42: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Option group Option description Example

Automatically change thework order status toComplete when a user stopsa labor timer.

When you stop the timer fora labor transaction, the statusof the work order changes toComplete.

Labor Options Future labor transactiontolerance in hours. A labortransaction is not valid if itincludes a future start orstop time that exceeds thespecified tolerance.

You can specify the numberof hours in the future thatlabor transactions can beentered. You might want toenter time for future labor ifyou know that you are goingto perform a task but wantto report the time now.

Edit Rules Work order edit settings.Some fields do not apply tothe mobile apps, and areexcluded from the mobileapps or are read-only in themobile apps.

For each work order status,you can specify the types ofdata that can be edited. Forexample, if a work order isin Approved status, you canspecify that the asset fieldcan be edited.

Time zones

When mobile workers use mobile apps, the time zone at the server might bedifferent from their time zones. With the Users application in Maximo AssetManagement, you must specify the time zone in the user record for each mobileworker. The mobile apps use this information to calculate the difference betweenthe server time and the device time.

For example, in labor transactions, the start and end times are adjusted andreported accurately based on the time zone that is set in your user record. Settingthe time zone is important for these types of transactions, especially if you want toreport hours for labor that is to be done in the future.

Upgrading Maximo AnywhereTo upgrade Maximo Anywhere to version 7.6.0 you must upgrade the server,upgrade the development environment, and migrate the artifact configurations. Ifyou configured any build properties, you must re-enable them during the upgrade.

Procedure1. Upgrade the servers.

a. On the computer where Maximo Asset Management is installed, apply thelatest updates or fixes.

b. Upgrade MobileFirst Server (www.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.upgrade.doc/devenv/c_upgrade_to_srvr_in_production_env.html).

c. Upgrade Maximo Anywhere by using the launchpad.d. Test your environment by deploying Maximo Anywhere apps to MobileFirst

Server.2. Upgrade the development environment.

38 Planning, installation, and deployment

Page 43: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

a. Upgrade MobileFirst Studio (www.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.upgrade.doc/devenv/t_upgrade_studio.html).

b. Migrate your project to the updated version of MobileFirst Studio(www.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.upgrade.doc/devenv/c_upgrading_to_wl_studio_v610_migrating_projects.html).

3. Migrate the artifact configurations.a. Back up the new Maximo Anywhere version 7.6.0 app.xml file that you are

about to modify.b. Use a graphical file-comparison program to compare your modified 7.5.2

app.xml file to the 7.6.0 app.xml file.c. In the build.properties file and the worklight.properties file, ensure that

the options that you want enabled are set to true.d. Copy any additional JavaScript or XML files that you created in the old

environment to the new environment.4. After you upgrade to Maximo Anywhere 7.6.0, you must rerun the

anywhere-rdfs-puller.xml file.a. If you had any custom timeouts in the OSLCGenericAdapter.xml file, these

are overwritten by the update-platform command. Ensure that thefollowing properties are set to the correct values:<connectionTimeoutInMilliseconds>30000</connectionTimeoutInMilliseconds><socketTimeoutInMilliseconds>30000</socketTimeoutInMilliseconds>

b. If you added a lookup resource prior to upgrading to Maximo Anywhere7.6.0, ensure that a queryBase and a queryURI are specified or lookup datadownloads will fail. For example, add the following queryBase to yourresource under the <attributes> section:<queryBases id="additionalstoreroom_queryBases"><queryBase id="additionalstoreroom_queryBase_getlocationstoreroom"name="getlocationstoreroom" queryUri="/oslc/os/oslcopersroom"/></queryBases>

Ensure that your queryUri matches the URI of your OSLC resource.Related information:Importing OSLC resources to Maximo Anywhere

Application definition changes in version 7.6.0The following updates apply to the application definition file (app.xml) in thisrelease.

The application definition files for the apps are in the maximoanywhere_home\MaximoAnywhere\apps\app_name\artifact directory.v To show a numeric keyboard rather than an alphanumeric keyboard, you can

use <text> elements and set the enableNumericKeyboard attribute to true.v To dynamically switch images based on an attribute in an <image> element, you

can add cssClasses to <image> elements dynamically by using thecssAttribute. Image files can be placed into your local app directory, by settingthe platform="false" attribute on the <image> element.

v To change the position of a label, set the labelCss attribute in a <checkbox>element.

Chapter 2. Installing the Maximo Anywhere components 39

Page 44: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

All server-side resources must have a queryUri defined, in which the queryUripoints to the oslc URL that satisfies the data request. For example, specify thefollowing queryUri value:<resource .. <queryBases id="workOrder_queryBases"><!-- list of query bases the app will rely upon for this resource -->

<queryBase id="workOrder_queryBase_getMyAssignedWork"name="getMyAssignedWork"queryUri="/oslc/os/oslcwodetail?savedQuery=getMyAssignedWork"/>

If you do not specify a value, an error will state that a queryUri attribute for thisresource cannot be found.

40 Planning, installation, and deployment

Page 45: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Chapter 3. Building and deploying Maximo Anywhere apps

Before mobile users can download Maximo Anywhere apps, the apps must be builtand deployed to MobileFirst Server. This process occurs automatically for theprovided Maximo Anywhere apps during the installation of Maximo Anywhere. Ifyou change the configuration of these apps and are not using the AnywhereAdministration application, you must manually build and deploy the apps.

Application deployment process for Maximo Anywhere appsMaximo Anywhere apps are generated in the build server and then deployed tothe runtime environment, which includes MobileFirst Server.

On the build server, you use the adapter and application files to generate thedeployable files. You then deploy the project and the deployable files into theruntime environment. From MobileFirst Studio or the operating system commandline, you run commands or tasks to deploy the apps to MobileFirst Server.

The following figure shows the relationship between the build server and theruntime environment. It also shows how the project and files are deployed to theMobileFirst Server so that the apps are available for download to a mobile device.

The build server contains both the adapter and the applications. When yougenerate deployable files, the WAR file, the ADAPTER file, the WLAPP file, andthe APK, IPA, or APPX file are created. When you deploy the project and thesefiles to the runtime environment, which includes MobileFirst Server, theapplications and adapter are available for download to a mobile device.

© Copyright IBM Corp. 2013, 2016 41

Page 46: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

The deployable files are in either the maximoanywhere_home\MaximoAnywhere\bindirectory or the maximoanywhere_home\ MaximoAnywhere\apps\app_name\operating_system\native\bin directory:

WAR fileA web archive (WAR) file. Each Maximo Anywhere project includes twoWAR files. The WAR files are used to package distributable applicationfiles and related project resources and to deploy them to MobileFirstServer.

To support servlet version 3.0 and servlet version 2.4 application servers,there are two WAR files:v The MaximoAnywhere.war file for servlet version 3.0 application servers,

WebSphere Application Server 8, WebSphere Application Server 8.5,WebSphere Application Server Liberty, and Apache Tomcat

v The MaximoAnywhere2.4.war file for servlet version 2.4 application server:WebSphere Application Server 7

After you install Maximo Anywhere, both of these WAR files areautomatically updated with the host information. When you deploy eitherof the WAR files to the MobileFirst Server and run the build allcommand, the MaximoAnywhere.war file is updated with the MaximoAnywhere distributable application files and related project resources.

ADAPTER fileA MobileFirst adapter that is deployed to MobileFirst Server. This filecontains server code that does tasks such as retrieving data from a remotedatabase. Adapter code is accessed by MobileFirst applications through asimple invocation API.

WLAPP fileMetadata and web resources of a Maximo Anywhere app that is deployedto MobileFirst Server. MobileFirst Server uses this file to identify mobileapps.

APPX fileA Windows mobile binary file that is ready for deployment to a mobiledevice.

APK fileAn Android mobile binary file that is ready for deployment to a mobiledevice.

IPA fileAn iOS mobile binary file that is ready for deployment to a mobile device.

You can deploy apps from MobileFirst Studio or the operating system commandline.

MobileFirst StudioMobileFirst Studio includes the Mobile Browser Simulator for testing yourapps, but it does not include the Application Center for downloading yourapps.

WebSphere Application Server Liberty profile

A dynamic profile that restricts WebSphere Application Server to use onlythe features that are required by the applications that are deployed to theserver. This profile includes the Application Center for downloading appsto mobile devices. WebSphere Application Server Liberty does not supportclustered environments.

42 Planning, installation, and deployment

Page 47: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

WebSphere Application Server full profile

The full profile supports clustered environments and advancedconfigurations. WebSphere Application Server includes Application Centerfor downloading apps to mobile devices.

If you deploy apps from MobileFirst Studio, you run the adapter and appsdeployment tasks. The adapter and apps are deployed to MobileFirst Server andavailable for download.

With MobileFirst Studio, the Application Center is not available. You test yourapps by using either the Run as > Android Application menu option for Androidapps or the Run as > Xcode project for iOS apps.

For Windows apps, you test your apps by using the Run as > Visual StudioProject menu option within Visual Studio Windows Simulator.

If you deploy apps from the operating system command line, you also deploy aWAR file to MobileFirst Server. This WAR file is created during the MaximoAnywhere installation process. You deploy the WAR file with the MobileFirstServer Configuration tool. This WAR file contains properties that control theMaximo Anywhere app features, such as timeout values. Whenever you change theproperties of the apps, you need to redeploy the WAR file.

After you deploy the WAR file by using the MobileFirst Server Configuration Tool,you run the build all-deploy command. After the apps and the WAR file aredeployed to the server, mobile users can download the apps from the ApplicationCenter to their mobile devices.Related reference:“Properties files” on page 47The process for building and deploying apps requires input from configurableproperties files that belong to the application.“Maximo Anywhere directory structure” on page 48The Maximo Anywhere directory contains the files that are required to generateMaximo Anywhere apps. This directory includes predefined content for generatingmobile apps that integrate with provider applications in the enterprise system. Theapplication deployment process also generates a set of files.

Deploying Maximo Anywhere apps to MobileFirst ServerApps must be deployed to the server before they can be downloaded to mobiledevices. You can deploy apps from MobileFirst Studio or the operating systemcommand line.

Deploying apps from the command line to WebSphereApplication Server

You can deploy apps from the command line for environments that do not includeIBM MobileFirst Platform Studio but that do include one of the IBM WebSphereApplication Server profiles.

Before you beginv Install Maximo Anywhere.v Add users to the Maximo Anywhere security groups.

Chapter 3. Building and deploying apps 43

Page 48: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

v If you plan to preview the deployed apps in the MobileFirst Operations Console,Google Chrome must be installed on the IBM Maximo Anywhere build server.The preview function for the deployed apps does not support other webbrowsers.

v The IBM MobileFirst Platform Server instance and the Application Centerconsole must be running.

v Verify that the MobileFirst Server properties and the Application Centerproperties are correct for your environment.

Procedure1. Deploy the distributable files to the MobileFirst Server:

a. On the Maximo Anywhere build server, in the maximoanywhere_home\MaximoAnywhere directory, open the build.properties file.

b. Choose one of the following options for building the apps:

Option Action

To build all applications Run the build all command. This command is build.cmd onMicrosoft Windows, and build.sh on UNIX and Linuxsystems. The .apk, .ipa, or .appx artifact file is generated andall distributable files for the Maximo Anywhere project aredeployed to MobileFirst Server.

To build only someapplications

Specify a comma-separated list of apps. The possible valuesare AssetDataManager, Inspection, IssuesReturns,PhysicalCount, ServiceRequest, WorkApproval, AssetAudit,Transfers, and WorkExecution. For example, to build anddeploy the IBM Maximo Anywhere Inspection app and theIBM Maximo Anywhere Service Request app, run thefollowing command: appsToBuild=Inspection,ServiceRequest.

2. Verify deployment of the Maximo Anywhere apps in the MobileFirstOperations Console. In Google Chrome, open the MobileFirst OperationsConsole and select Preview as common resources for any Maximo Anywhereapp.

What to do nextv Install the Application Center mobile client on an Android mobile device or an

iOS mobile device so that you can download the Maximo Anywhere apps.For apps that run on Microsoft Windows 8.1 tablets, follow the instructions forinstalling a Windows Store application on a Windows device and follow theinstructions for licensing and installing the product keys.

v Add digital signatures to Maximo Anywhere apps.Related information:

Application Center setup information

Mobile client setup

Deploying apps by using MobileFirst StudioMobileFirst Studio includes an embedded instance of MobileFirst Server, whichmeans that you do not need to deploy the WAR file. MobileFirst Studio alsoincludes the Mobile Browser Simulator for testing your apps.

44 Planning, installation, and deployment

Page 49: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Before you beginv Set up Maximo Asset Management for Maximo Anywhere.v If you plan to preview the deployed apps in the Mobile Browser Simulator,

Google Chrome must be installed in the development environment. The previewfunction for deployed apps does not support other web browsers.

Procedure1. In MobileFirst Studio, import the Maximo Anywhere project.

a. Right-click inside the Project Explorer, and select Import. From the Importwindow, select Existing Projects into Workspace and click Next.

b. Browse to the maximoanywhere_home folder, select the MaximoAnywherefolder, select Copy projects into workspace, and click Finish.

2. Set the Ant file path.a. From the Window menu, select Preferences. Expand Ant and then select

Runtime.b. Select Ant Home Entry and click Ant Home.c. In the Browse for Folder window, expand maximoanywhere_home >

MaximoAnywhere > build > tools > ant and click OK.3. Add the build.xml file to the Ant view. Select the build.xml file from

MaximoAnywhere and drag the build.xml file to the Ant view.4. Expand the build.xml file in the Ant view and double-click the all task.5. From the Project Explorer, deploy the adapter.

a. Select MaximoAnywhere > Adapters and right-clickOSLCGenericAdapter.

b. Select Run As > Deploy MobileFirst Adapter.6. Build and deploy the Maximo Anywhere Asset Audit app.

a. Under MaximoAnywhere > apps, right-click AssetAudit.b. Select Run As > Run on MobileFirst Development Server.

7. Build and deploy the Maximo Anywhere Asset Data Manager app.a. Under MaximoAnywhere > apps, right-click AssetDataManager.b. Select Run As > Run on MobileFirst Development Server.

8. Build and deploy the Maximo Anywhere Inspection app.a. Under MaximoAnywhere > apps, right-click Inspection.b. Select Run As > Run on MobileFirst Development Server.

9. Build and deploy the Maximo Anywhere Issues and Returns app.a. Under MaximoAnywhere > apps, right-click IssuesReturns.b. Select Run As > Run on MobileFirst Development Server.

10. Build and deploy the Maximo Anywhere Physical Count app.a. Under MaximoAnywhere > apps, right-click PhysicalCount.b. Select Run As > Run on MobileFirst Development Server.

11. Build and deploy the Maximo Anywhere Service Request app.a. Under MaximoAnywhere > apps, right-click ServiceRequest.b. Select Run As > Run on MobileFirst Development Server.

12. Build and deploy the Maximo Anywhere Transfers and Receiving app.a. Under MaximoAnywhere > apps, right-click Transfers.b. Select Run As > Run on MobileFirst Development Server.

13. Build and deploy the Maximo Anywhere Work Approval app.

Chapter 3. Building and deploying apps 45

Page 50: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

a. Under MaximoAnywhere > apps, right-click WorkApproval.b. Select Run As > Run on MobileFirst Development Server.

14. Build and deploy the IBM Maximo Anywhere Work Execution app.a. Under MaximoAnywhere > apps, right-click WorkExecution.b. Select Run As > Run on MobileFirst Development Server.

15. Verify the application deployment in MobileFirst Operations Console byright-clicking the app and selecting Run As > Preview.

16. Test your app on your mobile device, Android emulator, or iOS Simulator. Totest the app on the Android emulator, you must first set up the emulator. Totest the app on a mobile device, connect that device to your computer.

Device type Steps

Android 1. In the Project Explorer, select theAndroid project that is under the appthat you are testing and select Run as >Android Application.

2. Select Launch a new Android VirtualDevice for the Android emulator orLaunch a new Android Device for anAndroid mobile device.

iOS 1. Under MaximoAnywhere > apps >app_name > iphone, select Run as >Xcode project.

2. From the Xcode window, choose thesimulated device or mobile device onwhich you want to test the app, andclick the Play icon.

Windows 1. Open Microsoft Visual Studio.

2. From the menu bar, select FILE > Open> Project/Solution.

3. From the MaximoAnywhere/apps/application_name/windows8/nativedirectory, select the *.jsproj file.

4. In Visual Studio, select the index.htmlfile, and then click Simulator to run thesimulator.

Related concepts:

Mobile browser simulator

iOS SimulatorRelated tasks:“Setting up the Android emulator” on page 52The Android emulator can show you what your Android apps look like and helpyou test app behavior.“Testing apps” on page 51After you deploy an app, you must verify that data is exchanged between theenterprise system database and the mobile application. You can use a mobiledevice, the Mobile Browser Simulator, an Android emulator, or the iOS Simulatorto test apps.

46 Planning, installation, and deployment

Page 51: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Properties filesThe process for building and deploying apps requires input from configurableproperties files that belong to the application.

You can configure the app by editing the configurable properties files, or, if it isenabled, the Anywhere Administration application. If you configure the app withthe Anywhere Administration application, those configuration changes haveprecedence over any configuration changes made to the configurable propertiesfiles.

worklight.propertiesContains application configuration properties:v MobileFirst Server database connectionv MobileFirst Server securityv Map service provider authenticationv Heartbeat intervalv Timeout and wait timesv Log line limitv Authentication methodv Maximo contextv Download and upload of attachmentsv Size of attachmentsv Location of base directory for attachments

build.properties

Contains information about the application definition location, the APIversion, and whether an app is deployed. The build.properties file alsocontains information about the OSLC adapter and the setting for enablingdata encryption.

This file also contains the properties for MobileFirst Server, the ApplicationCenter, and the WAR file. The build.properties file defines the instance ofMobileFirst Server to which the app is deployed.

During installation, the build.properties file is copied to themaximoanywhere_home\MaximoAnywhere directory and updated with valuesthat are provided to the installer. If you change the environment after youinstall Maximo Anywhere, the build.properties file is not automaticallyupdated. You might need to update the build.properties file in thefollowing situations:v If you change the enterprise server in your environment, you must

change the adapter.connection properties.v If you move the WAR file from its default location on the MobileFirst

Server computer, you must change the project.config.war.file.nameproperty in the build.properties file.

app-feature.propertiesContains information about the settings for features that you can enableduring the build process:v Maps are enabled with the map.enabled propertyv GPS is enabled with the gps.enabled propertyv Bar code scanning is enabled with the barcode.enabled propertyv Attachments are enabled with the attachments.enabled property

Chapter 3. Building and deploying apps 47

Page 52: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Maximo Anywhere directory structureThe Maximo Anywhere directory contains the files that are required to generateMaximo Anywhere apps. This directory includes predefined content for generatingmobile apps that integrate with provider applications in the enterprise system. Theapplication deployment process also generates a set of files.

The Maximo Anywhere directory includes the application definition file and a setof properties files.

File Description Path

app.xml Defines the user interface,data elements, and associatedbusiness rules for an app

maximoanywhere_home\MaximoAnywhere\apps\app_name\artifact

worklight.properties Contains configurationparameters for apps

maximoanywhere_home\MaximoAnywhere\server\conf

build.properties Contains the variable aspectsof the build process anddefines the target server towhich an app is deployed

maximoanywhere_home\MaximoAnywhere

app-feature.properties Contains variable aspects ofthe build process

maximoanywhere_home\MaximoAnywhere\apps\app_name

MaximoAnywhere.war Packages distributableapplication files and relatedproject resources and deploysthem to MobileFirst Server.

maximoanywhere_home\MaximoAnywhere\bin

The application deployment process generates another set of files. These files arecreated after you run the build all command from the command line or you runthe adapter and apps deployment tasks in MobileFirst Studio.

File Description Path

OSLCGenericAdapter.adapter Contains server adapter code maximoanywhere_home\MaximoAnywhere\bin

application_name.wlapp Contains server artifacts maximoanywhere_home\MaximoAnywhere\bin

application_name.apk

application_name.ipa

application_name.appx

Contains client artifacts maximoanywhere_home\MaximoAnywhere\bin

Configuring MySQL DatabaseExtra configuration might be required before you can load mobile app .apk files tothe MobileFirst Server when MySQL Database is used. With MySQL Database5.6.25, the .apk file must not be bigger than 10% of the innodb_log_file_size value.

Procedure1. Stop the WebSphere Application Server.2. Stop the MySQL service.

48 Planning, installation, and deployment

Page 53: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

3. Edit the C:\ProgramData\MySQL\MySQL Server 5.6\my.ini file in and update theinnodb_log_file_size value. For example, if the .apk file is 37 MB, theinnodb_log_file_size variable must have more than 370 MB plus the sum of allother variable length fields.

4. Start the MySQL service.5. Start WebSphere Application Server.

Adding digital signatures to Maximo Anywhere appsAndroid and iOS apps must be digitally signed to run on a device, to bedistributed for testing, or to be submitted to the store.

About this task

For Android apps, follow the instructions in the Android documentation forsigning Android APK files (developer.android.com/tools/publishing/app-signing.html).

For iOS apps, follow the instructions in the iOS documentation for maintainingyour signing identities and certificates (developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingCertificates/MaintainingCertificates.html).

For apps that run on Windows 8.1 tablets, certificates must be installed on thetablets as trusted certificates. IBM Maximo Anywhere provides default certificates,but these certificates are temporary and eventually must be replaced with acertificate that you create. The default certificates are in the windows8\nativedirectory on each app. Each certificate is named MaximoAnywhere_TemporaryKey.pfx.You can update the certificate at any time.1. From the mobilefirst_install_dir/ApplicationCenter/installer directory,

download and extract the IBMApplicationCenterWindowsStore.zip file on yourtablet.

2. Run IBMApplicationCenter.exe.3. Enter your product key. Microsoft product keys are required for sideloading

apps that are not published to Windows Store. The product keys must belicensed in Microsoft and installed on the mobile device operating system.

4. If you do not want to use a default certificate, create your own *.pfxcertificate. This process must be completed for each app individually:a. On your development workstation, open Visual Studio Tools and

double-click the *.jsproj file that is in the windows8/native directory.b. From the Solution Explorer, double-click the package.appxmanifest file, and

then click the Packaging tab.c. In the Choose Certificate dialog box, select one of the options for including

a *.pfx certificate, and click Save. The certificate is copied to thewindows8\native directory for the app.

5. Start the IBM MobileFirst Platform Application Center app, and connect to yourIBM MobileFirst Platform Server.

6. After your MobileFirst Server connects, download and install the MaximoAnywhere apps onto your tablet.

Related information:

IBM MobileFirst application authenticity overview

Chapter 3. Building and deploying apps 49

Page 54: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Deploying apps to a secure serverThe Secure Socket Layer protocol ensures secure transactions between servers andclients. The MobileFirst platform supports SSL between MobileFirst Server and theenterprise server. In Maximo Anywhere, the enterprise server is the Maximo server.

To protect the communication between a MobileFirst Server and the enterprisesystem, configure SSL for MobileFirst adapters and back-end servers.

To protect the communication between the client apps and the MobileFirst Server,configure SSL.

Installing Maximo Anywhere apps on mobile devicesFor Android and iOS devices, you install the Maximo Anywhere applications usingthe Application Center console through an internet browser. For Windows devices,the Application Center mobile client must be installed before the apps can beinstalled.

The Application Center console is a web application for managing the repository ofmobile apps. The Application Center mobile client is a secure catalog of availablemobile apps. You must log in to the Application Center console to download themobile client to your devices.

If you are using IBM MobileFirst Platform Studio, the Application Center is notavailable. Instead, under MaximoAnywhere > apps, right-click the app and selectRun As > Run on device.

For Android apps, follow the instructions in the MobileFirst documentation forinstalling the client on an Android mobile device.

For Android apps, follow the instructions for building and running from thecommand line on the Android developers website.

For iOS apps, follow the instructions in the MobileFirst documentation forinstalling the client on an iOS mobile device.

For apps that run on Microsoft Windows 8.1 tablets, follow the instructions forinstalling a Windows Store application on a Windows device and follow theinstructions for licensing and installing the product keys.Related concepts:

The Application Center mobile clientRelated tasks:

Adding an app to the Application CenterRelated information:

System platform requirements

Installing Maximo Anywhere apps on Windows devicesTo install the apps on Windows devices, you must install the Application Centermobile client. The Application Center mobile client is a secure catalog of availablemobile apps.

50 Planning, installation, and deployment

Page 55: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

About this task

You can install Maximo Anywhere mobile apps on Windows 8.1 tablets (64-bit andexcluding RT).

Certificates are used to sign the apps. The certificates must be installed on themobile devices as trusted certificates. Maximo Anywhere provides defaultcertificates. The default certificates are in the windows8\native directory for eachapp. Each certificate is called MaximoAnywhere_TemporaryKey.pfx. This certificate istemporary and must be replaced with your own certificate.

Procedure1. From the mobilefirst_install_dir/ApplicationCenter/installer directory,

download the IBMApplicationCenterWindowsStore.zip file to your Windowsdevice.

2. Extract the IBMApplicationCenterWindowsStore.zip file, and runIBMApplicationCenter.exe.

3. Enter the Microsoft Windows product key. Product keys are required forsideloading apps that are not published in the Windows Store. The productkeys must be licensed through Microsoft and installed on the mobile deviceoperating system. For more information, see: https://msdn.microsoft.com/en-us/library/windows/apps/dn832613.aspx.

4. Replace the temporary certificate with your own certificate.a. In Visual Studio Tools, open the app by double-clicking the *.jsprojfile

that is in the windows8\native directory.b. From Solution Explorer, select the package.appxmanifest file and click the

Packaging tab.c. In the Choose Certificate window, select one of the options for including a

*.pfx certificate. The certificate is copied to the windows8\native directoryfor the app.

d. Click Save.e. Repeat this process for each Maximo Anywhere app.

5. Start the Application Center app. Connect to your MobileFirst Server anddownload and install the Maximo Anywhere apps.

Testing appsAfter you deploy an app, you must verify that data is exchanged between theenterprise system database and the mobile application. You can use a mobiledevice, the Mobile Browser Simulator, an Android emulator, or the iOS Simulatorto test apps.

About this task

Mobile device

A mobile device is the most accurate way to test apps. To test your appson a mobile device, you install the Application Center client on the mobiledevice and download the apps that you want to test.

Mobile browser simulator

In the Mobile Browser Simulator of MobileFirst Studio, you can test yourapps on many different types of devices. The Mobile Browser Simulatorcontains settings that you can use to duplicate the look of your devices. To

Chapter 3. Building and deploying apps 51

Page 56: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

view the apps in the Mobile Browser Simulator in MobileFirst Studio, youmust configure the web browser view to use Google Chrome as theexternal web browser.

Android emulator

To test your Android apps on your workstation rather than on a mobiledevice, you can use the emulator. The emulator is not as accurate arepresentation as a mobile device. The Android emulator requires that youdownload the APK file from the Application Center unless you areworking with MobileFirst Studio.

iOS Simulator

To test your iOS apps on your workstation instead of on a mobile device,you can use the iOS Simulator. The iOS Simulator is not as accurate arepresentation as a mobile device.

Visual Studio Windows Simulator

To test your Windows apps on your workstation instead of on a mobiledevice, you can use the Windows Simulator. The Windows Simulator is notas accurate a representation as a mobile device.

Procedure1. Log in to a Maximo Anywhere app and search for a known work order.2. In a Maximo Asset Management application, such as Work Order Tracking, use

the same search criteria.3. Compare the results to ensure that they are the same.Related concepts:

Mobile browser simulator

iOS Simulator

Visual Studio Windows Simulator

Setting up the Android emulatorThe Android emulator can show you what your Android apps look like and helpyou test app behavior.

Before you beginv Install the Oracle Java Development Kit.v Install the Android Software Development Kit.

If you are testing a new instance of a previously deployed application, clear thebrowser cache. In Google Chrome, go to Settings > Apps, and select the appwhose data you want to clear. Click Clear Data.

Procedure1. From the AndroidSDK\adt-bundle-windows-x86_64\eclipse directory, run the

SDK Manager.exe file.2. In the SDK Manager, select Tools > AVD Manager and click New.3. In the CPU/ABI field, select Intel Atm (x86).4. Select the Hardware keyboard present check box and the Display a skin with

hardware controls check box.5. For SD Card Size, enter 1 GB and click OK.

52 Planning, installation, and deployment

Page 57: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

6. Select your Android Virtual Device (AVD) and click Start.7. Install the Application Center mobile client on the emulator.

a. From a browser, enter the following URL: http://hostname:portnumber/appcenterconsole/installers.html where hostname is the address of theserver and portnumber is the number of the port where the ApplicationCenter is installed.

b. Enter your user name and password.c. Click IBM App Center and Install Now.d. On the Notification tab, select the downloaded APK file.e. At the prompt, scroll to the bottom of the window and click Install.

8. Start the Application Center and download the apps that you want to test onyour emulator.

Chapter 3. Building and deploying apps 53

Page 58: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

54 Planning, installation, and deployment

Page 59: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Chapter 4. Uninstalling Maximo Anywhere, MobileFirst Server,and MobileFirst Studio

You use Installation Manager to uninstall Maximo Anywhere, the mobile apps, andMobileFirst Server. If MobileFirst Studio is installed, you uninstall it from theEclipse client.

Procedure1. To uninstall Maximo Anywhere, the mobile apps, and MobileFirst Server:

Option Description

On Windows 1. Click Start > All programs > IBMInstallation Manager.

2. Start the IBM Installation Managerprogram and click Uninstall.

3. Select the packages that you want touninstall and complete the wizard.

On Mac OS X 1. In the /Users/administrator directory,open the file Maximo_install.location.

2. Record the IM_install_dir property. Forexample, /Users/administrator/IBM/anywhereinstall/eclipse=IM_install_dir.

3. Change directory to the IM_install_dirdirectory and start Installation Manager.

4. Select Uninstall and select the packagethat you want to uninstall.

5. Complete the uninstallation wizard.

2. To uninstall MobileFirst Studio:a. In Eclipse, click Help > About Eclipse > Installation Details.b. From the Installed Software tab, select the items that you want to uninstall

and complete the wizard.3. To remove the MaximoAnywhere project:

a. In Eclipse, from the Project Explorer window, right-click theMaximoAnywhere project.

b. Select Delete.c. Select Delete project contents on disk and click OK.

© Copyright IBM Corp. 2013, 2016 55

Page 60: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

56 Planning, installation, and deployment

Page 61: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Notices

This information was developed for products and services offered in the US. Thismaterial might be available from IBM in other languages. However, you may berequired to own a copy of the product or product version in that language in orderto access it.

IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not grant youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle Drive, MD-NC119Armonk, NY 10504-1785US

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

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japan

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer ofexpress or implied warranties in certain transactions, therefore, this statement maynot apply to you.

This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Any references in this information to non-IBM websites are provided forconvenience only and do not in any manner serve as an endorsement of those

© Copyright IBM Corp. 2013, 2016 57

Page 62: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

websites. The materials at those websites are not part of the materials for this IBMproduct and use of those websites is at your own risk.

IBM may use or distribute any of the information you provide in any way itbelieves appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:

IBM Director of LicensingIBM CorporationNorth Castle Drive, MD-NC119Armonk, NY 10504-1785US

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 materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

The performance data and client examples cited are presented for illustrativepurposes only. Actual performance results may vary depending on specificconfigurations and operating conditions.

Information concerning non-IBM products was obtained from the suppliers ofthose products, their published announcements or other publicly available sources.IBM has not tested those products and cannot confirm the accuracy ofperformance, compatibility or any other claims related to non-IBM products.Questions on the capabilities of non-IBM products should be addressed to thesuppliers of those products.

This information is for planning purposes only. The information herein is subject tochange before the products described become available.

This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to actual people or business enterprises is entirelycoincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, whichillustrate programming techniques on various operating platforms. You may copy,modify, and distribute these sample programs in any form without payment toIBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operatingplatform for which the sample programs are written. These examples have notbeen thoroughly tested under all conditions. IBM, therefore, cannot guarantee orimply reliability, serviceability, or function of these programs. The sample

58 Planning, installation, and deployment

Page 63: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

programs are provided "AS IS", without warranty of any kind. IBM shall not beliable for any damages arising out of your use of the sample programs.

TrademarksIBM, the IBM logo, and ibm.com are trademarks or registered trademarks ofInternational Business Machines Corp., registered in many jurisdictions worldwide.Other product and service names might be trademarks of IBM or other companies.A current list of IBM trademarks is available on the web at "Copyright andtrademark information" at www.ibm.com/legal/copytrade.shtml.

Java and all Java-based trademarks and logos are trademarks or registeredtrademarks of Oracle and/or its affiliates.

Linux is a trademark of Linus Torvalds in the United States, other countries, orboth.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks ofMicrosoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and othercountries.

Terms and conditions for product documentationPermissions for the use of these publications are granted subject to the followingterms and conditions.

Applicability

These terms and conditions are in addition to any terms of use for the IBMwebsite.

Personal use

You may reproduce these publications for your personal, noncommercial useprovided that all proprietary notices are preserved. You may not distribute, displayor make derivative work of these publications, or any portion thereof, without theexpress consent of IBM.

Commercial use

You may reproduce, distribute and display these publications solely within yourenterprise provided that all proprietary notices are preserved. You may not makederivative works of these publications, or reproduce, distribute or display thesepublications or any portion thereof outside your enterprise, without the expressconsent of IBM.

Rights

Except as expressly granted in this permission, no other permissions, licenses orrights are granted, either express or implied, to the publications or anyinformation, data, software or other intellectual property contained therein.

Notices 59

Page 64: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

IBM reserves the right to withdraw the permissions granted herein whenever, in itsdiscretion, the use of the publications is detrimental to its interest or, asdetermined by IBM, the above instructions are not being properly followed.

You may not download, export or re-export this information except in fullcompliance with all applicable laws and regulations, including all United Statesexport laws and regulations.

IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESEPUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUTWARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDINGBUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY,NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE.

IBM Online Privacy StatementIBM Software products, including software as service solutions, (“SoftwareOfferings”) may use cookies or other technologies to collect product usageinformation, to help improve the end user experience, to tailor interactions withthe end user or for other purposes. In many cases no personally identifiableinformation is collected by the Software Offerings. Some of our Software Offeringscan help enable you to collect personally identifiable information. If this SoftwareOffering uses cookies to collect personally identifiable information, specificinformation about this offering’s use of cookies is set forth below.

Depending upon the configurations deployed, this Software Offering may usesession and persistent cookies that collect each user’s name, user name, password,or other personally identifiable information for purposes of session management,authentication, single sign-on configuration or other usage tracking or functionalpurposes. These cookies can be disabled, but disabling them will also likelyeliminate the functionality they enable.

If the configurations deployed for this Software Offering provide you as customerthe ability to collect personally identifiable information from end users via cookiesand other technologies, you should seek your own legal advice about any lawsapplicable to such data collection, including any requirements for notice andconsent.

For more information about the use of various technologies, including cookies, forthese purposes, see IBM’s Privacy Policy at http://www.ibm.com/privacy andIBM's Online Privacy Statement at http://www.ibm.com/privacy/details in thesection entitled “Cookies, Web Beacons and Other Technologies” and the "IBMSoftware Products and Software-as-a-Service Privacy Statement" athttp://www.ibm.com/software/info/product-privacy.

60 Planning, installation, and deployment

Page 65: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

Notices 61

Page 66: with IBM Corp....The r epository stor es the apps that can be installed on mobile devices. The r epository is a database that also stor es information, such as feedback about the apps,

IBM®

Printed in USA