with ibm corp. · an api level of 18 or higher is r equir ed to build the andr oid apps. v t o...

IBM TRIRIGA AnywhereVersion 10 Release 4.3

Planning, installation, and deployment

IBM

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

This edition applies to version 10, release 4, modification 3 of IBM TRIRIGA Anywhere and to all subsequentreleases and modifications until otherwise indicated in new editions.

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

Contents

Chapter 1. Planning to deploy IBMTRIRIGA Anywhere . . . . . . . . . . 1System architecture and components . . . . . . 1System requirements for IBM TRIRIGA Anywhere,MobileFirst Server, and MobileFirst Studio . . . . 3Deployment topologies . . . . . . . . . . . 5

Development environment. . . . . . . . . 5Single-server deployment of IBM TRIRIGAAnywhere and MobileFirst Server . . . . . . 6Multiple-server deployment of IBM TRIRIGAAnywhere and MobileFirst Server . . . . . . 7

Installation overview . . . . . . . . . . . 8Installation planning worksheet . . . . . . . 10Installation checklist for IBM TRIRIGA Anywhere . 11

Chapter 2. Installing the IBM TRIRIGAAnywhere components. . . . . . . . 13Installing MobileFirst Server . . . . . . . . . 13

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

Preparing the IBM TRIRIGA Anywhere environment 16Installing the Android development tools . . . 16Installing the iOS development tools . . . . . 18Installing the Windows development tools . . . 20

Installing IBM TRIRIGA Anywhere . . . . . . 20Creating a MobileFirst runtime environment . . . 22Installing an integrated development environment 23Silent mode: Installing IBM TRIRIGA Anywhere . . 24

Recording a response file for silent installation . 24Installing Installation Manager in silent mode . . 25

Parameters for silent mode installation . . . 25

Installing TRIRIGA Anywhere in silent mode . . 26

Chapter 3. Building and deploying IBMTRIRIGA Anywhere apps . . . . . . . 27Application deployment process for IBM TRIRIGAAnywhere apps . . . . . . . . . . . . . 27Deploying IBM TRIRIGA Anywhere apps toMobileFirst Server . . . . . . . . . . . . 29

Deploying apps from the command line toWebSphere Application Server . . . . . . . 29Deploying apps from the command line toWebSphere Application Server full profile . . . 30Deploying apps by using MobileFirst Studio . . 31Properties files . . . . . . . . . . . . 33IBM TRIRIGA Anywhere directory structure . . 34Configuring MySQL Database for Androiddeployments . . . . . . . . . . . . . 35

Adding digital signatures to IBM TRIRIGAAnywhere apps . . . . . . . . . . . . . 35Deploying apps to a secure server . . . . . . . 35Installing IBM TRIRIGA Anywhere apps on mobiledevices . . . . . . . . . . . . . . . . 35

Installing IBM TRIRIGA Anywhere apps onWindows devices . . . . . . . . . . . 36

Testing apps . . . . . . . . . . . . . . 37Setting up the Android emulator . . . . . . 38

Chapter 4. Uninstalling IBM TRIRIGAAnywhere, MobileFirst Server, andMobileFirst Studio . . . . . . . . . . 39

Notices . . . . . . . . . . . . . . 41Privacy Policy Considerations . . . . . . . . 42Trademarks . . . . . . . . . . . . . . 43

© Copyright IBM Corp. 2014 - 2017 iii

iv Planning, installation, and deployment

Chapter 1. Planning to deploy IBM TRIRIGA Anywhere

IBM® TRIRIGA 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 IBM TRIRIGA® Anywhere involves deploying components thatare specific to IBM TRIRIGA Anywhere and other components that are specific toMobileFirst.

During the IBM TRIRIGA Anywhere installation, you must perform tasks that arespecific to IBM MobileFirst Platform Foundation 7.1.0. Before you install IBMTRIRIGA Anywhere, refer to the IBM Knowledge Center (www.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/wl_welcome.html).

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

System architecture and componentsIBM TRIRIGA Anywhere and IBM MobileFirst Platform Foundation form a mobileapplication platform that integrates with the IBM TRIRIGA Application Platformenterprise system.

The IBM TRIRIGA Anywhere component provides the content that is required tobuild mobile apps for IBM TRIRIGA. The MobileFirst components function asmiddleware by enabling integration with the enterprise system and by supportingthe deployment of apps to mobile users.

The IBM TRIRIGA Application Platform and IBM TRIRIGA contain OSLC featuresto support IBM TRIRIGA Anywhere 10.4.3.

The following figure shows the system architecture of IBM TRIRIGA Anywhereand highlights the relationship between key components in IBM TRIRIGAApplication Platform and MobileFirst.

© Copyright IBM Corp. 2014 - 2017 1

http://www-01.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/wl_welcome.html

Web archive

(.war)

Web archive

(.war)

IBM TRIRIGA Anywhere directory

Adapter Applications

Deployable files

Web archive

(.war)

Adapter

(.adapter)

Worklight

application project

(.wlapp)

Application package

(.apk or .ipa)

Generate deployable files

Build server

Runtime environment

Deploy project and files

Enterprise

system

Applications

Adapter

MobileFirst Server Application

Center

Apps

Mobile device

Runtime

interactions

(OSLC)

Check for app updates

Runtime interactions

(OSLC)

Download

The following components are deployed when you implement IBM TRIRIGAAnywhere:

IBM Anywhere Mobile Platform version 7.6.1A collection of resources that is required for integration and deploymentwith MobileFirst Server. These resources include a project that iscompatible with MobileFirst and an OSLC adapter. The OSLC adaptermanages communications between MobileFirst Server and the providerapplication, IBM TRIRIGA Application Platform. Before run time, the IBMTRIRIGA Anywhere project .war file, the applications, and the OSLCadapter are deployed to MobileFirst Server.

