Quick Search
Browse
Pages
Blog
Labels
Attachments
Mail
Advanced
What’s New
Space Directory
Feed Builder
Keyboard Shortcuts
Confluence Gadgets
Log In
Dashboard
TIM Enterprise
Copy Page
You are not logged in. Any changes you make will be marked as
anonymous
. You may want to
Log In
if you already have an account. You can also
Sign Up
for a new account.
This page is being edited by
.
Paragraph
Paragraph
Heading 1
Heading 2
Heading 3
Heading 4
Heading 5
Heading 6
Preformatted
Quote
Bold
Italic
Underline
More colours
Strikethrough
Subscript
Superscript
Monospace
Clear Formatting
Bullet list
Numbered list
Outdent
Indent
Align left
Align center
Align right
Link
Table
Insert
Insert Content
Image
Link
Attachment
Symbol
Emoticon
Wiki Markup
Horizontal rule
tinymce.confluence.insert_menu.macro_desc
Info
JIRA Issue
Status
Gallery
Tasklist
Table of Contents
Other Macros
Undo
Redo
Find/Replace
Keyboard Shortcuts Help
<p><span><span>To get enhanced call logging data, install our CXD Connector tool to act as a relay between TIM Enterprise and your 3CX PBX.</span></span></p><p><span><span>CXD Connector circumvents the built-in SMDR functionality of the 3CX, so there's no need to configure any SMDR settings.</span></span></p><p><span><span>You can install the Linux version of CXD Connector directly onto your 3CX if you have root access to it, or you can install the Windows version to a separate computer, such as the one which TIM Enterprise is installed on.</span></span></p><table class="wysiwyg-macro" data-macro-name="info" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2luZm99&locale=en_GB&version=2); background-repeat: no-repeat;" data-macro-body-type="RICH_TEXT"><tr><td class="wysiwyg-macro-body"><p><span><span>CXD Connector is a read-only tool; it neither modifies your 3CX configuration nor directly accesses any 3CX internal databases</span></span></p></td></tr></table><p><span style="color: rgb(55,65,81);font-size: 1.8em;font-weight: bold;">Installing CXD on your 3CX</span></p><p><span style="color: rgb(55,65,81);font-size: 10.0pt;">Using SSH, connect to your 3CX using a privileged user account, then enter the following commands:</span></p><table class="wysiwyg-macro" data-macro-name="code" data-macro-parameters="language=bash|theme=RDark" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2NvZGU6dGhlbWU9UkRhcmt8bGFuZ3VhZ2U9YmFzaH0&locale=en_GB&version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre> cd /var/tmp wget https://esd.tri-line.com/open/cxd/cxd_latest_amd64.deb apt install -f ./cxd_latest_amd64.deb </pre></td></tr></table><p><span style="color: rgb(55,65,81);font-size: 10.0pt;">This will start the text-based installer which consists of a series of prompts to enter the settings described below. Press ENTER at any prompt to accept the default value shown in square brackets.</span></p><p><span style="color: rgb(55,65,81);font-size: 10.0pt;">If you enter an invalid value (e.g. a port you've chosen is already in use) you will be prompted again until a valid value has been entered. To abort the installation, press <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2J1dHRvbm1hY3JvOkxhYmVsPUNUUkwrQ30&locale=en_GB&version=2" data-macro-name="buttonmacro" data-macro-parameters="Label=CTRL+C">.</span></p><table class="confluenceTable"><tbody><tr><th class="confluenceTh">Prompt</th><th class="confluenceTh">Description</th></tr><tr><td class="confluenceTd"><strong>HTTP port [5080]</strong></td><td class="confluenceTd">The default HTTP port to use for web requests.</td></tr><tr><td class="confluenceTd"><strong>HTTPS port [5443]</strong></td><td class="confluenceTd">The default HTTPS port to use for web requests.</td></tr><tr><td class="confluenceTd"><strong>TCP port [7000]</strong></td><td class="confluenceTd">The port used by CXD to emit live event data over a TCP connection. This is the port used when setting up the connection in TIM Enterprise.</td></tr><tr><td class="confluenceTd"><strong>Authentication Key [<a class="confluence-link unresolved" data-content-title="xxxxxxxxxxxxxxxx" data-linked-resource-default-alias="xxxxxxxxxxxxxxxx" href="#">xxxxxxxxxxxxxxxx</a>]</strong></td><td class="confluenceTd">Choose a secret that you will also use when setting up the connection in TIM Enterprise. Press ENTER without typing a secret if you want to accept the random secret the installer has generated for you.</td></tr><tr><td class="confluenceTd"><strong>Register product </strong><strong>[YES]</strong></td><td class="confluenceTd"><p>You can choose to register the installation with your Tri-Line account. If you select <strong>YES</strong>, you'll be asked for your <strong>Tri-Line Gateway</strong> login details: username (email) and password.</p><p>If you skip this step, you can assign the installation to a customer account later in the Tri-Line Gateway using your web browser.</p></td></tr></tbody></table><p>After completing the steps above, the installer automatically enrols with the licensing service and starts CXD automatically.</p><p>To connect TIM Enterprise to your newly-installed CXD service, see <a class="confluence-link" href="#configuring_tim_enterprise" data-anchor="configuring_tim_enterprise" data-linked-resource-default-alias="configuring_tim_enterprise" data-base-url="http://localhost:8090">Configure TIM Enterprise</a> below.</p><div><span style="color: rgb(80,80,80);"><br /></span></div><p><span style="color: rgb(55,65,81);font-size: 1.8em;font-weight: bold;">Installing CXD on a separate Windows computer</span></p><p><span style="color: rgb(55,65,81);"><span>To get a copy of the Windows version of the CXD Connector, submit a support ticket through our online Gateway or send an email to </span><a class="external-link" href="mailto:support@tri-line.com" rel="nofollow">support@tri-line.com</a><span>.</span></span></p><p><span style="color: rgb(55,65,81);">Once you have the installation package, before you begin installation, please check you have the following information to hand:-</span></p><ul><li>IP address of your 3CX PBX</li><li>A username and password of a privileged account (e.g. root) that the installer can use to SSH in to your 3CX.</li></ul><p> </p><p><span style="font-size: 10.0pt;">Once you have obtained your copy of the CXD Connector installation package, run it and follow these steps:</span></p><ol><li>Choose an installation location:<br /><span style="color: rgb(80,80,80);"><img class="confluence-embedded-image" src="/download/attachments/30937087/setup_cxd_server.png?version=1&modificationDate=1749355487489" data-image-src="/download/attachments/30937087/setup_cxd_server.png?version=1&modificationDate=1749355487489" data-linked-resource-id="31042069" data-linked-resource-type="attachment" data-linked-resource-default-alias="setup_cxd_server.png" data-base-url="http://localhost:8090" data-linked-resource-container-id="30937087" title="null > setup_cxd_server.png"><br /></span></li><li><span style="color: rgb(80,80,80);"><span style="color: rgb(80,80,80);">On the “Select Components” section, leave all options selected as default and click <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2J1dHRvbm1hY3JvOkxhYmVsPU5leHR9&locale=en_GB&version=2" data-macro-name="buttonmacro" data-macro-parameters="Label=Next"> </span><span style="color: rgb(80,80,80);">.</span></span></li><li>On the “<strong>Ready to install</strong>” section, click on <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2J1dHRvbm1hY3JvOkxhYmVsPUluc3RhbGx9&locale=en_GB&version=2" data-macro-name="buttonmacro" data-macro-parameters="Label=Install">.</li><li>Once the installation is complete, the CXD configuration screen will be displayed:<br /><img class="confluence-embedded-image" src="/download/attachments/30937087/cxd_configuration.png?version=1&modificationDate=1749355487520" data-image-src="/download/attachments/30937087/cxd_configuration.png?version=1&modificationDate=1749355487520" data-linked-resource-id="31042072" data-linked-resource-type="attachment" data-linked-resource-default-alias="cxd_configuration.png" data-base-url="http://localhost:8090" data-linked-resource-container-id="30937087" title="null > cxd_configuration.png"><br /><span style="color: rgb(80,80,80);">Enter the IP address of your 3CX PBX in the first field. The username and password fields </span><span style="color: rgb(80,80,80);">should be those of a privileged SSH user on your 3CX.</span><br /><span style="color: rgb(80,80,80);">When you've entered the details, click <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2J1dHRvbm1hY3JvOkxhYmVsPU5leHR9&locale=en_GB&version=2" data-macro-name="buttonmacro" data-macro-parameters="Label=Next"> to attempt the connection to the 3CX.</span><br /><br /></li><li><span style="font-size: 10.0pt;">After a successful connection has been established, the next screen allows you to set the ports that CXD will provide, as well as an API Secret:<br /><img class="confluence-embedded-image" src="/download/attachments/30937087/cxd_configuration_2.png?version=1&modificationDate=1749355487515" data-image-src="/download/attachments/30937087/cxd_configuration_2.png?version=1&modificationDate=1749355487515" data-linked-resource-id="31042071" data-linked-resource-type="attachment" data-linked-resource-default-alias="cxd_configuration_2.png" data-base-url="http://localhost:8090" data-linked-resource-container-id="30937087" title="null > cxd_configuration_2.png"><br />The API Secret is randomly generated, but you can choose your own.</span><br /><span style="font-size: 10.0pt;">When you've made a note of these details - they'll be needed when connecting TIM Enterprise to CXD - click <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2J1dHRvbm1hY3JvOkxhYmVsPU5leHR9&locale=en_GB&version=2" data-macro-name="buttonmacro" data-macro-parameters="Label=Next">.<br /></span></li><li><span style="color: rgb(80,80,80);">When the wizard completes, it automatically starts the CXD Service:</span><span style="color: rgb(80,80,80);"><br /><img class="confluence-embedded-image" src="/download/attachments/30937087/cxd_complete.png?version=1&modificationDate=1749355487494" data-image-src="/download/attachments/30937087/cxd_complete.png?version=1&modificationDate=1749355487494" data-linked-resource-id="31042070" data-linked-resource-type="attachment" data-linked-resource-default-alias="cxd_complete.png" data-base-url="http://localhost:8090" data-linked-resource-container-id="30937087" title="null > cxd_complete.png"></span></li></ol><table class="wysiwyg-macro" data-macro-name="html" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e2h0bWx9&locale=en_GB&version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre><a id="ConnectusingCXD-configuringtimenterprise"></a></pre></td></tr></table><p><span style="color: rgb(80,80,80);font-size: 1.6em;font-weight: bold;">Configuring TIM Enterprise</span></p><p><span style="font-size: 10.0pt;">Now you've installed CXD, either directly on to your 3CX or on a separate Windows computer, you need to log in to TIM Enterprise and create a connection to the CXD service:</span></p><div><ol><li>Add a new site object by first navigating to the <strong>Directory</strong> tab.<br /><img class="confluence-embedded-image" src="/download/attachments/30937087/directory.png?version=1&modificationDate=1749355487538" data-image-src="/download/attachments/30937087/directory.png?version=1&modificationDate=1749355487538" data-linked-resource-id="31042076" data-linked-resource-type="attachment" data-linked-resource-default-alias="directory.png" data-base-url="http://localhost:8090" data-linked-resource-container-id="30937087" title="null > directory.png"></li><li>Click on '<strong style="font-size: 10.0pt;">New object</strong><span style="font-size: 10.0pt;">'</span><br /><span style="font-size: 10.0pt;"><img class="confluence-embedded-image" src="/download/attachments/30937087/new_object.png?version=1&modificationDate=1749355487535" data-image-src="/download/attachments/30937087/new_object.png?version=1&modificationDate=1749355487535" data-linked-resource-id="31042075" data-linked-resource-type="attachment" data-linked-resource-default-alias="new_object.png" data-base-url="http://localhost:8090" data-linked-resource-container-id="30937087" title="null > new_object.png"></span><span style="font-size: 10.0pt;"><br /></span></li><li><span style="font-size: 10.0pt;"><span style="color: rgb(80,80,80);">Select '</span><strong>Site</strong><span style="color: rgb(80,80,80);">', and type the name of the site as follows:</span></span><br /><span style="font-size: 10.0pt;"><span style="color: rgb(80,80,80);"><img class="confluence-embedded-image" src="/download/attachments/30937087/Add_site.png?version=1&modificationDate=1749355487473" data-image-src="/download/attachments/30937087/Add_site.png?version=1&modificationDate=1749355487473" data-linked-resource-id="31042067" data-linked-resource-type="attachment" data-linked-resource-default-alias="Add_site.png" data-base-url="http://localhost:8090" data-linked-resource-container-id="30937087" title="null > Add_site.png"><br /></span></span></li><li><span style="font-size: 10.0pt;"><span style="color: rgb(80,80,80);">Go to the Site, and click on '<strong>Open</strong>' as shown below:</span></span><br /><span style="font-size: 10.0pt;"><span style="color: rgb(80,80,80);"><img class="confluence-embedded-image" src="/download/attachments/30937087/Open_site.png?version=1&modificationDate=1749355487468" data-image-src="/download/attachments/30937087/Open_site.png?version=1&modificationDate=1749355487468" data-linked-resource-id="31042066" data-linked-resource-type="attachment" data-linked-resource-default-alias="Open_site.png" data-base-url="http://localhost:8090" data-linked-resource-container-id="30937087" title="null > Open_site.png"><br /></span></span></li><li><span style="font-size: 10.0pt;"><span style="color: rgb(80,80,80);">Select '</span><strong>PBX</strong><span style="color: rgb(80,80,80);">' from the '<strong>Other object</strong>' list and enter a name for the 3CX site, e.g. "Manchester 3CX", then click <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2J1dHRvbm1hY3JvOkxhYmVsPUFkZH0&locale=en_GB&version=2" data-macro-name="buttonmacro" data-macro-parameters="Label=Add"> at the bottom right.</span></span><br /><span style="font-size: 10.0pt;"><span style="color: rgb(80,80,80);"><img class="confluence-embedded-image" src="/download/attachments/30937087/pbx_object.png?version=1&modificationDate=1749355487531" data-image-src="/download/attachments/30937087/pbx_object.png?version=1&modificationDate=1749355487531" data-linked-resource-id="31042074" data-linked-resource-type="attachment" data-linked-resource-default-alias="pbx_object.png" data-base-url="http://localhost:8090" data-linked-resource-container-id="30937087" title="null > pbx_object.png"><br /></span></span></li><li>Choose '<strong>Establish TCP connection to PBX</strong>' as the <strong>Method</strong>.</li><li>In the <strong>Details</strong> panel, enter the following details:<br /><strong>Host</strong><span style="color: rgb(80,80,80);">: The IP address of the computer you installed CXD on (either the 3CX itself or another computer running Windows)</span><br /><strong>Port</strong><span style="color: rgb(80,80,80);">: Enter the TCP port you chose during CXD setup</span><br /><strong>Username</strong><span style="color: rgb(80,80,80);">: Leave empty.</span><br /><strong>Password</strong><span style="color: rgb(80,80,80);">: The ‘<em>API Secret</em>’ you created when setting up CXD.<br /></span><strong>IP script</strong><span style="color: rgb(80,80,80);">: Select '<em>3CX CXD</em>' from the drop-down list.</span><br /><img class="confluence-embedded-image" src="/download/attachments/30937087/3CX-Enterprise.png?version=1&modificationDate=1749355487482" data-image-src="/download/attachments/30937087/3CX-Enterprise.png?version=1&modificationDate=1749355487482" data-linked-resource-id="31042068" data-linked-resource-type="attachment" data-linked-resource-default-alias="3CX-Enterprise.png" data-base-url="http://localhost:8090" data-linked-resource-container-id="30937087" title="null > 3CX-Enterprise.png"></li><li><span style="color: rgb(51,51,51);">One of the benefits of using the CXD Connector method is that TIM Enterprise can synchronise its user details with those on your 3CX automatically; if you change a user's details on your 3CX, it will automatically update in TIM Enterprise's directory.<br />Add a new object of type '<strong>Directory Sync</strong>', enter a name, then click <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2J1dHRvbm1hY3JvOkxhYmVsPUFkZH0&locale=en_GB&version=2" data-macro-name="buttonmacro" data-macro-parameters="Label=Add">:</span><br /><span style="color: rgb(51,51,51);"><img class="confluence-embedded-image" src="/download/attachments/30937087/3CX_Directory_Sync.png?version=1&modificationDate=1749355487463" data-image-src="/download/attachments/30937087/3CX_Directory_Sync.png?version=1&modificationDate=1749355487463" data-linked-resource-id="31042065" data-linked-resource-type="attachment" data-linked-resource-default-alias="3CX_Directory_Sync.png" data-base-url="http://localhost:8090" data-linked-resource-container-id="30937087" title="null > 3CX_Directory_Sync.png"><br /></span></li><li><span style="color: rgb(51,51,51);">Right-click on the sync object you just created, and choose '<strong>Properties...</strong>':</span><br /><img class="confluence-embedded-image" src="/download/attachments/30937087/3C_sync_properties.png?version=1&modificationDate=1749355487455" data-image-src="/download/attachments/30937087/3C_sync_properties.png?version=1&modificationDate=1749355487455" data-linked-resource-id="31042064" data-linked-resource-type="attachment" data-linked-resource-default-alias="3C_sync_properties.png" data-base-url="http://localhost:8090" data-linked-resource-container-id="30937087" title="null > 3C_sync_properties.png"></li><li><span style="color: rgb(51,51,51);">Select how often you'd like TIM Enterprise to synchronise its directory with your 3CX, then press <img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2J1dHRvbm1hY3JvOkxhYmVsPVNhdmV9&locale=en_GB&version=2" data-macro-name="buttonmacro" data-macro-parameters="Label=Save">:</span><br /><span style="color: rgb(51,51,51);"><img class="confluence-embedded-image" src="/download/attachments/30937087/Sync_options.png?version=1&modificationDate=1749355487450" data-image-src="/download/attachments/30937087/Sync_options.png?version=1&modificationDate=1749355487450" data-linked-resource-id="31042063" data-linked-resource-type="attachment" data-linked-resource-default-alias="Sync_options.png" data-base-url="http://localhost:8090" data-linked-resource-container-id="30937087" title="null > Sync_options.png"></span><span style="color: rgb(51,51,51);"><br /></span></li></ol></div><div>You should now have a working connection via CXD to your 3CX!</div><div>Make a test call, then select the '<strong>Call View</strong>' tab at the top of the screen to show your calls.</div><p><span style="color: rgb(55,65,81);"><br /></span></p>
Attachments
Labels
Location
< Edit
Preview >
Loading…
Save
Cancel
Next hint
search
attachments
weblink
advanced