Readme for the IBM Maximo Anywhere 7.5.2.1 Windows apps

Content

Readme for the IBM Maximo Anywhere 7.5.2.1 Windows apps

Date: June 2015

Copyright(C) International Business Machines Corporation 2015.
All rights reserved. US Government Users Restricted Rights - Use, duplication
or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

=============================================================================
Table of contents
=============================================================================

1. Introduction
2. Files
3. Pre-installation considerations
4. Installation instructions
5. Post-installation tasks
6. Information resources
7. Notices

=============================================================================
1. Introduction
=============================================================================

To build and deploy Maximo Anywhere apps on Windows devices, ensure that the
following products are installed:

- Maximo Anywhere 7.5.2
- Maximo Asset Management 7.5.0.6, 7.5.0.7, or 7.6 with Maximo Integration
Framework and Open Services for Lifecycle Collaboration
- IBM MobileFirst Server 6.3.0.0

To deploy the apps to Windows devices, you must also ensure that the following
product is installed:
- Visual Studio Tools

The Maximo Anywhere apps are not supported on Windows RT on Tablet.
The Maximo Anywhere apps are not supported on Windows Phones.
Windows Tablet OS 8.1 is supported. However, Windows Tablet OS 8.0 is not
supported.

=============================================================================
2. Files
=============================================================================

The following files are included:

The MaximoAnywhereWindows7521Preview.zip:

- AnywherePlatformISMLib.zip
The AnywherePlatformISMLib.zip includes the latest platform files to support
Windows Tablets.

- MaximoAnywhereWindowsApps.zip
The MaximoAnywhereWindowsApps.zip includes Windows Tablet versions of the Maximo
Anywhere apps.

- OSLCPMP7521.zip
The OSLCPMP7521.zip contains the files required for the Create Actuals from Plan
feature.

Additionally, this ISM Library release adds full support for Android 5.0.1 (API 21) level devices.
Previously, our offline maps did not work in Android 5.0.1. We corrected the issue
by updating our ESRI version to 10.2.6.

2.1 Create Actuals from Plans feature (optional)

This release adds the Create Actuals from Plan feature. In Maximo Asset
Management, you can create a plan for labor, materials, and tools. If the plan was
executed with no changes to labor, and it doesn't include rotating assets, you can
apply the same plan to the Work Execution mobile app. From the Work Execution
mobile app, click Create Actuals from Plan. You can select the planned
transactions that you want to turn into actual transactions. When you click
Create, all of the planned transactions become actual transactions that you can
view from the Details screens.

Within the Work Execution app, you can change the plan to reflect the actual
transactions. From the Create Actuals from Plan screens, you can change the amount
of time for the labor transactions and for materials. You can also change the
quantity of tools.

See Post-installation tasks for instructions on enabling this feature.

=============================================================================
3. Pre-installation considerations
=============================================================================

Before you start the installation:

- Review the release notes for Maximo Anywhere 7.5.2.

URL:
http://www.ibm.com/support/knowledgecenter/SSPJLC_7.5.2/com.ibm.si.mpl.doc_7.5.2/common/relnotes.html

- Apply the latest patches for Open Services for Lifecycle Collaboration (OSLC).

- Make a backup of the existing Maximo Anywhere files.

- Install Visual Studio Tools in your Maximo Anywhere build environment.

=================================================================================
4. Installation instructions
=================================================================================

To install the apps, complete the following steps:

1. Download and extract the AnywherePlatformISMLib.zip file to the
<install_home>/MaximoAnywhere/platform directory.

2. The MaximoAnywhereWindows7521preview.zip file contains the MobileFirst
utilities that correspond to interim fix 2015-05-15-2203
of MobileFirst. Download the corresponding MobileFirst Studio and/or Server with
the same version number specified. You must manually
run Installation Manager to install the MobileFirst Server interim fix. If you are
using MobileFirst Studio, you must download and
upgrade to the interim fix by using the Eclipse Install and Upgrade process.

3. Manually update the build.properties file. From the
<install_home>/MaximoAnywhere directory,
in the build.properties file, update the envsToDeploy property to include Windows
operating systems. Change the
property value envsToDeploy=android, to envsToDeploy=android, windows8.

4. Add the following property to the build.properties file and set it to the path
that contains the Visual Studio Tools:
## locations of visual studio tools
visualstudio.install.path=C:/Program Files (x86)/Microsoft Visual Studio
12.0/Common7/Tools

5. Extract the MaximoAnywhereWindowsApps.zip file to the
<install_home>/MaximoAnywhere directory. Overwrite the existing MaximoAnywhere
directory.

6. Run the following command: build.cmd update-platform

7. Build and deploy the Windows apps to the Application Center and the MobileFirst
console by running the following command: MaximoAnywhere/build all

8. From the <mobilefirst_install_dir>/ApplicationCenter/installer directory,
download the IBMApplicationCenterWindowsStore.zip file to your Windows devices.

