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 via the user interface.

  2. Click Repositories > 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 type:

  6. Click Submit.

    Tenable Security Center saves your configuration.

What to do next:

  • If you added an offline repository, export one or more repositories from your other Tenable Security Center as described in Export a Repository.

  • If you added an offline repository, import one or more exported repository files as described in Import a Repository.

View Your Repositories

To view a list of your repositories:

  1. Log in to Tenable Security Center 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 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

    		 Repository Type

    Action

    General

    All

    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.

    MDM

    Mobile

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

    Data

    IPv4/IPv6, Agent, Remote, Offline, Universal

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

    Access

    All

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

    Advanced Settings

    IPv4/IPv6, Agent, Remote, Offline, Universal

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

    Tenable Synchronization Data

    All supported for Tenable Lumin synchronization

    View synchronization summary data:

    • Status — The status of the repository in Tenable Lumin synchronization: 

      • Finished — The most recent synchronization that included this repository succeeded.

      • Not Synced — The repository is not configured for Tenable Lumin synchronization.

      • Error — An error occurred. For more information, see View Tenable One Data Synchronization Logs.

    • First Synchronization — The date and time of the first synchronization of this repository.

    • Last Success — The date and time of the most recent synchronization of this repository.

    • Last Failure — The date and time of the most recent failed synchronization of this repository.

    For more information about Tenable Lumin synchronization, see Tenable One Synchronization.

    Vulnerability Data Lifetime

    IPv4/IPv6, Agent, Universal

    View the data expiration settings for the repository. For more information, see:

Edit a Repository

To edit a repository:

  1. Log in to Tenable Security Center 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 inIPv4/IPv6 Repositories, Mobile Repositories, Agent Repositories, Universal Repositories, Remote Repositories, or Offline Repositories.

  7. Click Submit.

    Tenable Security Center 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.

Tip: If the repository you want to export has trend data enabled and you want to include trend data in your repository export, export the repository via the CLI. Repositories that you export via the user interface do not include trend data. For more information about trend data, see IPv4/IPv6 Repositories, Agent Repositories, and Universal Repositories.

Export via the User Interface

To export a repository via the user interface:

  1. Log in to Tenable Security Center 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 exports the repository.

Export via the CLI

To export a repository via the CLI:

  1. Log in to Tenable Security Center 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, run the export command.

    For example:

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

    Tenable Security Center exports the repository.

What to do next:

  • To import the repository to another Tenable Security Center, add an offline repository to that Tenable Security Center, as described in Add a Repository.

Import a Repository

You can import one or more repository files to an offline repository. For more information, see Offline Repositories.

Note: When importing the repository archive, the default maximum file import size is 360MB. This is specified by the post_max_size directive in /opt/sc/support/etc/php.ini. If larger file uploads are required, increase the default value.

Before you begin:

  • Export one or more repository files from your other Tenable Security Center, as described in Export a Repository.
  • Add an offline repository, as described in Add a Repository.

To import an exported repository to an offline repository:

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

  2. Click Repositories > Repositories.

    The Repositories page appears.

  3. Right-click the row for the offline repository you created.

    The actions menu appears.

    -or-

    Select the check box for the offline repository you created.

    The available actions appear at the top of the table.

  4. Click Upload and browse to the file you want to upload.

    Tenable Security Center imports the repository.

Delete a Repository

To delete a repository:

  1. Log in to Tenable Security Center 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 deletes the repository.