.. _config-insights-integration-with-cube: Configure Insights integration with CUBE -------------------------------------------- .. _25.3|VOSS-1557: Overview .......... This procedure configures Insights Arbitrator integration with Cisco Unified Border Element (CUBE) for call detail record (CDR) ingestion and monitoring. Once the CUBE is configured to send CDRs to the Arbitrator, CDR files are placed in the relevant directory (the folder name is the IP address of the CUBE), triggering the Arbitrator to parse the CDRs files so that the data will be available on the CUBE dashboard. .. note:: If you wish to monitor Cisco CUBE SRST/ISR status and display this data in the CUBE dashboard with an ssh probe over SNMP probe, run the following command: :: show voice dial-peer status * Queries syslog message for registered/unregistered to show voice registar pool * Queries the server via syslog and returns a list of all registered MAC addresses This procedure involves two steps: 1. :ref:`setup-cube-via-arb-cli` 2. :ref:`configure-cube-to-send-cdrs-to-arb` .. rubric:: Related topics * .. raw:: latex Insights Reference Dashboards (CUBE) in the Dashboard Administration Guide .. raw:: html Insights Reference Dashboards (CUBE) .. _setup-cube-via-arb-cli: Add the CUBE via the Arbitrator CLI ........................................ This procedure sets up the CUBE on the Arbitrator. 1. Log in to the Arbitrator CLI as admin. 2. On the **Administration** menu, select **Advanced ARB Options**. .. image:: /src/images/arb-cli-advanced-arb-options.png 3. In the **Main Menu**, press ``3`` to choose option 3, **Advanced**. .. image:: /src/images/arb-cli-advanced-arb-menu.png 4. In the **Network Menu**, press ``3`` to choose option 3, **Configure services**. .. image:: /src/images/arb-cli-network-menu.png 5. In the **Services Menu**, press ``4`` to choose option 4, **Cisco Services**. .. image:: /src/images/arb-cli-services-menu.png 6. In the **Cisco Services Menu**, press ``3`` to choose option 3, **Configure Cisco Unified Border Element (CUBE)**. .. image:: /src/images/arb-cli-cisco-services-menu.png 7. In the **Cisco CUBE Menu**, you can view, add, or delete Cisco CUBEs, or clear all Cisco CUBE configuration. In this case, to add a Cisco CUBE, press ``2`` to choose option 2, **Add Cisco CUBE**. .. image:: /src/images/arb-cli-cisco-cube-menu.png 8. Fill out the IP address of your CUBE to add its IP address to a folder on the Arbitrator. Press keyboard shortcut **Ctrl-X**. The CUBE's IP address is added to the following location on the Arbitrator: ``/chroot/scp/pub/cube/`` .. image:: /src/images/arb-cli-add-cube-2.png .. image:: /src/images/arb-cli-cube-folder-on-arb.png Once CDRs are placed in the directory created for the CUBE, Arbitrator parses the files and the data will be available on the CUBE dashboard. .. rubric:: Next steps * :ref:`configure-cube-to-send-cdrs-to-arb` .. rubric:: Related topics * .. raw:: latex Insights Reference Dashboards (CUBE) in the Dashboard Administration Guide .. raw:: html Insights Reference Dashboards (CUBE) .. _configure-cube-to-send-cdrs-to-arb: Configure the CUBE to send CDRs to the Arbitrator .................................................. This procedure configures the queue on a CUBE to send detailed CDRs to Arbitrator via SFTP to a specified server under given user credentials, with files flushed every one second, and using "primary sftp" keyword to set the SFTP destination. .. note:: Once the setup and configuration is complete, you can monitor CDR file creation and transmission status on CUBE via ``show`` commands or logs. The configuration typically involves: * Enabling file accounting on CUBE. * Specifying the SFTP server details, including IP/hostname, username, password, and directory path. Credentials and directory path depend on your SFTP server (Arbitrator) setup. The drop account username is "drop". You can set the drop account password via the **Administration** menu. See *Creating and managing SFTP users* in the Insights Security Guide. * Setting retry and file retention options as required. The flush parameter can be configured as needed. In this procedure we're configuring a maximum flush every second (parameter value of `1`). .. rubric:: Pre-requisites * :ref:`setup-cube-via-arb-cli` * Ensure port 22 is open outbound from the CUBE to the SFTP server. Typically, only FTP on port 21 is available. * Cisco CUBE version 14.6 and up. .. note:: Cisco CUBE version 14.6 and up support sending CDR files directly to an SFTP server. SFTP might not be supported directly for CUBE versions earlier than 14.6. .. rubric:: Configure CDR file accounting on CUBE with SFTP Perform this series of basic commands on CUBE: :: text enable configure terminal aw-accounting file cdr-format detailed primary sftp /path_ username password maximum cdrflush-timer 1 end write The table provides additional details for the parameters in the commands used to configure the CUBE, for example, in the following: :: primary sftp 172.16.0.240/cube/110.1.1.1 usr: drop pass: droppassword .. tabularcolumns:: |p{5cm}|p{10cm}| +-----------------------------+--------------------------------------------------------------------------------+ | Parameter | Description | +=============================+================================================================================+ | ``primary sftp`` | The primary address, which sets the SFTP destination. In the example, | | | ``172.16.0.240`` is the primary address. | +-----------------------------+--------------------------------------------------------------------------------+ | ``path`` | The IP address of the CUBE. In the example, this is ``110.1.1.1``. | +-----------------------------+--------------------------------------------------------------------------------+ | ``drop pass`` | Your drop password. | +-----------------------------+--------------------------------------------------------------------------------+ | ``maximum cdrflush-timer`` | Configurable retry and retention value, set to one (1) second in the example, | | | which does a maximum flush every second. | +-----------------------------+--------------------------------------------------------------------------------+ .. rubric:: Related topics * .. raw:: latex Insights Reference Dashboards (CUBE) in the Dashboard Administration Guide .. raw:: html Insights Reference Dashboards (CUBE)