9. Extract the IBMApplicationCenterWindowsStore.zip file, and run
IBMApplicationCenter.exe.

10. Microsoft product keys are required for sideloading apps that are not
published to Windows Store. The product keys must be licensed
through Microsoft and installed on the mobile device operating system. For more
information see:

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

- Step 1 is not required. It is completed by the build and deployment process.

- Complete either Step 2A or Step 2B. If you complete Step 2A, the files that you
need are in the MaximoAnywhere/bin/windows_tablet_zips directory. Instead of
performing Step 2B, Substep 3, you can install the app package by using the IBM
MobileFirst Application Center.

11. Certificates are used to sign the apps. The certificates must be installed on
the mobile devices as trusted certificates.
Maximo Anywhere provides default certificates. The default certificates are
located in the windows8\native directory for each app. Each certificate is called
MaximoAnywhere_TemporaryKey.pfx. This is a temporary certificate that must be
replaced with your own certificate.

To create your own *.pfx certificate for each app:

- In Visual Studio Tools, open the app by double-clicking the *.jsproj file that
is located in the windows8\native directory.
- From Solution Explorer, double-click the package.appxmanifest file, and click
the Packaging tab.
- In the Choose Certificate dialog, select one of the options for including a
*.pfx certificate. The certificate is copied to the windows8\native directory for
the app.
- Click Save.

Repeat this process for each Maximo Anywhere app.

12. Start the IBM MobileFirst Platform Application Center app. Connect to your
MobileFirst Server, and download and install the Maximo Anywhere apps.

For more information about the Application Center, see the Knowledge Center:
URL:
https://www-01.ibm.com/support/knowledgecenter/SSHS8R_7.0.0/com.ibm.worklight.appadmin.doc/appcenter/r_ac_platform_reqs.html

=============================================================================
5. Post-installation tasks
=============================================================================

---------------------------------------------------
Adding users to the Maximo Anywhere security groups
---------------------------------------------------

For information about adding users and creating user records to security groups,
go to the Maximo Anywhere 7.5.2 Knowledge Center:
URL:
http://www.ibm.com/support/knowledgecenter/SSPJLC_7.5.2/com.ibm.si.mpl.doc_7.5.2/install/t_add_users_security.html

---------------------------------------------------
Enabling bar code scanning
---------------------------------------------------

For information about turning on bar code scanning, and on connecting Bluetooth
bar code scanners to mobile apps, see the following topics:

URL:
http://www.ibm.com/support/knowledgecenter/SSPJLC_7.5.2/com.ibm.si.mpl.doc_7.5.2/configure/t_activate_bar_code.html

URL:
http://www.ibm.com/support/knowledgecenter/SSPJLC_7.5.2/com.ibm.si.mpl.doc_7.5.2/configure/t_connect_scanners.html

---------------------------------------------------
Enabling the Create Actuals from Plan feature
---------------------------------------------------

To enable the Create Actuals from Plan feature, complete the following steps:

1. Download and extract the OSLCPMP7521.zip file (located in the
MaximoAnywhereWindows7521Preview.zip file) to the ..\IBM\SMP\maximo directory.

2. Run the script file oslcos_pmp/tools/maximo/en/oslcos_pmp/V7521_01.dbc on your
database by using the updatedb command in the ..\IBM\SMP\maximo\tools\maximo directory.

3. Build and deploy the EAR file.

4. Open the ...\IBM\Anywhere\MaximoAnywhere\anywhere-rdfs-puller.xml file, and
remove the comment tagging from the following line:

<!-- downloadOneRdf context="/oslc/shapes/oslcwodetail/invreserve" /-->

5. Run the rdf-puller by using the following command: build.cmd -f anywhere-rdfs-
puller.xml

6. Back up your existing Work Execution app.xml, located in
<install_home>/IBM/Anywhere/MaximoAnywhere.

7. Apply the Create Actuals from Plan changes to your Work Execution app.xml file.

The code that applies to Create Actuals from Plan is commented out.

8. In the Work Execution app.xml file (located in the
MaximoAnywhereWindowsApps.zip file), search for the commented lines that contain
"Create Actuals From Plan functionality", as in the following example:

<!-- Uncomment the view below to enable Create Actuals From Plan
functionality -->

Remove the comment tagging from each of these lines of code.

9. Build and deploy the Maximo Anywhere apps using the following command: build
all

---------------------------------
Importing custom OSLC resources
---------------------------------

For information about importing custom OSLC resources, go to the Maximo Anywhere
7.5.2 Knowledge Center:
URL:
http://www.ibm.com/support/knowledgecenter/SSPJLC_7.5.2/com.ibm.si.mpl.doc_7.5.2/integration/t_import_resource_data.html


=============================================================================
6. Information resources
=============================================================================

For more information about your product, support resources, and connecting and
collaborating with others through blogs, wikis, and forums, please use the following links.


IBM Maximo Anywhere 7.5.2 Knowledge Center

