Troubleshooting

How to use the troubleshooting guide

This page describes basic troubleshooting techniques and most frequent issues you may face during the application setup and usage.

The first part describes the basic tests to be made after you completed the configuration task list. Those test can reveal issues in the configuration and can help you to identify them.

The second part is a list of common issues and their causes. Look for the symptom and follow the tips. To know how to configure the product, please refer to the relevant pages in this guide.

Please understand that the problem may be related to complex PBX and network configurations, and that is not possible to list all them all. This guide must be considered as a tool to guess the origin of the issue.

Testing the AppSuite hospitality features should be done when the PMS interface is available and connected with your system.

However, the AppSuite web interface allows emulating PMS operations to verify the CuCM configuration before the PMS is available.

PBX integration basic tests

PBX integration tests must be executed in the following scenario.

Before continuing, make sure you created a list of rooms as described in the Hotel Pack Product Configuration section of this guide, and the PBX is configured. You only need two rooms, two lines and two IP phones to make the tests. Analog phones are not recommended for testing. You could also use two softphones such as Cisco IP communicator. The PBX must be able to place calls to the PSTN to test call costs postings. A mobile phone could be helpful to receive those calls.

In this example, we will assume you configured two rooms, 101 and 202

Guest name on the IP phone at check-in

Log onto the IAS web interface as administrator.
Click on Hospitality -> Room and guests.
Search for room 101.
The room status should be "vacant."
Double click on the room line in the room list to see the room details.
Click on the Check-in button.
Enter a first name and a last name for the guest and press "check-in".
If the room phone is a Cisco IP phone:
- Wait a minute. IP phone 101 will reset.
- After the reset, the IP phone should display the guest first name and last name.
- Place a call from the room phone to the reception
- Ensure the reception phone displays the guest name as calling party name, while ringing
- Click on the Checkout button.
- Wait a minute. IP phone 101 will reset.
- After the reset, the IP phone should display the word "Vacant".
If the room phone is an analog phone:
- Wait a minute.
- Place a call from the room phone to the reception
- Ensure the reception phone shows the guest name as calling party name, while ringing
- Click on the Checkout button.
- Wait a minute.
- Place a call from the room phone to the reception
- Ensure the reception phone shows "Vacant" as calling party name, while ringing

Phone locking

Log onto the IAS web interface as administrator.
Click on Hospitality -> Rooms and guests.
Search for room 101.
The room status should be "vacant."
Place a call from the IP phone with extension 101 to a PSTN number. The call should be blocked by StoneLock.
If you activated the Annunciator, you should hear an audio prompt before the call is dropped.

Double click on the room line in the room list.
Click on the Check-in button.
Enter a first name and a last name for the guest and press "check-in".
Place a call from the IP phone with extension 101 to a PSTN number. StoneLock should NOT block the call.

Click on the Checkout button.
Place a call from the IP phone with extension 101 to a PSTN number. The call should be blocked by StoneLock.
If the phone support this feature, a Lock icon should appear on the IP phone display.
Press the Directory button on the IP phone. The call history should be empty.

Call costs postings

Ensure your system can reach the PSTN, and that the tariff associated with the gateway has charges for calls towards mobile phone destinations.
Log onto the IAS web interface as administrator.
Click on Hospitality -> Rooms and guests.
Search for room 101.
Click on the Check-in button.
Enter a first name and a last name for the guest and press "check-in".
Place a call from the IP phone 101 to a mobile number and make the call last 30 seconds, then hang on.
Wait a minute, so that the CuCM can send the CDRs and Imagicle Billing can calculate the cost.
In the room web interface, select the "Placed calls" tab. The call should be reported with the cost.
If your call is not displayed, click on "refresh".

DND

Log onto the IAS web interface as administrator.
Click on Hospitality -> Room and guests.
Search for room 101.
The room status should be "vacant."
Double click on the room line in the room list to see the room details.
Click on the Check-in button.
Enter a first name and a last name for the guest and press "check-in".
Log onto the CuCM administration
Under Device -> Phone, locate the IP phone with the 101 DN
Enable the DND status. Check that the DND status is displayed on the phone
From the IAS web interface, checkout room 101
After one minute, the DND status should be removed from the IP the phone

How to check which devices support DND

Generate a Phone Feature List:

http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cucm/admin/11_0_1/featureConfig/CUCM_BK_FE5123E0_00_cucm-feature-configuration-guide_1101/feature_configuration_overview.html#CUCM_TK_I6C81EC3_00

Useful link:

http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cucm/admin/11_0_1/featureConfig/CUCM_BK_FE5123E0_00_cucm-feature-configuration-guide_1101/do_not___disturb.html#CUCM_TK_CC2A3159_00

Voicemail

Log onto the IAS web interface as administrator.
Click on Hospitality -> Rooms and guests.
Search for room 101.
Double click on the room line in the room list to see the room details.
Click on the Check-in button.
Enter a first name and a last name for the guest and press "check-in".
From the IP phone 202, place a call to 101 and leave a voicemail message.
On the IP phone 101, press the voicemail button and listen to the message.
Refresh the room web page. The Voicemail should show the voicemail message count.

