Getting Started with Maximo Anywhere 5 Document version 0


Maximo Anywhere Install/Deployment



Download 152.5 Kb.
Page7/7
Date17.06.2017
Size152.5 Kb.
#20972
1   2   3   4   5   6   7

Maximo Anywhere Install/Deployment


  1. Choose IBM Maximo Anywhere from the Installation Manager 'Install Maximo Anywhere Work Manager' Screen.


  2. Complete the license agreements and on the 'Configuration for IBM Maximo Anywhere screen' enter the following properties. Note: Use lower case for the context root to simplify the user experience so they will not need to enter upper case characters in the URL.

    Worklight Server


    -----------------
    Protocol: http or https
    Hostname: Hostname of your Worklight console
    Port: Port uses to the access the Worklight console
    Context root: worklight

    War File: location of your worklight.war file

    Application Center
    -------------------
    Url: URL to the application center and port.  e.g http://appcenterhost:9081/
    Context Root: applicationcenter
    Username: Username defined for your app center console
    Password: Password defined for your app center console.

    Default username/password is appcenteradmin\admin. Password also may have been provided at the end of the Worklight install.

    Maximo Enterprise Application
    ------------------------------

    Protocol: Protocol used to access Maximo http or https


    Hostname: Hostname to your Maximo server
    Port: port for your Maximo server
    Context Root: context for Maximo.

    Android Platform


    -----------------
    SDK Directory: Location of your android SDK install folder
    AP Version: Version of the Android API for example: android-18


  3. Continue to finish installing the Maximo Anywhere files.


  4. Ensure your build.properties and deploy.properties in the following folder have the correct properties.

    MaximoAnywhere\platform\mobile\config




  5. From MaximoAnywhere\platform\mobile run

    build all-gen




  6. From MaximoAnywhere\platform\mobile run

    build all-dist




  7. Deploy the worklight.war file created under your MaximoAnywhere\platform\mobile\target\dist folder to your Worklight Server in WebSphere using the deployment instructions in the following document.

    http://pic.dhe.ibm.com/infocenter/wrklight/v5r0m6/index.jsp?topic=%2Fcom.ibm.worklight.help.doc%2Fadmin%2Fc_manually_configuring_app_server.html




  8. From MaximoAnywhere\platform\mobile run

    build all-deploy




  9. Access your Worklight Console and Application Center Console and ensure the mobile applications WorkApproval and WorkExecution exist.


  10. Download the applications using the IBM Admin Center application to connect to the App Center Console on the device, or test using Google Chrome and preview common resources.

Installing and Configuring Work Light Studio


  1. Open the Launchpad and choose 'IBM Worklight STudio for Worklight Consumer Addition'


  2. Check the boxes beside version 5.0.6 and choose next.


  3. Accept the license agreement and proceed with entering the installation directory. Ensure 32 bit is checked as WLStudio doesn't suppoer 64-bit. Click Next


  4. Check the following boxes and click Next

    Core Development Tools


    -JQuery Mobile Tools
    -Dojo Mobile Tools and library


  5. Choose the path of your Oracle JRE, (this must be a 32 bit installation of 1.6 Java) and click next to finish the installation.


  6. If you installed WL Studio onto a server with an existing eclipse installation, update the eclipse.ini using the steps in the following document.

http://pic.dhe.ibm.com/infocenter/wrklight/v5r0m6/index.jsp?topic=%2Fcom.ibm.worklight.help.doc%2Fdevenv%2Ft_next_steps.html

  1. Launch Worklight Studio from the IBM Software Delivery Folder in your start menu.


  2. Create a new Work Space for Worklight


  3. Go to Help - > Install New Software



  1. In the Work With: field enter https://dl-ssl.google.com/android/eclipse/ and click add

  2. Give your repository a name and the location will be pre-populated with the URL you entered in Work With:

  3. Click OK




  1. Check the box beside developer tools and click next twice, review the license agreement and click finish and restart WL Studio


  2. Once you enter the WL Studio again and choose your previous workspace you will be prompted for your Android SDK location, specify the directory to your Android SDK and click apply.


  3. Right Click in the Project Explorer and Choose Import, expand General and select "Existing Projects into Workspace". Click Next.


  4. Choose Select root directory and point to your MaximoAnywhere folder and click Finish.


  5. From the windows menu tab choose preferences, expand ant and select runtime.


  6. Click Ant Home and set it to c:\ibm\MaximoAnywhere\platform\mobile\releng\tools\ant




  7. Open the Ant view by going to the Window tab - > Show View - > Other - > Ant


  8. Drag the build.xml from your Project Explorer to the Ant view you previously opened.


  9. Confirm your properties files in the project explorer are correct and pointing to localhost and port 8080 for the build in worklight server then double click on all-gen from the Ant View


  10. Right click and refresh the Project Explorer, once done right click again and choose Import - > Import - > Import existing projects into workspace then select the following path and click ok and let the workspace build.

    MaximoAnywhere\platform\mobile\target\GEN\PROJ




  11. Once your MaximoAnywhere eclipse project shows up, right click on it and choose 'Start Worklight Server'


  12. Expand MaximoAnywhereProject - > Expand adapters - > Right click on 'OSLCGenericAdapter'  - > Choose 'Run As' - > 'Deploy Worklight Adapter'


  13. Expand MaximoAnywhereProject - > apps - > Right click on ' WorkApproval' -> Choose 'Run As' -> Build All and Deploy


  14. Expand MaximoAnywhereProject - > apps - > Right click on ' WorkExecutionl' -> Choose 'Run As' -> Build All and Deploy


  15. Access your applications via http://localhost:8080/console

