PBX connection error codes
The five codes returned by the "Test the connection" button of the appliance wizard. Each code: meaning, causes, resolution.
Summary
| Code | Meaning |
|---|---|
| AUTH_FAILED | The PBX refused the login, or the account cannot read the ticket files. |
| HOST_UNREACHABLE | The appliance could not reach the PBX within 10 seconds. |
| SSH_HOST_KEY | The OXE presents an SSH key different from the one pinned at the first connection. Collection of this site stops. |
| CDR_PATH_NOT_FOUND | The ticket folder does not exist on the PBX. |
| TLS_INVALID | The connection test failed on a certificate error. |
AUTH_FAILED
The PBX refused the login, or the account cannot read the ticket files.
- Causes
- Wrong password. OXE: account other than
mtclwithout read right on/usr4/account. OXO: wrongftp_nmcpassword. - Resolution
- Retype the credentials. OXE: grant read access to the folder (step 2). OXO: ask your Alcatel-Lucent integrator for the
ftp_nmcpassword.
HOST_UNREACHABLE
The appliance could not reach the PBX within 10 seconds.
- Causes
- Empty or wrong IP, port filtered by a firewall, SSH disabled on the OXE, FTP passive data ports blocked on the OXO. Also returned when the failure matches no other code.
- Resolution
- From the appliance network, test the port:
nc -v <PBX-IP> 22(OXE) or30021(OXO). Open the flow from the appliance to the PBX.
SSH_HOST_KEY
The OXE presents an SSH key different from the one pinned at the first connection. Collection of this site stops.
- Causes
- OXE reinstalled, CPU replaced, key renewed, or a third-party machine answering on the PBX address.
- Resolution
- Confirm the change with your telephony team. If it is legitimate, click "Re-approve the PBX key" on the "PBX SSH key changed" card of the dashboard. The re-approval is recorded in the audit log.
CDR_PATH_NOT_FOUND
The ticket folder does not exist on the PBX.
- Causes
- OXE: Taxation over IP license inactive, so
/usr4/accountis missing, or non-standard path on a virtualized OXE. OXO: custom CDR path entered by mistake. - Resolution
- OXE: check the license (step 1) and locate the folder with
find /usr -name "TAXA*". OXO: empty the CDR path field.
TLS_INVALID
The connection test failed on a certificate error.
- Causes
- Most often, an HTTPS port (443, 30443) entered instead of the collection port.
- Resolution
- Collection does not use TLS: enter port 22 (OXE) or 30021 (OXO). See OXO configuration.
Test OK but no ticket collected, or raw SSH messages: see troubleshooting.