Click on the Checkout button.
On the IP phone 101, press the voicemail button.
Press the "0" key to listen to new messages. There should be no messages.

Maid status

Log onto the IAS web interface as administrator.
Click on Hospitality -> Rooms and guests.
Search for room 101.
From the IP phone 101, dial the internal number associated to the Maid Status service.
Select a valid option and confirm.
Refresh the room web page. You should see the Maid Status label change to reflect the new status.
You may call the Maid Status service again to test other options.

Wakeup calls

Log onto the IAS web interface as administrator.
Click on Hospitality -> Rooms and guests.
Search for room 101.
Double click on the room line in the room list to see the room details.
Click on the Check-in button.
Enter a first name and a last name for the guest and press "check-in".
Click on the "new wakeup" link, and add a wakeup call that will ring in three minutes.
After three minutes, the IP phone 101 should ring.
Do not answer the call.
After one more minute, the IP phone 101 should ring again.
You may answer the call. Refresh the room details web page to see the result and the number of retries.

PMS integration basic tests

Before testing with the PMS, please make sure all the conditions required by the previous tests are met.

Then check the PMS interface to be sure the TCP connection with Hotel Pack is up.

To perform the tests, you need to access the PMS UI (User Interface).

PMS integration tests must be executed in the following scenario.

Guest name on the IP phone at check-in

On the PMS UI, make sure room 101 is vacant.
On the IAS Hotel Pack web interface, make sure room 101 is vacant.
On the PMS UI, check in a guest (entering First name and Last name) in room 101.
Wait a minute. IP phone 101 will reset.
After the reset, the IP phone should display the guest first name and last name.

On the PMS UI checkout room 101
Wait a minute. IP phone 101 will reset.
After the reset, the IP phone should display the word "Vacant".

Phone locking

On the PMS UI, make sure room 101 is vacant.
Place a call from the IP phone with extension 101 to a PSTN number. The call should be blocked by StoneLock.
If you activated the Annunciator, you should hear an audio prompt before the call is dropped.

On the PMS UI, check in a guest (entering First name and Last name) in room 101.
Place a call from the IP phone with extension 101 to a PSTN number. StoneLock should NOT block the call.

On the PMS UI, checkout room 101.
Place a call from the IP phone with extension 101 to a PSTN number. The call should be blocked by StoneLock.
If the phone support this feature, a Lock icon should appear on the IP phone display.
Press the Directory button on the IP phone. The call history should be empty.

Call costs postings

Ensure your system can reach the PSTN, and that the tariff associated with the gateway has charges for calls towards mobile phone destinations.
On the PMS UI, check-in a guest to room 101.
Place a call from the IP phone 101 to a mobile number and make the call last 30 seconds, then hang on.
Wait a minute, so that the CuCM can send the CDRs and Imagicle Billing can calculate the cost.
In the PMS interface, check the guest folio. The call should be reported with the cost.

Voicemail

On the PMS UI, check-in a guest to room 101.
From the IP phone 202, place a call to 101 and leave a voicemail message.
On the IP phone 101, press the voicemail button, select 0 and listen to the message. There should be one message.

On the PMS UI, checkout room 101
On the IP phone 101, press the voicemail button.
Press the "0" key to listen to new messages. There should be no messages.

Maid status

From the IP phone 101, dial the internal number associated to the Maid Status service.
Select a valid option and confirm.
On the PMS UI, check the room 101 cleanup status.
You may call the Maid Status service again to test other options.

Wakeup calls

On the PMS UI, check-in a guest to room 101.
Add a wakeup call for room 101 that will ring in three minutes (that is, same day, 3 minutes in the future).
After three minutes, the IP phone 101 should ring.
Do not answer the call.
After one minute, the IP phone 101 should ring again.
You may answer the call.
If the PMS supports this feature, you should see the wakeup call result on the PMS UI.

Room move

On the PMS UI, make sure room 101 and 202 are vacant.
On the PMS UI, check in a guest (entering First name and Last name) to room 101.
Wait a minute. Call line 101 and leave a voicemail message.
On the PMS UI, move the guest from room 101 to room 202.
On the IP phone 101, press the voicemail button, select 0 and listen to the message. There should be no message.
On the IP phone 202, press the voicemail button, select 0 and listen to the message. There should be one message.
Check the IP phone 202 display. It should show the guest name.

DND

On the PMS, set the DND status for room 101.
On the room 101 IP phones, the DND status should be displayed.
On the PMS, remove the DND status for room 101.
On the room 101 IP phones, the DND status should not be active.

Call Barring

Test at checkin

On the PMS, check in room 101 setting limiting the calls to "internal only"
Try to reach a PSTN number (e.g. a mobile number) from the room phone. The call should not be allowed
On the PMS, checkout room 101
Try to reach a PSTN number (e.g. a mobile number) from the room phone. The call should not be allowed (phone remains locked after checkout).

Test after checkin

On the PMS, check in room 101 setting limiting the calls to "unlimited"
Try to reach a PSTN number (e.g. a mobile number) from the room phone. The call should be allowed.
On the PMS, limit the calls for extension 101 to "internal only"
Wait two minutes
Try to reach a PSTN number (e.g. a mobile number) from the room phone. The call should not be allowed