Test the Mobile App Setup

This step is a part of the Setup Checklist for Mobile App.

 

Start and Test the Website

  1. In the SMC tree, select Websites > [website].
  1. In the Management tab toolbar, click Start .
  • If the website start fails, check whether there are any other running websites that use the same ports. If so, either Stop the other websites or change the conflicting port numbers.
  1. Copy the website URLs from the Details expander and test them in a browser. Check that the https:// website is accessible from the same computer running the IIS web server, and also from other computers:
  • The website may be accessible over the Internet or only within an intranet, depending on the network configuration of the host computer.
  • If the website is not accessible from other computers, see the section Configure Firewall Ports below.
  • If the website uses an SMC-generated host certificate, you may get a certificate error when browsing the https:// URL from computers that do not have the corresponding root certificate installed.

Configure Firewall Ports to Make the Website Accessible

Configure the network and computer firewalls so that, on the IIS web server computer, the HTTPs port that you selected for the website is enabled for inbound and outbound communication. Note that:

  • If the website is only accessible inside an intranet, the mobile app will likewise only be able to connect from within that same intranet.
  • If you want the mobile app to connect over the Internet, the website on the IIS web server must be accessible over the internet.

 

Test the Web Services for the Mobile App

Do this procedure to check that the web application was correctly set up and is accessible.

  • In the SMC tree, select Websites > [parent website] > [web services app].

Check that the Web Services URL is Accessible

  1. In the Web Application Details expander, check that the Status is Accessible. If the Status is Website stopped, go back and start the parent website.
  1. Check the URL the mobile app will connect to: Use a browser to check that the topmost URL (the one beginning with https://) in the Web Application Details expander is accessible from other computers. This is the URL that you will use to log in from the mobile app.
  • The URL may be accessible over the Internet or only within an intranet, depending on the network configuration of the IIS web server computer.
  • If the parent website uses an SMC-generated host certificate, you may get a certificate error when browsing the https:// URL from computers that do not have the corresponding root certificate installed.
  • Otherwise, you should be able to establish a secure connection (https:// with no browser warnings) to a page that displays: URL not supposed to be displayed in a browser but entry point for API access.
  • Configure the firewall of the computer running the IIS web server so that the HTTPs port that you selected for the parent website is enabled for inbound and outbound communication.

(Optional) Test the Web Services Interface APIs

  • (Optional) Test the APIs provided by the Web Service Interface:
  • Use a browser such as Chrome, Firefox, or Internet Explorer (disable compatibility mode) to navigate to the Help URL provided in the Web Services Details expander.
  • The Web Service Interface test page displays. Here you test the different APIs provided by WSI. (Note that some APIs require authenticating with username and password). Username : defaultadmin and its password (for example, defaultadmin:a).
  • To test any API, expand it and access it using the Try it out button.

 

Try Connecting from a Mobile Device

As a final step, check if you can use the mobile app.

  1. Install the mobile app on a mobile device.
  1. If the parent website uses an SMC-generated host certificate, make sure to install the corresponding root certificate on the device as well.
  1. Start the app and sign in, and check that the app is able to connect to Desigo CC.

NOTE: For detailed instructions, see Installing and Connecting the Mobile App.