.. _arbitrator-asset-configuration: Asset Configuration -------------------- .. _SP23|New config screen added to allow customer ndx file retention times. Default is 6 months.: .. _SP23|New PRI and SIP Trunk probes for Cisco Voice Gateways. Please reference Arbitrator Cisco PRI and SIP Probe Configuration for instructions.: .. _SP25|Webex API support added (Requires Dashboard SP66 Release for visualization).: .. _22.1|VOSS-934: .. _22.1|EKB-12298: .. _22.2|EKB-13343: .. _23.1|EKB-13157: .. _23.1|EKB-15145: .. _23.1|VOSS-986: .. _23.1|VOSS-1153: .. _23.2|EKB-14142: .. _23.2|EKB-16510: .. _23.3|EKB-17216: Overview ...................... On the **Asset Configuration** tab you can add, edit, and remove assets and asset groups, import or export assets, and configure monitor profiles. Assets can be any devices that are either sending data or from which data is being retrieved. Each asset can be assigned to a specific customer to create a multi-tenant environment. .. image:: /src/images/arb-asset-config-tab.png .. note:: A system log table (``insights_system_log``) logs user actions, and a user can create a dashboard to view these actions. .. rubric:: Related Topics .. raw:: html Log Search .. raw:: latex Log Search in the Dashboard Administration Guide Add an Asset Group ...................... To add a new asset group: 1. On the **Asset Configuration** tab, click the Plus icon (+) at the bottom left corner of the **Groups** panel. 2. Click in the new folder created in the panel, fill out a group name, and press **Enter**. 3. Save your changes. .. image:: /src/images/assurance-correlation-image28.png Add an Asset to a Group .......................... To add a new asset to a group: 1. On the **Asset Configuration** tab, select the asset group where you want to add an asset. 2. Click the Plus icon (+) at the bottom of the **Assets** panel. 3. On the **Properties** tab for the new asset, fill out at least the mandatory fields, **IP Address** and **Asset Name**, then select an asset type, if know, for example, group, router, firewall switch, or one of the other asset types listed in the drop-down. 4. On the **Interfaces** tab for the new asset, add new interfaces, one or more. 5. Click the **Check** icon to the right of the asset details panel to add the new asset. 6. Save your changes. .. image:: /src/images/assurance-correlation-image25.png .. note:: **Modification**: If present, then more than one asset in more than one group can be modified when *modifying* assets. Change bars are displayed next to each asset and group when the assets or groups modified, for example: .. image:: /src/images/insights-arb-assets-conf-change-bar.png Delete Assets ................. To delete assets in an asset group: 1. On the **Asset Configuration** tab, select the relevant group to display its assets. 2. From the **Assets** panel, select the checkbox for each asset in the group that you wish to remove (one or more). 3. Click the **Minus** icon (-) at the bottom of the **Assets** panel. 4. Click **Save**. .. image:: /src/images/assurance-correlation-image26.png Delete an Asset Group .......................... To delete an asset group: 1. On the **Asset Configuration** tab, select the asset group you wish to delete (one or more). 2. Click the **Minus** icon (-) at the bottom of the **Groups** panel. 3. Click **Save**. .. image:: /src/images/assurance-correlation-image24.png Assign a Probe to an Asset ............................. A probe is a script or set of commands that are saved in the system and can be used to gather data, to issue commands to systems, and to auto repair or send data. Assigning a probe to an asset is typically done to retrieve data from that asset. Commands such as an ``SNMP GET`` or an API call are used to retrieve data from a particular asset. To assign a probe to an asset: 1. On the **Asset Configuration** tab, select the relevant asset group to display its assets. 2. In the **Assets** panel, select the relevant asset in the group that the probe will run against, then click the **Wrench** icon for the asset to open the **Monitor Profile** screen, where you can add a monitor profile to the asset. 3. On the **Monitor Profile** screen, view available saved probes. 4. From the **Probe Group** pane, select and then drag the probe you want to assign to the asset to the **Template/Profiles** panel. .. image:: /src/images/assign-probe-to-asset-drag.png 5. Click the **Edit** icon (Green Pencil) at the relevant profile entry in the **Template/Profiles** panel (the probe group you dragged to the panel). 6. Edit the profile to define the frequency the probe runs, the credentials needed for the probe to run, the schedule for the probe to run. You can also choose to start it immediately. .. note:: For SP25, the frequency for Polycom devices is set at 5 minutes. 7. Click **Update** to save your changes and to return to the **Asset Configuration** tab. .. note:: In order to configure performance monitor probes for CUCM publishers and their related subscribers, the publisher IP address is used to create a probe with that **Cucm IP Address** value. Each related subscriber is then created as an asset and this probe is attached to each asset. Refer to the diagram below: .. image:: /src/images/cucm-publisher-subscriber-probes-assests-diagram.png Bulk Assign Probes to an Asset ................................... 1. In the Arbitrator **System Configuration** Gui, select the **Probes** icon to open the **PROBE CONFIGURATION** tab. .. image:: /src/images/arb-bulk-assign-probes.png 2. Click the Globe icon at the bottom of the **Groups** panel to open the **ASSIGN PROBES TO ASSETS** page. 3. From the **Probe Group** drop-down in the **Configure** panel, select a probe group. 4. From the **Assets** panel, expand the tree and select the checkbox for each asset where you want to to assign the selected probe group. .. note:: A green check mark adjacent to any asset indicates an existing assignment. .. image:: /src/images/assign-probes-to-assets.png 5. In the **Configure** panel, at **Create Profile**, configure frequency and credentials. 6. Click **Save** to assign the probe to all the assets you selected. Assign a Customer to an Asset ................................. Arbitrator ships with multi-tenancy, which allows different customers to see correlated or collected results of only their data. Within the configuration of assets, you can assign each asset to a specific customer. To assign a customer to an asset: 1. On the **Asset Configuration** tab, click the relevant asset group to display its assets. 2. In the **Assets** panel, click the Edit icon (pencil) for the relevant asset to open it's configuration screen. 3. On the **Properties** tab, click the down-pointing arrow at the **Customer** drop-down to view available customers. 4. Select the customer that the asset belongs to, then click the Blue Check Mark icon at the top right of the panel to update the configuration. 5. Click **Save**. .. image:: /src/images/assurance-correlation-image19.png Place an Asset in Maintenance Mode ..................................... Arbitrator allows any asset to be placed into maintenance mode. Placing an asset in maintenance mode stops Arbitrator from responding with alerts until the asset is removed from maintenance mode. Data is still collected, but no alerts are sent when an asset is in maintenance mode. 1. On the **Asset Configuration** tab, select the asset group to display its assets. 2. Select the asset you wish to place into maintenance mode. 3. Click the Pencil icon for the selected asset to open its configuration screen. 4. On the **Properties** tab, select the **Maintenance Mode** checkbox, then select the Blue Check Mark at the top right of the panel to update the configuration. 5. Click **Save** to save the maintenance mode settings. .. note:: You can filter the **Assets** panel to display any assets in maintenance mode by selecting **Maintenance** from the **Filter column** drop-down at the bottom of the **Assets** panel. .. image:: /src/images/insights-arb-maintenance-filter.png Export and Import Assets ............................... On the **ASSET CONFIGURATION** tab you can export and import an asset that you exported from another system. * When selecting asset groups, all assets belonging to those groups are selected (selecting individual assets will not take effect). * If the **Group Name** checkbox is selected, all assets are included - both **All groups** and **Ungrouped**. Export Assets '''''''''''''''''' 1. On the **Asset Configuration** tab, select a group to display its assets, and select relevant assets for the group. Alternatively, select **Group Name** at the top of the **Groups** pane to select all assets in all groups. 2. Click the **Export Assets** button (green down arrow at the bottom of the **Assets** panel) to launch the **Export CSV** dialog. 3. Fill out a CSV filename. You won't need to fill out the file extension, ``.csv``. 4. Click **Export** to create the export file, then view progress until the **Export finished** dialog displays. 5. Click **Download**. The CSV file is saved to a download location you choose. Import Assets ''''''''''''''''''' 1. On the **Asset Configuration** tab, click the **Import Assets** button (green up arrow at the bottom of the **Assets** panel) to launch the **Import Assets** dialog. 2. Click **Choose File**, then browse to an exported (and optionally modified) CSV file on your local computer. .. image:: /src/images/arbitrator-import-asset.png 3. Click **Import**. .. rubric:: Next steps * Assign probes to the imported assets - see *Assign a Probe to an Asset* in this guide. Asset CSV Format '''''''''''''''''' The following columns are in an exported CSV file: :: "Asset Name",Description,"IP Addres","MAC Address",Vendor, Model,Version,"Host Name",Alias,"Asset Group Name", "Type of Device(see below)","Device’s Timezone",Comments, "Physical Address","Customer Name","Site Name","Row Action" .. note:: * Mandatory fields are: ``Asset Name``, ``IP Addres``. * The ``"Row Action"`` column is used when importing and if it contains "delete", then the row will be deleted upon import. * Row uniqueness is the combination of: "IP Address", "Customer Name", "Site Name". If an asset found, its data will be updated. if not, new asset will be inserted under the asset group indicated in column "Asset Group Name". * The column "Asset Group Name" has to be unique. if an asset group is found, its data will be updated. If not, a new asset group will be inserted. * There are 2 entries in the import CSV: * An asset with data in all columns. Most important is the very first column "Asset Name". * An interface is a property of an asset. An interface only has data in from column "Description" to "Host Name". Most important is that it does not have data on the very first column "Asset Name". All CSV interface row(s) will be under an asset just right above it(them).