IBM Maximo Anywhere Version 7 Release 5.2 Planning, installation, and deployment IBM Note Before using this information and the product it supports, read the information in “Notices” on page 51. This edition applies to version 7, release 5, modification 2 of IBM Maximo Anywhere and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright IBM Corporation 2013, 2015. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Chapter 1. Planning to deploy Maximo Adding users to the Maximo Anywhere security Anywhere .............. 1 groups ............... 32 System architecture and components ...... 1 Maximo Anywhere security groups in Maximo System requirements for Maximo Anywhere, Asset Management ........... 33 MobileFirst Server, and MobileFirst Studio .... 4 Enabling Maximo Asset Management Deployment topologies ........... 6 applications for maps and labor reporting ... 34 Development environment......... 7 Maximo Asset Management system options that Single-server deployment of Maximo Anywhere affect mobile apps ........... 34 and MobileFirst Server .......... 8 Upgrading Maximo Anywhere ........ 35 Multiple-server deployment of Maximo File location changes in version 7.5.2 ..... 36 Anywhere and MobileFirst Server ...... 10 Application definition changes in version 7.5.2 . 36 Installation overview ........... 12 Installation planning worksheet ....... 14 Chapter 3. Building and deploying Installation checklist for Maximo Anywhere ... 15 Maximo Anywhere apps ....... 39 Application deployment process for Maximo Chapter 2. Installing the Maximo Anywhere apps ............. 39 Anywhere components........ 17 Deploying Maximo Anywhere apps to MobileFirst Installing the Maximo Asset Management required Server ................ 41 components .............. 17 Deploying apps from the command line to Installing MobileFirst Server ......... 17 WebSphere Application Server ....... 41 Setting the Java heap size on the JVM for Deploying apps by using MobileFirst Studio .. 42 WebSphere Application Server or WebSphere Properties files ............ 44 Application Server Liberty ........ 18 Maximo Anywhere directory structure .... 45 Installing MobileFirst Server by using the Adding digital signatures to Maximo Anywhere installation program .......... 18 apps................. 46 Installing the MobileFirst Server Administration Deploying apps to a secure server ....... 46 Services .............. 19 Installing Maximo Anywhere apps on mobile Preparing the Maximo Anywhere environment .. 21 devices ................ 46 Installing the Android development tools ... 21 Testing apps .............. 47 Installing the iOS development tools ..... 23 Setting up the Android emulator ...... 48 Installing Maximo Anywhere ........ 25 Creating a MobileFirst runtime environment ... 26 Chapter 4. Uninstalling Maximo Installing an integrated development environment 27 Anywhere, MobileFirst Server, and Silent mode: Installing Maximo Anywhere .... 28 MobileFirst Studio .......... 49 Recording a response file for silent installation . 28 Installing the required components in silent Notices .............. 51 mode ............... 29 Privacy Policy Considerations ........ 52 Installing Installation Manager in silent mode .. 30 Trademarks .............. 53 Parameters for silent mode installation ... 30 Installing Maximo Anywhere in silent mode .. 31 Setting up Maximo Asset Management for Maximo Anywhere ............... 32 © Copyright IBM Corp. 2013, 2015 iii iv Planning, installation, and deployment Chapter 1. Planning to deploy Maximo Anywhere IBM® Maximo Anywhere must be deployed with selected IBM MobileFirst Platform Foundation components to an enterprise system that includes Open Services for Lifecycle Collaboration (OSLC) provider capabilities. The installation of Maximo Anywhere involves deploying components that are specific to Maximo Anywhere and other components that are specific to MobileFirst. During the Maximo Anywhere installation, you must perform tasks that are outlined in the IBM MobileFirst Platform Foundation version 6.3.0 IBM Knowledge Center (www.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/ wl_welcome.html). Before you install Maximo Anywhere, read the installation and deployment information. To access the documentation, you must have an internet connection. System architecture and components Maximo Anywhere and MobileFirst form a mobile application platform that integrates with the Maximo® Asset Management enterprise system. Maximo Anywhere provides the content that is required to build mobile apps for Maximo Asset Management. The MobileFirst components function as middleware by enabling integration with the enterprise system and by supporting the deployment of apps to mobile devices. OSLC is installed on the Maximo Asset Management administrative workstation as part of the Maximo Anywhere package. The following figure shows the system architecture of Maximo Anywhere and highlights the relationship with key components in Maximo Asset Management and MobileFirst. © Copyright IBM Corp. 2013, 2015 1 Build environment Maximo Anywhere build server Maximo Maximo Anywhere project administrative workstation App Adapter Build EAR file Build and deploy Runtime environment Maximo enterprise application MobileFirst server OSLC service MobileFirst Application Center provider Login Console Data module Native apps Adapter Maximo database Data Install MobileFirst Mobile device database Maximo Anywhere app Local data store Figure 1. Maximo Anywhere system architecture and components The following required components must be deployed to the Maximo Asset Management environment to support the Maximo Anywhere apps: Maximo Integration Framework 7.5.1.2 This framework is required to enable the integration between Maximo Asset Management and external applications. The Integration Framework includes the OSLC capabilities and service providers that are used by the Maximo Anywhere apps to retrieve and process enterprise data. For Maximo Asset Management 7.5 environments, the Integration Framework is installed with the required components package. Maximo Asset Management 7.6 environments include the Integration Framework. IBM OSLC Content package 7.5.2.0 OSLC resources define the metadata for business objects of OSLC service providers. The OSLC resources are used by the mobile apps to retrieve and process application data from the service providers in Maximo Asset Management. Maximo Anywhere Enablement 7.5.2 The enablement package includes application files, license enablement, and 2 Planning, installation, and deployment cron task automation. The enablement package also includes the Anywhere Administration application, which is deployed as part of the MaximoAnywhere project. The following components are deployed when you implement Maximo Anywhere: IBM Maximo Anywhere A collection of resources that are required for integration and deployment on the MobileFirst platform. These resources include a MobileFirst-compatible project and an OSLC adapter. The OSLC adapter manages communications between MobileFirst Server and the provider application, Maximo Asset Management. Before run time, the Maximo Anywhere project WAR, the applications, and the OSLC adapter must be deployed 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 Edition A runtime container for the OSLC adapter and server-based application components. MobileFirst Server includes an administrative console and an app store for publishing mobile apps within the organization. MobileFirst Server must be deployed to an application server. The same application server can be used to deploy both Maximo Asset Management and MobileFirst Server. Application Center The Application Center is an enterprise app store that you can use for deploying the Maximo Anywhere apps to mobile devices in your organization. Application Center is automatically installed with MobileFirst Server. Application Center is composed of a server component, a repository, the Application Center console, and a mobile client app. v Server component: The server component is a Java™ Enterprise application that must be deployed in a web application server, such as WebSphere® Application Server. The server component consists of an administration console and a mobile client. The mobile client installs the apps that are available to the client component. Several services compose the Application Center server component, such as a service that lists the available apps, and a service that delivers the app 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 as feedback 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 to manage the repository. You must have system administrator privileges to access the Application Center console. v Mobile client: The mobile client runs on mobile devices and is used to install the apps that reside in the repository. IBM MobileFirst Platform Studio for MobileFirst Consumer Edition (Optional) An Eclipse-based integrated development environment that can be deployed with Maximo Anywhere. Chapter 1. Planning to deploy Maximo Anywhere 3 MobileFirst Studio is installed as