Manage Repositories

Required Tenable Security Center User Role: Administrator

For more information, see Repositories.

Add a Repository

To add a repository:

  1. Log in to Tenable Security Center Director via the user interface.

  2. Click Repositories.

    The Repositories page appears.

  3. At the top of the table, click Add.

    The Add Repository page appears.

  4. Click the tile for the repository type you want to add.

    The Add Repository page appears.

  5. Configure the options for your repository. For more information, see Remote Repositories.

  6. Click Submit.

    Tenable Security Center Director saves your configuration.

View Your Repositories

To view a list of your repositories:

  1. Log in to Tenable Security Center Director via the user interface.

  2. Click Repositories > Repositories.

    The Repositories page appears.

  3. (Optional) To filter the repositories that appear on the page, apply a filter as described in Apply a Filter.

  4. View details about each repository.

    • Name — The name of the repository.

    • Vulnerability Count — The total number of vulnerability instances in the repository.

      Tip: A vulnerability instance is a single instance of a vulnerability appearing on an asset, identified uniquely by plugin ID, port, and protocol.

    • IP/Device Count — The total number of assets for which the repository contains vulnerability data.

    • Type — The repository type.

    • Capacity — (IPv4, IPv6, Agent, and Universal repositories only) The percentage of maximum available repository space you are currently using. The maximum repository size is 64 GB.

      Tip: For best performance, Tenable recommends splitting repositories larger than 32 GB.

    • Last Updated — The date and time the repository was last updated.

View Repository Details

To view repository details:

  1. Log in to Tenable Security Center Director via the user interface.

  2. Click Repositories > Repositories.

    The Repositories page appears.

  3. (Optional) To filter the repositories that appear on the page, apply a filter as described in Apply a Filter.

  4. Right-click the row for the repository you want to view.

    The actions menu appears.

    -or-

    Select the check box for the repository you want to view.

    The available actions appear at the top of the table.

  5. Click View.

    The View Repository page appears.

    Section

    Action

    General

    View general information for the repository.

    • Name — The repository name.

    • Description — The repository description.

    • IP Count — The total number of assets for which the repository contains vulnerability data.

    • Last Vuln Update — The date and time the repository was last updated.

    • Vulnerability Count — The total number of vulnerability instances in the repository.

      Tip: A vulnerability instance is a single instance of a vulnerability appearing on an asset, identified uniquely by plugin ID, port, and protocol.

    • Repository Capacity — (IPv4, IPv6, Agent, and Universal repositories only) The percentage of maximum available repository space you are currently using. The maximum repository size is 64 GB.

      Tip: For best performance, Tenable recommends splitting repositories larger than 32 GB.

    • Created — The date the repository was created.

    • Last Modified — The date the repository was last modified.

    • ID — The repository ID.

    Data

    View a summary of the repository data (for example, the IP address range). For more information, see Remote Repositories.

    Access

    View the name of the organizations with access to this repository.

    Advanced Settings

    View a summary of your settings for the repository. For more information about a setting, see Remote Repositories.

Edit a Repository

To edit a repository:

  1. Log in to Tenable Security Center Director via the user interface.

  2. Click Repositories > Repositories.

    The Repositories page appears.

  3. (Optional) To filter the repositories that appear on the page, apply a filter as described in Apply a Filter.

  4. Right-click the row for the repository you want to edit.

    The actions menu appears.

    -or-

    Select the check box for the repository you want to edit.

    The available actions appear at the top of the table.

  5. Click More > Edit.

    The Edit Repository page appears.

  6. Modify the repository options, as described inRemote Repositories.

  7. Click Submit.

    Tenable Security Center Director saves your configuration.

Export a Repository

You can export a repository from one Tenable Security Center and import it as an offline repository on another Tenable Security Center. You can export repositories via the Tenable Security Center user interface or the CLI. For more information, see Offline Repositories.

Note: Depending on the size of the repository database, this file can be quite large. It is important to save the file to a location with sufficient free disk space.

Export via the User Interface

To export a repository via the user interface:

  1. Log in to Tenable Security Center Director via the user interface.

  2. Click Repositories > Repositories.

    The Repositories page appears.

  3. Right-click the row for the repository you want to export.

    The actions menu appears.

    -or-

    Select the check box for the repository you want to export.

    The available actions appear at the top of the table.

  4. Click Export.

    Tenable Security Center Director exports the repository.

Export via the CLI

To export a repository via the CLI:

  1. Log in to Tenable Security Center Director via the command line interface (CLI).

  2. Prepare the command you want to run.

    sh /opt/sc/customer-tools/exportRepository.sh [repID] [trendingDays] [trendWithRaw]

    Variable

    Description

    repID

    The repository ID of the repository you want to export. To locate the repository ID, view the details for the repository, as described in View Repository Details.

    trendingDays

    (IP, Agent, and Universal repositories only) The number of days of vulnerability trending data to include. To use the preconfigured repository setting, type default.

    Note: The number of days of trending data included in the export cannot exceed the Days Trending setting for the repository or the number of days of trending data available for the repository. For example, if you request 30 days of trending data, but trending data has been enabled for only 15 days, then the export includes only 15 days of trending data. For more information about repository settings, see IPv4/IPv6 Repositories, Agent Repositories, and Universal Repositories.

    trendWithRaw

    (IP, Agent, and Universal repositories only) Specify whether you want the export to include plugin output data: yes or no. To use the preconfigured repository setting, type default.

    (Optional) To automatically overwrite an existing repository file with the same name, include the optional argument -f.

  3. In the CLI in Tenable Security Center Director, run the export command.

    For example:

    /opt/sc/customer-tools/exportRepository.sh -f 1 default default

    Tenable Security Center Director exports the repository.

Delete a Repository

To delete a repository:

  1. Log in to Tenable Security Center Director via the user interface.

  2. Click Repositories > Repositories.

    The Repositories page appears.

  3. Select the repository you want to delete:

    • To delete a single repository:

      1. In the table, right-click the row for the repository you want to delete.

        The actions menu appears.

      2. Click Delete.

    • To delete multiple repositories:

      1. In the table, select the check box for each repository you want to delete.

        The available actions appear at the top of the table.

      2. At the top of the table, click More > Delete.

    A confirmation window appears.

  4. Click Delete.

    Tenable Security Center Director deletes the repository.