Enabling the Anywhere Administration application

By default, the Anywhere Administration application is disabled. When you use the Anywhere Administration application to modify mobile apps, you do not need to rebuild and deploy the apps.

Before you begin

From Maximo® Asset Management, in the System Properties application, specify the host name value for the mxe.oslc.webappurl property. The mxe.oslc.webappurl property defines the public URL to find the OSLC resources. The default URL is http://localhost/maximo/oslc/.

About this task

You enable the Anywhere Administration application by setting the si.adminmode property in the worklight.properties file. After the Anywhere Administration application is enabled, you must load data into this application. You must load data any time that you add data resources to the provided Maximo Anywhere apps, remove data resources from the apps, or create custom apps.

You run an Ant script utility to load the data into the Anywhere Administration application. The utility is named admin-config-loader.xml and is in the Anywhere\MaximoAnywhere folder.

Data resources, such as provided queries and map settings, that are set in the app.xml file are ignored in favor of any data resources set by using the Anywhere Administration application.

Procedure

  1. From the worklight.properties file in the Anywhere\MaximoAnywhere\server\conf folder, locate the si.adminmode property and set this property to true.
  2. Run the build all command, which is build.cmd on Windows or build.sh on UNIX and Linux systems. The .apk or .ipa artifact file is generated, and all distributable files for the Maximo Anywhere project are deployed to MobileFirst Server.
  3. Deploy the project WAR file to MobileFirst Server.
    1. From the Server Configuration Tool, select Replace the project WAR file of a deployed runtime.
    2. Complete the steps in the wizard.
  4. Optional: To run the import utility in a development environment, specify the user name and password as arguments for the file.
    1. In MobileFirst Studio, add the admin-config-loader.xml Ant file to the Ant view.
    2. Right-click on the admin-config-loader.xml Ant file and select Run as > Ant Build.
    3. On the Main tab, add the user name and password for the adapter in the Arguments field. -Dadapter.connection.user=<user_name> -Dadapter.connection.password=<password>
  5. Load data into the Anywhere Administration application.
    Environment Action

    In a development environment in MobileFirst Studio

    Run the admin-config-loader.xml file from the Ant view.

    In a production environment

    Run this command:

    ant -f admin-config-loader.xml allApps

    The allApps parameter searches all the application folders for the provided Maximo Anywhere apps and any apps that you created.
  6. From Maximo Asset Management, in the Security Groups application, open each of the security groups associated with the Maximo Anywhere apps, for example, ANYWHERE_INSPECTOR.
  7. In the Applications tab for each of the security groups, find the Anywhere Administration application and grant rights to it.
  8. Access the Anywhere Administration application from the Integration module within Maximo Asset Management.
Related concepts:
Maximo Anywhere security groups
Related information:
MobileFirst Server Configuration Tool