IBM TRIRIGA Anywhere Workplace OperationsThe IBM TRIRIGA Anywhere Workplace Operations product is installed onthe same computer as the IBM Anywhere Mobile Platform. The mobileapps can be configured, tested, and deployed to an emulator or a mobiledevice. The IBM TRIRIGA Anywhere Work Task Management app isintegrated withIBM TRIRIGA to enable mobile workers to access a subsetof work task data.

IBM MobileFirst™ Platform Server for MobileFirst Consumer EditionA runtime platform 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 is deployed to an application server. In a test environment, the sameapplication server can be used to deploy IBM TRIRIGA ApplicationPlatform and MobileFirst Server.

Figure 1. IBM TRIRIGA Anywhere system architecture and components

2 Planning, installation, and deployment

IBM MobileFirst Platform Studio for MobileFirst Consumer EditionAn Eclipse-based integrated development environment that can bedeployed as an optional component with IBM TRIRIGA Anywhere. Youuse MobileFirst Studio to configure and test the mobile app and to managethe build and deployment process.

Map servicesThe map view in the IBM TRIRIGA Anywhere Work Task Managementapp uses positioning data that is provided by IBM TRIRIGA ApplicationPlatform. IBM TRIRIGA Application Platform can be configured to obtainthis positioning data from an external geographic information system. Youmust be entitled to use the appropriate service from the map serviceprovider.

System requirements for IBM TRIRIGA Anywhere, MobileFirst Server,and MobileFirst Studio

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

A complete list of hardware and software requirements for your product isavailable in the IBM TRIRIGA Application Platform Compatibility Matrix.

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 the IBMTRIRIGA Anywhere 10.4.3 installation.

Enterprise system

IBM TRIRIGA Anywhere must be installed with IBM TRIRIGA ApplicationPlatform version 3.5.2 and IBM TRIRIGA version 10.5.2.

The IBM TRIRIGA Application Platform solution delivers an integratedworkplace management system that integrates functional models acrossreal estate, capital projects, facilities, workplace operations, portfolio data,and environmental and energy management on a single technologyplatform.

IBM TRIRIGA Application Platform includes the OSLC queries that theenterprise system requires to support IBM TRIRIGA Anywhere.

IBM TRIRIGA Anywhere version 10.4.3

To configure, build, and deploy the IBM TRIRIGA Anywhere mobile apps,the following 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 IBM TRIRIGA Anywhere apps forAndroid mobile devices. An API level of 18 or higher is required tobuild the Android apps.

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 IBM TRIRIGA Anywhere on a Mac OS X computer,you must install the iOS development tools first.

Chapter 1. Planning to deploy IBM TRIRIGA Anywhere 3

https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/IBM%20TRIRIGA1/page/Complete%20IBM%20TRIRIGA%20Support%20and%20Compatibility%20Matrix

http://www-01.ibm.com/support/docview.wss?uid=swg27024838

v Xcode IDE is required to build the IBM TRIRIGA Anywhere apps so thatthey can be deployed on iOS mobile devices.

v Microsoft Visual Community is required to build the IBM TRIRIGAAnywhere apps so that they can be deployed on Windows 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 simulator, you must install Google Chrome.

IBM MobileFirst Platform Server 7.1.0

MobileFirst Server is required to deploy IBM TRIRIGA Anywhere in aproduction environment.

You must deploy MobileFirst Server on a Windows or Linux computer.

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

For iOS devices that are operating at version 7.1 or later, you mustconfigure the application server to use SSL security.

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

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

For compatible products and versions, see the IBM MobileFirst PlatformFoundation 7.1.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. The

Table 1: Supported application servers and databases.




Oracle JDK includes the Java Runtime Environment (JRE), whichMobileFirst Studio requires to build the IBM TRIRIGA Anywhereapplications.

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 IBM TRIRIGA Anywhere mobile apps can be deployed to Android oriOS mobile devices. In a development environment, you can also test theapps in the MobileFirst Studio mobile browser simulator, the AndroidEmulator, the iOS Simulator, or the Visual Community simulator.

For a full list of operating systems and supported screen sizes, see the IBMTRIRIGA Application Platform Compatibility Matrix.

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

You use a development environment to configure and test the IBM TRIRIGAAnywhere mobile apps before they are deployed to the production server. A testinstance or a development instance of IBM TRIRIGA Application Platform isrequired, either on the same 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 IBM TRIRIGAAnywhere and MobileFirst Server installed on the same computer. Apre-production instance of IBM TRIRIGA Application Platform is also required,either on the same computer or on a remote computer. The pre-production instanceof IBM TRIRIGA Application Platform must closely match the productionenvironment so that the application configurations can be tested before you moveto a production environment.

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 IBM TRIRIGAApplication Platform must be available on a different computer than the IBMTRIRIGA Anywhere and MobileFirst components.

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

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

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


https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/IBM%20TRIRIGA1/page/Complete%20IBM%20TRIRIGA%20Support%20and%20Compatibility%20Matrix

To create a development environment, you install MobileFirst Studio and IBMTRIRIGA Anywhere on a single computer. A test instance or a developmentinstance of IBM TRIRIGA Application Platform is also required, either on the samecomputer or on a remote computer.

IBM TRIRIGA Application Platform

MobileFirst Studio

IBM TRIRIGA Anywhere

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, iOS, orWindows platform.

Example: Creating an Android development environment

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

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

He creates a test instance or a development instance of IBM TRIRIGA ApplicationPlatform and backs up the system.

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 IBM TRIRIGA Anywhere. During theinstallation, he selects Embedded Server within MobileFirst Studio.

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

Single-server deployment of IBM TRIRIGA 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.

To create a single-server deployment, you install MobileFirst Server and IBMTRIRIGA Anywhere on a single computer. A test instance or a production instanceof IBM TRIRIGA Application Platform is also required, either on the samecomputer or on a remote computer.