SSL Configuration


1) Open your browser and navigate to the your Maximo environment using HTTPS. Download the certificate using your browser to a file (worklight_ssl.cer)

2) Import the Certificate into the Worklight Default KeyStore (This is done using the keytool bunbled with Java).

keytool -importcert -file c:\locationto\worklight_ssl.cer -trustcacerts -alias worklight -keystore defaut.keystore.worklight -storepass worklight

3) Update the worklight.properties to enable the default.keystore

ssl.keystore=conf/default.keystore.worklight
ssl.keystore.type=jks
ssl.keystore.password=worklight

4) Modify the OSLCGenericAdapter.xml and fine the sslCertificateAlias




${worklight.adapter.protcol}



${worklight.adapter.domain}

${worklight.adapter.port}



worklight            


5) Modify your deploy.properties so the following properties are changed for https

adapter.connection.protocol=https
adapter.connection.port=9443 ( or corresponding SSL port)

5) Rebuild the Worklight.war be issuing the following commands.

build.cmd all-gen
build.cmd all-dist

6) Redeploy the worklight.war to WebSphere using the following documentation.

http://pic.dhe.ibm.com/infocenter/wrklight/v5r0m6/index.jsp?topic=%2Fcom.ibm.worklight.help.doc%2Fadmin%2Fc_manually_configuring_app_server.html

7) Deploy the Anywhere application to the Worklight Console and the AppCenter Console by running

build.cmd all-deploy

Enabling Data Encryption for Maximo Anywhere


To enable data encryption for Maximo Anywhere do the following.

  1. Open up the build.properties from MaximoAnywhere\platform\mobile\config

  2. Search for enableDataEncryption and change the value from false to true.

  3. Rebuild and Redeploy the Worklight.war.

Post Installation Query Configuration

Once you have completed installation you will need to configure queries to download your work to the application. To do this you must go to the Work Order Tracking application in order to create a query for the Work Execution application.




  1. Create a public query that will return the data you desire for your technicians in the field. Once you are satisfied with the query results save the query and make note of the name you created. Note: It must be a public query.




  1. Edit the app.xml file for the work execution application. Navigate to the {maximoanywhere_home}\MaximoAnywhere\apps\{application_name} directory, on the Maximo Anywhere admin workstation. Open the app.xml file with the XML editor of your choice.

  2. Add a query to the work list view. The work list view is the first view that is defined in the UI section of the application definition. Perform the following steps:



  1. In the element for the work list view, add a child element called .

  2. Use the queryBase attribute to specify the name of the public query in Maximo Asset Management. The query name is case sensitive.

  3. Use the label attribute to specify the query label that is displayed in the work list menu.

  4. Optional: To define this query as the default query for the work list view, specify the query label as the value of the label attribute for the parent element.

NOTE: In the following example, we add three queries to the work list view for the Work Execution app:









<{Additional XML info is here.}>





  1. Add the query that you specified above to the primary resource. The primary resource is the first resource that you defined in the data section of the application definition. Follow these steps:



  1. In the queryBases element for the primary resource, add a child element called queryBase.

  2. Use the “name” attribute to specify the name of the public query in Maximo. The query name is case sensitive.

In this example, we add the same three queries used in the above example, to the primary resource, workOrder, for the Work Execution app:
describedBy="http://jazz.net/ns/ism/work/smarter_physical_infrastucture#WorkOrder"

name="workOrder" pageSize="100" >

<{A whole bunch of attributes appear here}>











<{More XML stuff here}>



  1. Save the file.

  2. Build and deploy the application.

Once you have completed this exercise you will be able to down load work orders to the device according to the queries you created.

Cautions and Limitations

Maximo Anywhere 7.5 is the initial release of an entirely new architecture around mobile computing. It is shipped with Worklight Studio to facilitate making small changes to the XML that controls the Maximo Anywhere applications. While Worklight is a very powerful platform that can be used to create applications, the license shipped with Maximo Anywhere limits the use of Worklight Studio and Worklight Server to the Maximo Anywhere applications only. In order to use Worklight for development of mobile apps an additional license must be obtained from IBM.


Because this is an initial offering using this new technology, the standards used to ensure upgradability of applications is still being developed. Any changes to applications will likely have to be manually migrated to new versions. In addition, changes to the business logic cannot be supported at this time.

