Administration

Avaya – Deploying H.323 as XSTIM phones on UCX (Beta)

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.

USEFUL TIP

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 ModelLatest Supported
H.323 Firmware
Notes
16031.350BDoes not support PoE; requires a 5V power supply.
16081.350B 
16161.350BSupports the BM32 expansion module.
96086.8551Dual-column display.
96116.8551Dual-column display.
96203.280AAvailable in 9620L (low power) and 9620C (color) models.
96216.8551Touchscreen phone; UCX provides QTL=Off display format.
96303.220A 
96403.280A 
96416.8551Touchscreen phone; UCX provides QTL=Off display format.
96503.280AAvailable in 9650 (greyscale) and 9650C (color) models.
J1596.8551 
J1696.8551All J-Series phones with H.323 firmware boot as the same model type; UCX cannot currently differentiate them.
J1796.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:
USEFUL TIP

If using the Bulk Add feature, first fully configure a template extension (line appearances, call waiting, button configuration, etc.). 

USEFUL TIP

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 SecurityFirewallDefine Ports.
    AvayaH323-DefinePort.png
  • 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.
    AvayaH323-RAS2.png
  • 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.
    AvayaH323-CALL.png

Add Firewall Rules

  • Navigate to SecurityFirewallFirewall 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.
  • Click the Save button.
    AvayaH323-FirewallRule-RAS.png
  • Repeat the above steps and create a 2nd rule:
    • Set Protocol to TCP.
    • Set Source Port to Any.
    • Set Destination Port to H323-CALL (the second port created previously)
    • The rest of the fields can be left at default.
  • Click the Save button.
    AvayaH323-FirewallRule-CALL.png
  •  

Troubleshooting

IssueProbable 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.

Contents