IBM TRIRIGA Application Platform

MobileFirst Server

IBM TRIRIGA Anywhere

Figure 2. A IBM TRIRIGA Anywhere development environment


You can configure an instance of WebSphere Application Server, WebSphereApplication Server Liberty 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 IBM TRIRIGA 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 IBM TRIRIGAAnywhere 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 IBM TRIRIGA Application Platform.

He creates a production database instance on the IBM TRIRIGA ApplicationPlatform database server.

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

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

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

Multiple-server deployment of IBM TRIRIGA Anywhere andMobileFirst Server

A multiple-server deployment is suitable for medium and large enterprises and isdeployed by installing IBM TRIRIGA Anywhere and MobileFirst Server onseparate computers. A production instance of IBM TRIRIGA Application Platformon a remote computer 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 IBM TRIRIGA Anywhere build server is used to configure, build, and deploythe apps to MobileFirst Server. Mobile workers can then download the apps totheir mobile devices from the Application Center.

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


Example: Creating a multiple-server deployment

Ian is a system administrator who is responsible for implementing IBM TRIRIGAAnywhere 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.

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 IBM TRIRIGAAnywhere. During the installation, Ian specifies the host name of the MobileFirstServer computer.

When the installation is complete, Ian copies the TRIRIGAAnywhere.war file from theIBM TRIRIGA 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 IBM TRIRIGAAnywhere apps from the Application Center and install them on a mobile device.Related tasks:Configuring the application serverRelated information:

Typical topologies of a MobileFirst instance

Installation overviewThe IBM TRIRIGA Anywhere installation involves preparing target computers andexisting middleware for installation, and installing key components for IBMTRIRIGA Anywhere and MobileFirst Server.

The IBM TRIRIGA Anywhere launchpad is a centralized interface where you canstart the installation programs. IBM TRIRIGA Anywhere and MobileFirst Server areinstalled by using IBM Installation Manager. Installation Manager is a tool thatguides you through the installation of IBM products.

Ensure that IBM TRIRIGA Application Platform 3.5.2 or later is installed.

Before you install IBM TRIRIGA Anywhere and MobileFirst Server, ensure thatyour environment contains an application server and a database instance.

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

You must prepare the IBM TRIRIGA Anywhere environment by installingdevelopment tools. MobileFirst Studio is an optional component and can be


http://www.ibm.com/support/knowledgecenter/SSLKT6_7.5.0.5/com.ibm.mbs.doc/gp_highavail/t_ctr_configure_app_server.html

http://www-01.ibm.com/support/knowledgecenter/SSZH4A_6.1.0/com.ibm.worklight.installconfig.doc/admin/c_typical_topology_of_an_ibm_wor.html

installed as part of the Eclipse integrated development environment (IDE). ForAndroid app development, the Android SDK and the Oracle JDK are both requiredto build the mobile apps. For iOS app development, XCode and Apple developerprofiles are required on a Mac OS X computer. For Windows app development,Microsoft Visual Community must be installed on a computer that is runningWindows version 8.1 or later.

Administrative user rights are required to install all of the components that aredelivered with IBM TRIRIGA Anywhere version 10.4.3. You must have root userauthorization for Linux systems.

IBM TRIRIGA Anywhere, MobileFirst Server, and MobileFirstStudio

Before you install IBM TRIRIGA Anywhere and the MobileFirst components, youmust install prerequisite software and configure the database server.

In most production environments, MobileFirst Server is installed on a differentcomputer than IBM TRIRIGA Anywhere. You must deploy MobileFirst Server to anapplication server before you install IBM TRIRIGA Anywhere. You can installMobileFirst Studio and IBM TRIRIGA 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 IBM TRIRIGA Anywhere andMobileFirst Server 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 IBM TRIRIGA Anywhere, MobileFirst Server, and Installation Manager from acommand line.

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

IBM TRIRIGA Anywhereinstallation directory

Windows:C:\IBM\TRIRIGAAnywhere

Linux: opt/ibm/TRIRIGAAnywhere</filepath

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

TRIRIGAAnywhere

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 and Linux:9080

On Mac OS X: none

Application Center contextroot

applicationcenter

Application Center username

appcenteradmin

Application Centerpassword

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


Variable Default value Example value Your value

Oracle JDK directory Windows: C:\ProgramFiles\Java

Linux:/usr/java

Visual Communitydirectory

C:\Program Files(x86)\Microsoft VisualStudio 12.0

IBM TRIRIGA ApplicationPlatform Server protocol

http

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

Server port

Server context root

Related reference:Installation program log files

Installation checklist for IBM TRIRIGA AnywhereYou can use the checklist to ensure that all installation steps completedsuccessfully. Print this topic and check each task as you complete it.

Preparing for installation

Done Task

Ensure that your environment meets all ofthe software and hardware requirements forIBM TRIRIGA Anywhere and IBMMobileFirst Platform Foundation.

Print the installation planning worksheetand use it during the installation.

Installing IBM TRIRIGA Anywhere

Done Task

On the computer where IBM TRIRIGAApplication Platform 3.5.2 is installed,download the IBM TRIRIGA Anywhereproduct software from IBM® PassportAdvantage®.

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 theIBM TRIRIGA Anywhere environment.


http://panchax.tivlab.austin.ibm.com:8207/help/topic/com.ibm.mbs.doc/tshoot/r_install_log_files.html

Done Task

On the build computer, install IBM TRIRIGAAnywhere.

On the MobileFirst Server computer, add aMobileFirst runtime environment by usingthe MobileFirst Server Configuration Tool.

On the computer where IBM TRIRIGAAnywhere is installed, run the build allcommand. If your computer is a Windowssystem, use the build.cmd file. If yourcomputer is a Linux system, use thebuild.sh file. This step generates thedistributable files for the IBM TRIRIGAAnywhere project and deploys them toMobileFirst Server.

