Overview
Avaya H.323 phones can be registered to the E-MetroTel UCX and managed as XSTIM extensions. This page covers the recommended deployment method using the UCX’s integrated DHCP server on the eth2 or eth1 interface, with alternatives provided for other network configurations.
The instructions on this page assumes the Avaya phone is already running H.323 firmware. Just follow the 3 simple steps and you will have a working XSTIM phone.
Step 2 related to firmware management is optional.
Supported Models and Firmware
| Avaya Phone Model | Latest Supported H.323 Firmware | Notes |
|---|---|---|
| 1603 | 1.350B | Does not support PoE; requires a 5V power supply. |
| 1608 | 1.350B | |
| 1616 | 1.350B | Supports the BM32 expansion module. |
| 9608 | 6.8551 | Dual-column display. |
| 9611 | 6.8551 | Dual-column display. |
| 9620 | 3.280A | Available in 9620L (low power) and 9620C (color) models. |
| 9621 | 6.8551 | Touchscreen phone; UCX provides QTL=Off display format. |
| 9630 | 3.220A | |
| 9640 | 3.280A | |
| 9641 | 6.8551 | Touchscreen phone; UCX provides QTL=Off display format. |
| 9650 | 3.280A | Available in 9650 (greyscale) and 9650C (color) models. |
| J159 | 6.8551 | |
| J169 | 6.8551 | All J-Series phones with H.323 firmware boot as the same model type; UCX cannot currently differentiate them. |
| J179 | 6.8551 |
Unsupported Models:
- 9610, 9670, J129, and J139. J189.
- J100 models with a product ID ending in ‘630’ are 3PCC-only and do not support H.323.
Step 1 – Create XSTIM Extensions
Create one or more XSTIM extensions via UCX Administration using one of the following methods:
Reference Links:
If using the Bulk Add feature, first fully configure a template extension (line appearances, call waiting, button configuration, etc.).
If using Batch Configuration, you can create or update extensions using the Batch of Extensions CSV upload option. Include the MAC address column in the CSV for auto-registration.
Step 2 – Firmware Management
This step is optional. This is needed only if you want to update the firmware.
- Firmware: The phone firmware can be downloaded from the Avaya support site under “Avaya 9600 Series IP Deskphones” if you have permission from Avaya.
- UCX Hosting: To host Avaya H323 firmware on the UCX, place the files in the following directory: /avh323.
- External Server Hosting: If using a custom HTTP server, ensure the HTTPSRVR and HTTPDIR DHCP options point to the correct server and directory.
UCX Hosting
This is the simplest and recommended method.
- DHCP Server: Use the UCX’s built-in DHCP server on eth2 or eth1. It will automatically provide the necessary H.323 provisioning parameters.
- HTTP Server: If you have permission from Avaya, use the UCX to host the required Avaya H.323 firmware files. The UCX HTTP server is a light-weight server that provides basic functionality
External Server Hosting
DHCP Server
If using an external DHCP server, you must configure it to provide the Avaya H.323 parameters. This is typically done with Option 242 (some environments may use 176).
NOTE: Many consumer-grade routers do not support custom DHCP options. For these environments, using the UCX integrated DHCP server is the preferred method.
Example (dnsmasq syntax):
dhcp-option=242,MCIPADD=<UCX_IP>,MCPORT=1719,HTTPSRVR=<UCX_IP>,HTTPDIR=avh323
Example using UCX default eth2 IP:
dhcp-option=242,MCIPADD=192.168.10.200,MCPORT=1719,HTTPSRVR=192.168.10.200,HTTPDIR=avh323
Parameter Definitions:
- MCIPADD: IP address of the UCX.
- MCPORT: 1719 (the H.323 gatekeeper port).
- HTTPSRVR: IP address of the web server hosting Avaya H.323 files (can be the UCX or a custom server).
- HTTPDIR: avh323 (the directory path on the server where the files are located).
HTTP Server
Using a custom HTTP server allows for advanced features like phone backup/restore (via a custom 46xxsettings.txt file).
Step 3 – Configure and Register Phones
Connect the Avaya H.323 phones to the network that is on the same network segment as the UCX.
Power on the phone. It will boot and eventually show the Login prompt.
Auto-Registration
- If the phone’s MAC address was pre-populated in the XSTIM extension, it will register automatically. The phone’s home screen will display the assigned extension number.
Manual Registration
- At the “Enter extension and press Enter or OK” prompt, enter the extension number and press OK.
- When prompted for a password, leave the field blank and press Enter.
- If the screen shows “Phone is not registered“, press the CONFIG button on the phone.
- Follow the on-screen steps to register the phone to the specific extension.
Step 4 – Add Port and Rule in Firewall
This step is required only if the UCX Firewall is enabled.
Define Ports
- Navigate to Security – Firewall – Define Ports.

- Click on Define Port button to add a new port 1719:
- Enter a Name, e.g. H323-RAS.
- Set Protocol to UDP.
- Enter the Port range 1719 – 1719.
- Optionally enter a Comment.
- Click on the Save button.

- Repeat the above steps to create a 2nd port 1720:
- Enter a Name, e.g. H323-CALL.
- Set Protocol to TCP.
- Enter the Port range 1720 – 1720.
- Optionally enter a Comment.
- Click on the Save button.

Add Firewall Rules
- Navigate to Security – Firewall – Firewall Rules.
- Click on New Rule button to add a new rule:
- Set Protocol to UDP.
- Set Source Port to Any.
- Set Destination Port to H323-RAS (the first port created previously)
- The rest of the fields can be left at default.
Troubleshooting
| Issue | Probable Cause & Solution |
|---|---|
| Phone does not auto-register. | The extension’s MAC address is missing or incorrect. Verify the MAC on the extension and reboot the phone. |
| Login prompt keeps returning. | The password field was likely filled. Leave it blank. Confirm the extension exists and is an XSTIM type. |
| “Phone is not registered” message. | Press the CONFIG button and follow the on-screen steps to bind the phone to the extension. |
| No dial tone or audio after a network move. | Stale state in the UCX. Restart UCX telephony services or reboot the UCX. |
| J-Series shows as 9611. | This is normal behavior. The UCX cannot differentiate J-Series models at boot. |

