Troubleshooting Guide
If, after following the configuration procedures above, your Mobile Ticket setup still does not work as expected, we suggest that you check your configuration by following the steps below. Use a tool such as Advanced REST client or Postman to perform the REST calls.
For more information about REST calls that can be used for the Mobile Ticketscenario, through the API Gateway, please see the API Gateway SDK documentation.
1. Perform the REST call below, to verify that you have a successful connection to Orchestra central (using port 8080)
You need to replace “serviceId” and “branchId” with valid Id numbers from your configuration. Also, you need to use Basic Authorization and the
Username and
Password for the
mobile user (set in
Parameters in the
System Administration application, in Orchestra).
/qsystem/mobile/rest/v2/services/serviceId/branches/branchId/ticket/issue/
If the REST call successfully issues a ticket, you have verified that the connection works.
2. To verify that your connection through the API Gateway is correctly configured, perform the following trial REST call through API Gateway.
Make sure that you have set the correct authorization, using your
auth-token and that you replace
[serviceId] and
[branchId] with valid Id numbers from your configuration.
/MobileTicket/services/[serviceId]/branches/[branchId]/ticket/issue
If the REST call is successful and a ticket is issued, you have verified that the connection works.
3. Start the node.js server, from a command prompt, with the following command:
npm start
4. Check that the web page and UI works as expected, by entering https://<your ip-address>:4443 in the browser address field.
The table below contains some answers to some Frequently Asked Questions:
Question | Answer |
Why are my Branches not available, in the Branch selection list? | In Orchestra, make sure that the check box Mobile enabled is checked for all the Branches that you want to be listed. |
Why are my Services not available, in the Service selection list? | In Orchestra, make sure that the check box Mobile enabled is checked for all the Services that you want to be listed. |
Why can I not create a mobile ticket? | In Orchestra, make sure that the VisitApp unit type is installed. Make sure that API Gateway is configured correctly. |
Why is my connection to Orchestra/API Gateway not working properly? | Make sure that you have opened up port 9090, in your firewall, see
“Prerequisite - Windows Control Panel:” . Make sure that API Gateway is configured correctly. |