Install the IBM TRIRIGA Anywhere apps onmobile devices.

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

Verifying the installation

Done Task

Test the IBM TRIRIGA Anywhere apps onmobile devices.


Chapter 2. Installing the IBM TRIRIGA Anywhere components

After you plan your environment, you install IBM TRIRIGA Anywhere andMobileFirst on one or more computers.

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.

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 (https://www.ibm.com/support/knowledgecenter/SSHS8R_7.1.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:


https://www.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.installconfig.doc/install_config/c_wlserver_plan_install.html

https://www.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.installconfig.doc/install_config/c_wlserver_plan_install.html

-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 IBM TRIRIGA Anywhere deployment, MobileFirst Server includes three maincomponents: MobileFirst Server Administration Services, MobileFirst OperationsConsole, and Application Center. You must deploy MobileFirst Server to anapplication server.

Before you beginv Ensure that you installed the required components on the IBM TRIRIGA

Application Platform 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 forIBM TRIRIGA 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 Linuxsystem, 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(https://www.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.installconfig.doc/admin/c_completing_the_installation.html).Related tasks:


https://www.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.installconfig.doc/admin/c_completing_the_installation.html

“Setting the Java heap size on the JVM for WebSphere Application Server orWebSphere Application Server Liberty” on page 13To 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

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 7.1.0 IBM Knowledge Center (www.ibm.com/support/knowledgecenter/SSHS8R_7.1.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 7.1.0 > ServerConfiguration Tool.

On Linux In the desktop menu, click IBM MobileFirstPlatform Server 7.1.0 > ServerConfiguration Tool.

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.

Chapter 2. Installing the IBM TRIRIGA Anywhere components 15

http://www.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.installconfig.doc/install_config/c_wlserver_plan_databases.html

http://www.ibm.com/support/knowledgecenter/SSRTLW_8.5.5/com.ibm.servertools.doc/topics/rcprofile.html

http://www.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.installconfig.doc/install_config/t_wlconsole_install_manual.html

http://www.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.installconfig.doc/admin/c_manually_configuring_databases_for_ac.html

http://www.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.installconfig.doc/install_config/t_wlconsole_install.html

http://www.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.installconfig.doc/install_config/t_wlconsole_install.html

4. On the Configurations Details pane, record the context root value for theMobileFirst 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 the IBMTRIRIGA Anywhere apps after IBM TRIRIGA Anywhere is installed. Thedefault context 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 IBM TRIRIGA Anywhere installation. Click Save and Deploy.

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 IBM TRIRIGA Anywhere environmentBefore you can build and deploy the IBM TRIRIGA Anywhere Work TaskManagement app, you must set up the computer on which IBM TRIRIGAAnywhere is installed.

Procedure1. Prepare the environment for building the app:

Android Install the Android development tools.

iOS Install the iOS development tools.

Windows Install the Windows development tools

2. Install IBM TRIRIGA Anywhere3. Optional: Install an integrated development environment.4. Deploy the app with MobileFirst Studio.

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

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

b. Run the executable file and proceed through the installation program.


http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

c. Set the JAVA_HOME environment variable and specify the path to thedirectory where the JDK was installed:

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.8.0_121

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.8.x

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


http://developer.android.com/sdk/index.html

b. In the SDK Tools Only section, download the SDK for your operatingsystem and extract the compressed file on your computer.

c. Start the installation wizard.

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 25 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 wherean individual is considered 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; the legal contact andadministrator of the team who has all privileges and full access to Member Centerand 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.You can create a development provisioning profile or a distribution provisioning profile


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.

An app store distribution provisioning profile provides access to the apps on alldevices in your enterprise. However, IBM TRIRIGA Anywhere supports only oneglobal app ID for an app store distribution provisioning profile.

Procedure1. Install Oracle JDK version 8.0.

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

b. Run the executable file and proceed through 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. In Xcode, create the certificate (developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingCertificates/MaintainingCertificates.html) for the provisioningprofile.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). You must register the App IDs as wildcards. Whenyou create the App IDs, select Wildcard App ID and enter the bundle ID. Thedefault bundle ID for WorkTaskManagement is com.WorkTaskManagement*. Youcan change the bundle ID in the application-descriptor.xml file.

7. Register the Device IDs in Member Center (developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html). You can locate the unique device identifier (UDID)by connecting your device to the Mac OS X computer while Xcode or iTunesare running.


http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

https://developer.apple.com/programs/register/

https://developer.apple.com/programs/register/

http://www.apple.com/osx/apps/app-store.html

https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppStoreDistributionTutorial/AddingYourAccounttoXcode/AddingYourAccounttoXcode.html

https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingCertificates/MaintainingCertificates.html

http://support.apple.com/kb/PH7297

https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html


8. Create the provisioning profile for each app by using Member Center.

Type of provisioning profile Action

Development provisioning profile As the developer, generate the provisioningprofiles and then download the profiles toyour Mac OS X computer. Open eachprovisioning profile in XCode. Theprovisioning profiles are added to thesystem library at the following location:~/Library/MobileDevice/ProvisioningProfiles".

App store distribution provisioning profile When you generate the provisioning profile,you are not required to provide IDs of thedevices. Download the profile to your MacOS X computer and add the profile identifierto the build.properties file.

You must download the provisioning profile to the build server every time theprofile is updated. When you run the app build and deployment process, theprovisioning profiles are collected and stored in the iOS application archive file(IPA).

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

Before you begin

You must use a computer that is running Windows version 8.1 or later.

About this task

You must install either Visual Community Express 2015 for Desktop or VisualCommunity Express 2015 for Windows.

Restriction: Visual Community Express 2015 for Web is not supported.

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

downloads/download-visual-studio-vs.aspx), select Visual Studio 2015 >Express 2015 for Desktop and click Download.

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

Installing IBM TRIRIGA AnywhereThe IBM TRIRIGA Anywhere component contains the project and the mobile apps.

Before you beginv 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.



https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx

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 IBM TRIRIGA Anywhere launchpad program is not supported onMac OS X or on Linux. To start the installation on Mac or Linux, you must startIBM® Installation Manager manually.

Procedure1. Start the launchpad.

Option Description

Windows Double-click the launchpad file. Use thelaunchpad64.exe file.

Mac OS X 1. From the IBM TRIRIGA Anywhereinstallation image, open the Install > IMfolder and expand the installer.macOScompressed file.

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

Linux 1. Download and unzipTRI_Anywhere_Wrkplc_1043.zip.

a. Within the unzipped folder, unzipTririgaAnywhereAllIMRepos.zip.

b. Within the Install/IM/installer.linux.x86_64 folder, runinstall.

2. Install the Installation Manager followingthe prompts.

3. Add the repository.config/disk.inf fileto the Installation Manager repositories.

4. Add the following repositories toinstallation manager:

v /home/tririga/TRI_Anywhere_Wrkplc_Op_1043/Install/MobileFirstServer/disk1/disk.inf

v /home/tririga/TRI_Anywhere_Wrkplc_Op_1043/Install/MobileFirstServerIF/disk1/disk.inf

v /home/tririga/TRI_Anywhere_Wrkplc_Op_1043/Install/repository.config

2. On the Install IBM TRIRIGA 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 integrated


development 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 theTRIRIGAAnywhere.war file to the MobileFirst Server computer.

Creating a MobileFirst runtime environmentAfter IBM TRIRIGA Anywhere is installed, you must set up and configure aMobileFirst runtime configuration by using the MobileFirst Server ConfigurationTool.

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 7.1 > Server ConfigurationTool.

On Linux In the desktop menu, click IBM MobileFirstPlatform Server 7.1 > 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 Add a MobileFirst runtime environment to a configuration and specifya name for the new runtime environment. Use the scroll bar to see theMobileFirst project configuration.

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

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

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

all command. If your computer is a Windows system, use the build.cmd file. Ifyour computer is a Linux system, use the build.sh file. This step generates thedistributable files for the project and deploys them to MobileFirst Server.

Results

After the deployment is complete, the project and apps are available in theMobileFirst Operations Console and the Application Center Console.


Installing an integrated development environmentA development environment requires development tools to be installed on thebuild computer. You can use an integrated development environment to test andconfigure mobile apps before you deploy them to mobile devices.

Before you beginv Ensure that you have installed the development tools for the mobile device

platform.v To preview 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 IBM TRIRIGA Anywhere apps. You install MobileFirst Studio fromthe Eclipse integrated development environment (IDE) workbench.

To view and test mobile apps, you can use the MobileFirst Studio mobile browsersimulator, the Android Emulator, the iOS Simulator, or the Visual Communitysimulator.

You can customize mobile apps when they are deployed. For more information, seethe Configuring IBM TRIRIGA Anywhere mobile apps section of the IBMKnowledge Center.

Procedure1. Install Eclipse IDE:

a. Go to www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/keplersr2 and download Eclipse IDE for Java EE Developersversion (Eclipse Kepler 2) 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.4) Select Web Tools Platform (WTP) 3.5.1 (or later) > JavaScript