Description: Access the Knowledge Center to view the product documentation. Topics
include product overviews; installation and configuration tasks; instructions for using,
configuring, and troubleshooting the product; and security information.

URL:
http://www.ibm.com/support/knowledgecenter/SSPJLC_7.5.2/com.ibm.si.mpl.doc_7.5.2/welcome.html


Asset Management community on Service Management Connect

Description: Use Service Management Connect to access product blogs, wikis,
forums, and communities. In Service Management Connect, you can review information about best
practices, performance and tuning, and product integrations. You can also collaborate with
IBM experts and access continuous open betas.

URL:
https://www.ibm.com/developerworks/servicemanagement/am/

IBM Maximo Anywhere Support Portal

Description: The IBM Support Portal provides access to tools and resources to keep
your systems, software, and applications running smoothly. From the Support Portal
you can find fixes, service requests, useful links and an enhanced search to help
you find information quickly.

URL:
http://www.ibm.com/support/entry/portal/product/tivoli/maximo_anywhere

Maximo Asset Management support portal

Description: Use the Maximo Asset Management Support Portal to download software
fixes, product documentation, tools, and resources.

URL:
http://www.ibm.com/support/entry/portal/product/tivoli/maximo_asset_management?productContext=-2077426143#

=============================================================================
7. Notices
=============================================================================

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

IBM may have patents or pending patent applications covering subject
matter described in this document. The furnishing of this document
does not grant you any license to these patents. You can send license
inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information,
contact the IBM Intellectual Property Department in your country or
send inquiries, in writing, to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan

The following paragraph does not apply to the United Kingdom or any
other country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of
express or implied warranties in certain transactions, therefore,
this statement may not apply to you.

This information could include technical inaccuracies or
typographical errors.

Changes are periodically made to the information herein; these
changes will be incorporated in new editions of the publication. IBM
may make improvements and/or changes in the product(s) and/or the
program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided
for convenience only and do not in any manner serve as an endorsement
of those Web sites. The materials at those Web sites are not part of
the materials for this IBM product and use of those Web sites is at
your own risk.

IBM may use or distribute any of the information you supply in any
way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for
the purpose of enabling:

(i) the exchange of information between independently created
programs and other programs (including this one) and

(ii) the mutual use of the information which has been exchanged,
should contact:
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758 U.S.A.

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

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

Information concerning non-IBM products was obtained from the
suppliers of those products, their published announcements or other
publicly available sources. IBM has not tested those products and
cannot confirm the accuracy of performance, compatibility or any
other claims related to non-IBM products.

Questions on the capabilities of non-IBM products should be
addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are
subject to change or withdrawal without notice, and represent goals
and objectives only. This information contains examples of data and
reports used in daily business operations. To illustrate them as
completely as possible, the examples include the names of
individuals, companies, brands, and products. All of these names are
fictitious and any similarity to the names and addresses used by an
actual business enterprise is entirely coincidental. If you are
viewing this information softcopy, the photographs and color
illustrations may not appear.


Trademarks

IBM, the IBM logo, and ibm.com are trademarks or registered
trademarks of International Business Machines 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
www.ibm.com/legal/copytrade.shtml.

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

Linux is a registered trademark of Linus Torvalds in the United
States, other countries, or both.

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

Privacy Policy Considerations

IBM Software products, including software as service solutions, (Software
Offerings) may use cookies or other technologies to collect product usage
information, to help improve the end user experience, to tailor interactions
with the end user, or for other purposes.
In many cases, no personally identifiable information is collected by the Software
Offerings.
Some of our Software Offerings can help enable you to collect personally
identifiable information. If this Software Offering uses cookies to collect personally
identifiable information, specific information about this offerings use of cookies is
set forth below.

Depending on the configuration that is deployed in the application server, this
Software Offering may use session cookies for session management. These cookies
can optionally be enabled or disabled, but disabling the cookies will also disable
the functionality that they enable. See the application server documentation for
additional information.

Optionally, you can also use functionality, such as typeahead, to store data
locally on the browser. The data that is stored locally could contain personally identifiable
information.
For more information, see the Data validation topic in the Maximo Asset Management
Information Center:

http://pic.dhe.ibm.com/infocenter/tivihelp/v49r1/topic/com.ibm.mbs.doc/designer/c_ctr_data_validation.html

If the configurations that are deployed for this Software Offering provide you as
customer the ability to collect personally identifiable information from end users by using
cookies and other technologies, you should seek your own legal advice about any laws that
are applicable to such data collection, including any requirements for notice and consent.

For more information about the use of various technologies, including cookies, for
these purposes, see IBMs Privacy Policy at http://www.ibm.com/privacy, IBM's Online Privacy
Statement at http://www.ibm.com/privacy/details in the section entitled Cookies, Web Beacons
and Other Technologies, and the IBM Software Products and Software-as-a-Service Privacy
Statement at http://www.ibm.com/software/info/product-privacy.