Configuring the Mobile App Service

Mobile App Service is being deprecated. Please use API as a backend for the Mobile App instead.

You configure the Mobile App Service using the Web Configuration tool. By default, if you left the Run the Web Configuration check box selected on the Completed page of the Setup Wizard, the manager starts after you complete the installation.

You can launch the Web Configuration tool from the Windows Start menu or using the Alloy Control Panel.

INFO: For details, see Using the Alloy Control Panel.

NOTE: After you complete the initial configuration, you can always use the Web Configuration tool to modify your configuration. For details about available settings, see Pre-Configuration Considerations.

To configure the Mobile App Service:

  1. On the main menu of the Web Configuration tool, click File > Create > Mobile App Service. This step applies only if you cleared the Run the Web Configuration check box in the last step of the installation procedure on the Completed page of the Setup Wizard.
  2. On the Database page, specify the Database Access key that the Mobile App Service will use to connect to your ANX8 database.
    1. Click Import Key and import the Database Access Key. This populates the SQL Server and Database fields with the values from the imported key.

      INFO: For details, see Importing the Database Access Key and Distributing the Database Access Key.

    2. Fine-tune the database connection details, if needed: in the SQL Server field, enter the network address of the SQL Server, which may differ from the SQL Server name specified in the Database Access Key.

    Click Next.

  3. On the Web page, type a description of your web service. This description will help you and other administrators identify this Mobile App Service instance on the IIS server. Click Next.
  4. On the Installation Type page, specify where to install the Mobile App Service:
    • If you want to install the web service as a web site, i.e. to the root directory of a web site, click Install as a web site.
    • If you want to install the web service to a virtual directory on a web site, click Install into a virtual directory.

      INFO: For instructions, see Choosing Installation Type (Mobile App Service).

    Click Next.

  5. On the Web Site page, all web sites available on the IIS server are displayed. Choose the site where you want to install the Mobile App Service. If you are installing the web service as a web site, you can specify parameters for the new site. Click Next.
    • If you are installing the web service into a virtual directory, the Virtual Directory page opens. Proceed to the step describing the Virtual Directory page.
    • If you are installing the web service as a site, the Features page opens. Proceed to the step describing the Features page.
  6. On the Virtual Directory page, type the name of the virtual directory to create, or select an existing directory from the list.

    NOTE: The virtual directory name will become a part of the URL you will be using to access the Mobile App Service. For example, if your server's host name is "www.example.com," specifying "mp" as the Virtual Directory Name will result in the following URL: http://www.example.com/mp/.

    Click Next.

  7. On the Features page, click Next.

  8. On the Logo Image page, specify the logo for the Mobile App Service.

    • If you want to leave the default Alloy Software logo, click Next.
    • If you want the Mobile App Service to display a custom logo image, select the Custom image option, click Load, select the image file to import and click Open, then click Next.

      INFO: For details, see Customizing the Logo.

  9. On the Ready to Apply Settings page, review your settings. To make changes, click Previous to return to the relevant page or pages. When you have finished, click Apply. Wait for the Web Configuration tool to configure the web service.
  10. When completed, the Web Configuration tool displays a summary of applied settings.

    NOTE: After you complete the initial configuration, you can always use the Web Configuration tool to modify any settings.

Now the Mobile App Service is ready for use, and you can test it using a mobile device. You can also preview your Mobile App Service on a desktop computer using Chrome or Safari desktop browser.

NOTE: If your Mobile App Service does not work as expected and you need to send the debug information to our Support Team, click Help > Debug Information on the main menu. The Web Configuration tool will generate the WebConfigDebugInfo.txt file and open it in Notepad.

NOTE: If you want to view the log file, go to the Error Logs section at the bottom of the Web Configuration tool’s page and click View Details.

INFO: For details on Technical Support, see Contact Information.