Development 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

IBM TRIRIGA Anywhere installation image and click Open > OK.d. On the Available Software pane, select IBM MobileFirst Studio

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

4. Import the TRIRIGAAnywhere 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 TRIRIGAAnywhere 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 MobileFirstAdapter.

e. Right-click the application folder and click Run As > Run on MobileFirstDevelopment Server.

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

Silent mode: Installing IBM TRIRIGA AnywhereYou can run a silent installation of IBM TRIRIGA Anywhere, MobileFirst Server,and Installation Manager from a command line. Silent installations that areconducted with 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 IBM TRIRIGA Anywhere and MobileFirst Server. Once your systemis set up to record a response file, the response file is overwritten with eachsubsequent use 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.

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

On Windows set record=true


On Linux export record=true

2. Start the TRIRIGA 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 Installation Manager in silent modeInstallation Manager is the tool that is used to install IBM TRIRIGA 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 IBM TRIRIGA Anywhere installation

image and copy the Installation Manager folder for your system to a localdirectory. 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

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.

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.


http://pic.dhe.ibm.com/infocenter/install/v1r5/topic/com.ibm.silentinstall12.doc/topics/t_silent_installIM_IMinst.html

Parameter Description

-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 TRIRIGA Anywhere in silent modeYou can generate a response file by completing a successful installation of IBMTRIRIGA Anywhere with the Installation Manager. Alternatively, you can use asample response file that is provided in the samples directory of the IBM TRIRIGAAnywhere compressed 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 IBM TRIRIGA Anywhere installation image.

For Mac OS X installations, use theresponse_install_TRIRIGA_Anywhere_Only_MAC.xml response file. For all otheroperating systems, use the response_install_TRIRIGA_Anywhere_Only.xml responsefile.

About this task

You can copy the IBM TRIRIGA Anywhere response file to multiple computers torun silent installations. However, ensure that all values in the response file arevalid for the 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 -silent -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 -silent -input C:\tmp\response_install_TRIRIGA_Anywhere_Only.xml-log C:\tmp\silent_install_log.xml -acceptLicense


Chapter 3. Building and deploying IBM TRIRIGA Anywhereapps

Before mobile users can download IBM TRIRIGA Anywhere apps, the apps mustbe built and deployed to MobileFirst Server.

Application deployment process for IBM TRIRIGA Anywhere appsIBM TRIRIGA Anywhere apps are generated in the build server and then deployedto the 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.