Troubleshooting

Logging



Installation Manager Logs

The logs produced for error during the Mobile Anywhere install in the Installation Manager are found at the following path:

\\ProgramData\IBM\Installation Manager\logs

Maximo Anywhere apps Build/Deployment Logs

The logs produced for error during the Maximo Anywhere apps Build/Deploy process are found at the following path:

\\IBM\MaximoAnywhere\platform\mobile\target

Mobile logging

From the overflow menu on your mobile device select Settinges--> Advanced Settings --> Logging, On the Logging Data screen from the overflow menu select one of the following: Error, Info or Debug logging. Return to the worklist and reproduce the issue. Once you have this done, Go to the Logging Data screen from the overflow menu, and select Email Log. Disable logging when complete.



Server Logging

WebSphere Full Profile

If using a Full WAS Profile you would find the Server logging in the normal WebSphere logs location for your Worklight Server.

IBM\WebSphere\AppServer\profiles\WorklightProfiles\logs\WorklightServer\SystemOut.log

IBM\WebSphere\AppServer\profiles\WorklightProfiles\logs\WorklightServer\SystemErr.log

For more information about WebSphere profiles see the following link:

http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/topic/com.ibm.websphere.base.doc/ae/tpro_profiles.html



WebSphere Liberty Profile.

The server logs for the WebSphere Liberty Profile Setup are found in the following directory.

\\ProgramData\IBM\Worklight\WAS85liberty-server\wlp\usr\servers\worklightServer\logs

OSLC logging

From the Goto Menu choose System Configuration - > Platform Configuration - > Logging.

Filter for OSLC and change the logger from ERROR to INFO or DEBUG depending on detail of logging needed. Ensure an appender is set (Console, Rolling or Custom), then apply the settings from the Select Actions Menu. 

If the Console is set this will write to your Maximo SystemOut Logs in the following directory:

IBM\WebSphere\AppServer\profiles\MaximoProfile\logs\MaximoServer\SystemOut.log

If you are using a different appender then Console it will write to the path setup for your Root Logging Folder. You can check this from the Select Actions Menu.


Known Problems / Explanations or Solutions


Problem

1. If you happen to see this message when you start up the Worklight Server in Worklight Studio/JETTY server:

[2013-11-14 13:53:57] Worklight Server started successfully on localhost:8080

[2013-11-14 13:53:57] FWLSE4001W: Failed to resolve JNDI name: "jdbc/WorklightDS". Application may fail to access the database in run time. If building for remote server - ignore this warning.

[2013-11-14 13:53:57] FWLST0011E: ====== Worklight Project PROJ-project-customization failed to start: Need to specify class name in environment or system property, or as an applet parameter, or in an application resource file:  java.naming.factory.initial

[2013-11-14 13:53:57] Activation failed. Bundle didn't start:C:\Users\IBM_ADMIN\workspace2013-JETTY\ReleaseEngineering\ReleaseEngineering\target\GEN\PROJ\bin\PROJ-customization.jar

[2013-11-14 13:53:57] FWLST0012I: ====== Stopped server for project PROJ-project-customization


Resolution/Workaround:
1. Copy MaximoAnywhereProject/server/conf/worklight.properties to MaximoAnywhere/platform/mobile/target/GEN/PROJ/server/conf/worklight.properties

2. Refresh your MaximoAnywhereProject

3. Perform 'Build Project' on MaximoAnywhereProject

4. Perform 'Start Worklight Server' on MaximoAnywhereProject and it should come up.


Reason Why:
If you are running the jetty server, the worklight.properties cannot have any worklight settings. If you use the build scripts to execute the ‘all-dist’ command, it will update the worklight.properties with information from the config/worklight.war.

Problem

2. When trying to launch build.cmd command, the following error is displayed:

"The system cannot find the batch label specified - showJAVAErrorMessage"



Resolution/Workaround:

1. Confirm the JAVA_HOME environment variable is configured


2. Confirm the JAVA_HOME environment variable path does not contain a space.
(e.g. C:\Progra~1\Java\jdk1.6.0_18)

3. When trying to deploy Mobile Anywhere applications (build.cmd all-deploy), the following error is displayed:

For input string: "9081applicationcenter"
Perhaps the server or context is wrongly specified.

Resolution/Workaround:

1. In deploy.properties, ensure the following entry has the appending backslash (/) at the end:

worklight.appcenter.server.url

i.e. http://hostname:9081/



Problem

4. During the Maximo Anywhere installation, when selecting the Oracle JDK, the following error is displayed:

"The Oracle JRE bit mode must be the same as the bit mode of the product installation."



Resolution/Workaround:

1. Ensure a 32-bit java/javaw.exe is installed and chosen.

Download 152.5 Kb.

Share with your friends:
1   2   3   4   5   6   7



The database is protected by copyright ©ininet.org 2024
send message
    Main page
device connects