Changing Mobile configuration property values

Modify the configuration properties in the mobile-config.xml file to control how users can interact with the Connections Mobile native app.

Before you begin

You must use the HCL® WebSphere® Application Server wsadmin client to check out the mobile-config.xml file. See Starting the wsadmin client for information.

About this task

To edit Mobile configuration properties, complete the following steps:


  1. Start the wsadmin client.
  2. Start the Files Jython script interpreter:
    1. Use the following command to access the Mobile configuration file:
      Tip: If you are asked to select a server, select any server.
    2. Check out the mobile-config.xml file by using the following command:

      MobileConfigService.checkOutConfig("working_directory", "cell_name")

      • working_directory is the temporary working directory to which the XML and XSD configuration files are copied. The files are kept in this working directory while you make changes to them.
        Note: AIX® and Linux only: The directory must grant write permissions or the command will not run successfully.
      • cell_name is the name of the WebSphere® Application Server cell hosting the HCL® Connections application. This argument is required. If you do not know the cell name, you can determine it by typing the following command in the wsadmin command processor:

        print AdminControl.getCell()

      For example:

      MobileConfigService.checkOutConfig("/opt/my_temp_dir", "CommServerNode01Cell")

  3. Create a backup copy of the file.
  4. Edit the file in a text editor.
  5. Save your changes and check the file in.
  6. Synchronize the nodes in your deployment.
  7. Restart the application server that hosts the Mobile Server application.

What to do next

You must check the configuration files back in after making changes, and they must be checked in during the same wsadmin session in which they were checked out.