Web archive

(.war)

Web archive

(.war)

IBM TRIRIGA Anywhere directory

Adapter Applications

Deployable files

Web archive

(.war)

Adapter

(.adapter)

Worklight

application project

(.wlapp)

Application package

(.apk or .ipa)

Generate deployable files

Build server

Runtime environment

Deploy project and files

Enterprise

system

Applications

Adapter

MobileFirst Server Application

Center

Apps

Mobile device

Runtime

interactions

(OSLC)

Check for app updates

Runtime interactions

(OSLC)

Download

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 or IPA file are created. When you deploy the project and these files to theruntime environment, which includes MobileFirst Server, the applications andadapter are available for download to a mobile device.


The deployable files are in the tririgaanywhere_home\TRIRIGAAnywhere\bindirectory:

WAR fileA web archive (WAR) file. Each IBM TRIRIGA Anywhere project includestwo WAR files. The WAR files are used to package distributableapplication files and related project resources and to deploy them toMobileFirst Server.

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

WebSphere Application Server 8, WebSphere Application Server 8.5, andWebSphere Application Server Liberty

v The TRIRIGAAnywhere-2.4.war file for servlet version 2.4 applicationserver: WebSphere Application Server 7

After you install IBM TRIRIGA 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 TRIRIGAAnywhere.war file is updated with the IBM TRIRIGAAnywhere 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 IBM TRIRIGA Anywhere app that isdeployed to MobileFirst Server. MobileFirst Server uses this file to identifymobile apps.

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.

APPX fileA Windows 8.1 binary file that is ready for deployment to a Windowsdevice.

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 full profile


The full profile supports advanced configurations. WebSphere ApplicationServer includes Application Center for downloading apps to mobiledevices.

If you deploy apps from MobileFirst Studio, you run the adapter and appdeployment tasks. The adapter and apps are deployed to MobileFirst Server andthe apps are available for download. With MobileFirst Studio, the ApplicationCenter is not available.

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 IBM TRIRIGAAnywhere installation process. You deploy the WAR file with the MobileFirstServer Configuration tool. This WAR file contains properties that control the IBMTRIRIGA Anywhere app features, such as timeout values. Whenever you changethe properties 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 command. After the apps and the WAR file are deployed tothe server, mobile users can download the apps from the Application Center totheir mobile devices.Related reference:“Properties files” on page 33The process for building and deploying apps requires input from configurableproperties files that belong to the application.“IBM TRIRIGA Anywhere directory structure” on page 34The IBM TRIRIGA Anywhere directory contains the files that are required togenerate IBM TRIRIGA Anywhere apps. This directory includes predefined contentfor generating mobile apps that integrate with provider applications in theenterprise system. The application deployment process also generates a set of files.

Deploying IBM TRIRIGA 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

For environments that do not include MobileFirst Studio but do include one of theWebSphere Application Server profiles, you can deploy apps from the operatingsystem command line.

Before you beginv Install IBM TRIRIGA Anywhere.v If you plan to preview the deployed apps in the MobileFirst Operations Console,

Google Chrome must be installed on the IBM TRIRIGA Anywhere build server.The preview function for the deployed apps does not support most other webbrowsers.

v The MobileFirst Server instance and the Application Center console must berunning.

v If you are running MySQL and plan to deploy IBM TRIRIGA Anywhere mobileapps to Android devices, you might need to Configure MySQL Database.

Chapter 3. Building and deploying apps 29

Procedure1. Deploy the distributable files to MobileFirst Server:

a. On the IBM TRIRIGA Anywhere build server, in the tririgaanywhere_home\TRIRIGAAnywhere directory, open the build.properties file. Verify that theMobileFirst Server properties and the Application Center properties arecorrect for your environment.

b. Run the build all command, build.cmd on Windows or build.sh on Linuxsystems. The .apk or .ipa artifact file is generated and all distributable filesfor the IBM TRIRIGA Anywhere project are deployed to MobileFirst Server.

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

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

(https://www.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.appadmin.doc/appcenter/t_installing_the_client_on_an_and_mob.html) or an iOS mobile device(https://www.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.appadmin.doc/appcenter/t_installing_the_client_on_a_ios_mob.html) so that you can download the IBMTRIRIGA Anywhere apps.

v Add digital signatures to IBM TRIRIGA Anywhere apps.Related information:

MobileFirst Server Configuration Tool

Ant tasks for deploying a WAR file

Deploying apps from the command line to WebSphereApplication Server full profile

For environments that do not include MobileFirst Studio but do include one of theWebSphere Application Server profiles, you can deploy apps from the operatingsystem command line. The runtime environment that is available with WebSphereApplication Server is referred to as the full profile.

Before you beginv If you plan to preview the deployed apps in the MobileFirst Operations Console,

Google Chrome must be installed on the IBM TRIRIGA Anywhere build server.The preview function for the deployed apps does not support most other webbrowsers.


About this task

The project WAR file contains the MobileFirst Operations Console, defaultconfiguration values for the server, and some resources for the MobileFirstapplications and adapters.

When you use Installation Manager to install MobileFirst Server, ApplicationCenter is installed on the web application server that you designate.


https://www.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.appadmin.doc/appcenter/t_installing_the_client_on_an_and_mob.html

https://www.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.appadmin.doc/appcenter/t_installing_the_client_on_a_ios_mob.html

http://www-01.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.deploy.doc/deploy/c_using_server_config_tool.html?lang=en

http://www-01.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.deploy.doc/devref/c_project_war_file_ant_tasks.html?lang=en

Procedure1. On the IBM TRIRIGA Anywhere build server, in the tririgaanywhere_home\

TRIRIGAAnywhere directory, open the build.properties file. Verify that theMobileFirst Server properties and the Application Center properties are correctfor your environment.

2. Deploy the project WAR file with the MobileFirst Server Configuration Tool.a. From the Server Configuration Tool, either select Create a MobileFirst

Server configuration for the first time you deploy the WAR file or selectReplace the WAR files of a deployed MobileFirst Server configuration forany subsequent redeployments of the WAR file.

b. Complete the steps in the wizard.3. Deploy the Application Center WAR files and configure the application server.4. Verify that both the MobileFirst Server instance and the Application Center

console are running.5. From the tririgaanywhere_home\TRIRIGAAnywhere directory, run the build all

command, build.cmd on Windows or build.sh on Linux systems. The .apk or.ipa artifact file is generated and all distributable files for the IBM TRIRIGAAnywhere project are deployed to MobileFirst Server.

6. Verify deployment of the IBM TRIRIGA Anywhere apps in the MobileFirstOperations Console. In Google Chrome, open the MobileFirst OperationsConsole and select Preview as common resources for any IBM TRIRIGAAnywhere app.

What to do next

Install the Application Center mobile client on an Android mobile device or an iOSmobile device so that you can download the IBM TRIRIGA Anywhere apps.

Add digital signatures to IBM TRIRIGA Anywhere apps.Related information:

MobileFirst Server Configuration Tool

Ant tasks for deploying a WAR file

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.

Before you beginv 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 most other web browsers.


Procedure1. In MobileFirst Studio, import the IBM TRIRIGA 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 tririgaanywhere_home folder, select the TRIRIGAAnywherefolder, select Copy projects into workspace, and click Finish.


http://www-01.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.deploy.doc/deploy/c_using_server_config_tool.html

http://www-01.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.installconfig.doc/admin/c_deploying_appcenter_war_files_manually.html

http://www-01.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.appadmin.doc/appcenter/t_installing_the_client_on_an_and_mob.html

http://www-01.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.appadmin.doc/appcenter/t_installing_the_client_on_a_ios_mob.html

http://www-01.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.appadmin.doc/appcenter/t_installing_the_client_on_a_ios_mob.html

http://www-01.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.deploy.doc/deploy/c_using_server_config_tool.html?lang=en

http://www-01.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.deploy.doc/devref/c_project_war_file_ant_tasks.html?lang=en

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 tririgaanywhere_home > build >

tools > ant and click OK.3. On the IBM TRIRIGA Anywhere build server, in the tririgaanywhere_home\

TRIRIGAAnywhere directory, open the build.properties file. Verify that theMobileFirst Server properties and the Application Center properties are correctfor your environment.

4. From the Servers tab, start the embedded MobileFirst server.5. Add the build.xml file to the Ant view. Select the build.xml file from

TRIRIGAAnywhere and drag the build.xml file to the Ant view.6. Expand the build.xml file in the Ant view and double-click the all task to run

the build.xml file.7. Verify the application deployment in MobileFirst Operations Console by

right-clicking the app and selecting Run As > Preview.8. Test your app on either your mobile device, the Android Emulator, the iOS

Simulator, or the Visual Community simulator. To test the app on the Androidemulator, you must first set up the emulator. To test the app on a mobiledevice, 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. The .apk artifactfile is generated in the bin folder.

iOS 1. Under AnywhereWorkTaskManagement> apps > app_name > iphone, right-clickRun as , and select Xcode project.

2. From the Xcode window, choose thesimulated device or mobile device onwhich you want to test the app, andclick the Play icon. The .ipa artifact fileis generated in the bin folder.

Windows 1. Under AnywhereWorkTaskManagement> apps > app_name > Windows8,right-click Run as, and select VisualStudio project.

2. From the Visual Studio window, choosethe simulated device or mobile device onwhich you want to test the app, andclick the Play icon. The .appx artifact fileis generated in the bin folder.

Related concepts:

Mobile browser simulator


http://www-01.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.dev.doc/wl_studio_tools/topics/cmbswl.html?lang=en

iOS Simulator

Related tasks:“Setting up the Android emulator” on page 38The Android emulator can show you what your Android apps look like and helpyou test app behavior.“Testing apps” on page 37After 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.Related reference:

Building and deploying in MobileFirst StudioRelated information:Software cannot be installed in MobileFirst Studio

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.

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 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 thetririgaanywhere_home\TRIRIGAAnywhere directory and updated with valuesthat are provided to the installer. If you change the environment after youinstall IBM TRIRIGA Anywhere, the build.properties file is notautomatically updated. If you change the enterprise server in yourenvironment, you must change the adapter.connection property in thebuild.properties file.


https://developer.apple.com/library/content/documentation/IDEs/Conceptual/iOS_Simulator_Guide/Introduction/Introduction.html

http://www-01.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.deploy.doc/topics/c_deploy.html?lang=en

http://panchax.tivlab.austin.ibm.com:8207/help/topic/com.ibm.mbs.doc/tshoot/ts_software_updates_eclipse.html

If you change the IBM TRIRIGA application server and the MobileFirstServer, you must rebuild and redeploy the WAR 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

IBM TRIRIGA Anywhere directory structureThe IBM TRIRIGA Anywhere directory contains the files that are required togenerate IBM TRIRIGA Anywhere apps. This directory includes predefined contentfor generating mobile apps that integrate with provider applications in theenterprise system. The application deployment process also generates a set of files.

The IBM TRIRIGA Anywhere directory includes the application definition file anda set of properties files.

File Description Path

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

tririgaanywhere_home\TRIRIGAAnywhere\apps\application_name\artifact

worklight.properties Contains configurationparameters for apps

tririgaanywhere_home\TRIRIGAAnywhere\server\conf

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

tririgaanywhere_home\TRIRIGAAnywhere

app-feature.properties Contains variable aspects ofthe build process

tririgaanywhere_home\TRIRIGAAnywhere\apps\app_name

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

tririgaanywhere_home\TRIRIGAAnywhere\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 tririgaanywhere_home\TRIRIGAAnywhere\bin

application_name.wlapp Contains server artifacts tririgaanywhere_home\TRIRIGAAnywhere\bin

application_name.apk

application_name.ipa

application_name.appx

Contains client artifacts tririgaanywhere_home\TRIRIGAAnywhere\bin


Configuring MySQL Database for Android deploymentsExtra configuration might be required before you can load mobile app .apk files tothe MobileFirst Server when MySQL Database is used. With MySQL 5.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.3. Edit the C:\ProgramData\MySQL\MySQL Server 5.6\my.ini file in and update the

innodb_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 IBM TRIRIGA 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).

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 IBM TRIRIGA Anywhere, the enterprise server is the IBMTRIRIGA 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 IBM TRIRIGA Anywhere apps on mobile devicesThe Application Center mobile client must be installed before the apps can beinstalled on mobile devices.


http://developer.android.com/tools/publishing/app-signing.html



https://www-01.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.installconfig.doc/admin/t_configuring_SSL_WL_adapters_backend_servers_certificates.html

https://www-01.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.installconfig.doc/appcenter/c_ac_ssl_config.html

About this task

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.

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 iOS apps, follow the instructions for launching your iOS app on a device onthe iOS Developer Library website.

If you are using MobileFirst Studio, the Application Center is not available.Instead, under AnywhereWorkTaskManagement > apps, right-click the app andselect Run As > Run on device.

Installing IBM TRIRIGA Anywhere apps on Windows devicesTo download the mobile client to your devices, you must log in to the ApplicationCenter console. The IBM MobileFirst Platform Server Application Center console isa web application for managing the repository of mobile apps. The ApplicationCenter mobile client is a secure catalog of available mobile apps.

About this task

You can install IBM TRIRIGA Anywhere mobile apps on Windows 8.1 or 10 tablets(64-bit and excluding RT).

Certificates are used to sign the apps. The certificates must be installed on themobile devices as trusted certificates. TRIRIGA Anywhere provides defaultcertificates. The default certificates are in the windows8\native directory for eachapp. Each certificate is called TRIRIGAAnywhere_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.


http://www.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.appadmin.doc/appcenter/t_installing_the_client_on_an_and_mob.html

http://developer.android.com/tools/building/building-cmdline.html

http://developer.android.com/tools/building/building-cmdline.html

http://www.ibm.com/support/knowledgecenter/SSHS8R_6.3.0/com.ibm.worklight.appadmin.doc/appcenter/t_installing_the_client_on_a_ios_mob.html

https://developer.apple.com/library/ios/documentation/IDEs/Conceptual/AppDistributionGuide/LaunchingYourApponDevices/LaunchingYourApponDevices.html

https://msdn.microsoft.com/en-us/library/windows/apps/dn832613.aspx

https://msdn.microsoft.com/en-us/library/windows/apps/dn832613.aspx

b. From Solution Explorer, select the package.appxmanifest file and click thePackaging 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 IBM TRIRIGA Anywhere app.

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

What to do next

If you are using MobileFirst Studio, the Application Center is not available.Instead, under AnywhereWorkTaskManagement > apps, right-click the app andselect Run As > Run on device.

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.


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. Toview 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 Community 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 the Work Task Management app and search for a known work task.2. In IBM TRIRIGA Application Platform, use the same search criteria to find the

work task.3. Compare the results to ensure that they are the same.Related concepts:


iOS SimulatorRelated tasks:“Setting up the Android emulator”The Android emulator can show you what your Android apps look like and helpyou test app behavior.

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


http://www-01.ibm.com/support/knowledgecenter/SSHS8R_7.1.0/com.ibm.worklight.dev.doc/wl_studio_tools/topics/cmbswl.html?lang=en

https://developer.apple.com/library/content/documentation/IDEs/Conceptual/iOS_Simulator_Guide/Introduction/Introduction.html

Chapter 4. Uninstalling IBM TRIRIGA Anywhere, MobileFirstServer, and MobileFirst Studio

You use Installation Manager to uninstall IBM TRIRIGA Anywhere, the mobileapps, and MobileFirst Server. If MobileFirst Studio is installed, you uninstall itfrom the Eclipse client.

Procedure1. To uninstall IBM TRIRIGA 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 TRIRIGA_install.location file.

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 TRIRIGAAnywhere project:

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

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


Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document 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 DriveArmonk, NY 10504-1785U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBMIntellectual Property Department in your country or send inquiries, in writing, to:

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

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law: INTERNATIONALBUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS"WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFNON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULARPURPOSE. Some states do not allow disclaimer of express or implied warranties incertain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will 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 Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct and use of those Web sites is at your own risk.


IBM may use or distribute any of the information you supply in any way 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 Corporation2Z4A/10111400 Burnet RoadAustin, TX 78758U.S.A.

Such information may be available, subject to appropriate terms and conditions,including in some cases, payment of a fee.

The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

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.

All statements regarding IBM's future direction or intent are subject to change orwithdrawal without notice, and represent goals and objectives only.

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 the names and addresses used by an actual businessenterprise is entirely coincidental.

Privacy Policy ConsiderationsIBM 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.

This Software Offering does not use cookies or other technologies to collectpersonally identifiable information.

If the configurations deployed for this Software Offering provide you as customerthe ability to collect personally identifiable information from end users via cookies


and 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/.

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.

Other product and service names might be trademarks of IBM or other companies.

Notices 43

http://www.ibm.com/privacy

http://www.ibm.com/privacy/details

http://www.ibm.com/software/info/product-privacy/

http://www.ibm.com/legal/copytrade.shtml

http://www.ibm.com/legal/copytrade.shtml

IBM®

Printed in USA

with ibm corp. · an api level of 18 or higher is r equir ed to build the andr oid apps. v t o...

Documents