Skip to main content

Manage agent installation packages

Learn how to create and download installation packages for Snow Inventory Agents for Windows, macOS, Linux, and Unix with Package Builder.

Go to Package Builder

  • To navigate to Package Builder in Snow Atlas, do one of the following:

    • If you are a SAM on Snow Atlas user, select Applications on the Snow Atlas menu, and then Package Builder.

      To navigate back to your SAM applications, select Applications, and then SAM.

    • If you are a Snow Atlas user with access exclusively to Package Builder, or if you are accessing Package Builder from the Partner Service Layer, you will find Package Builder directly in the Snow Atlas menu.

Create installation packages

Before you start creating your package, you should prepare the agent configuration file that you will upload to Package Builder during the process. For configuration file templates, see Configuration file templates.

  1. In Package Builder, select Create installation package.

  2. In the Package details section, enter the following information:

    1. In Package name, enter a name for the installation package.

      The name is used to help you distinguish it from other installation packages. It will not affect the name of any files included in the installation package.

    2. Optional: Customize the date for when the installation package will be deleted from Package Builder. By default, the package will be deleted after 30 days. If you want the package to be deleted at an earlier date, turn off the Use default expiration date toggle, and then select your date in Custom expiration date.

  3. In the Product section, select the agent and version for which you want to create an installation package.

    Depending on the selected agent, you may additionally have to select applicable architectures and package types. An installation package will be created for each combination of selected architecture and package type.

  4. Optional: In the Scanning modules section, select any additional files and scripts that you want to include in the installation package to give the agent additional capabilities. Available scanning modules depend on the agent selected in the previous step. See Scanning modules for descriptions of all capabilities.

    1. Turn on the toggle for a scanning module section and then select Customize.

    2. Select the scanning modules that you want to include, and then select Save.

      For some scanning modules, you can select to upload your own custom file instead of including the default file.

  5. In the Files section, upload the configuration file that you have prepared for this installation package, and then select Create.

The package is added to the list of packages. The Package status column enables you to keep track of the status of the package, for example, Building or Available for download. For a complete list of package statuses, see Package status.

If you have uploaded files to the package, other than the agent configuration file, you might have to take additional steps before the package can be built. In that case, the status of the package is set to Pending authorization. See Authenticate to build installation packages for instructions on how to proceed.

For instructions on how to download your created package, see Download installation packages.

You can preview the contents of your uploaded files before downloading the package, see Preview or download uploaded files.

Authenticate to build installation packages

When you create an installation package, you can upload your own custom files, see Step 4 of Create installation packages. If an uploaded file is of another format than XML, the package is added to the list of packages, but the build process for the package will not start. The status of the package is set to Pending authorization. A warning message will appear at the top of the page, prompting you to authenticate yourself before the package can be built.

As some file types other than XML may run a higher risk of containing malicious content, this is an added security measure to ensure that you are aware of, and take responsibility for, the contents of the files. If you have created several packages with the status Pending authorization, they will all be included in the same authentication process.

To authenticate yourself so that the packages can be built:

  1. In the warning message, select Authenticate and build.

  2. On the Confirm access page, select Continue.

    An email with a verification code will be sent to you.

  3. On the Confirm access page, enter the verification code sent to you, and then select Sign in.

The build process for the packages will now continue.

Preview or download uploaded files

To verify that your installation package contains the correct agent configuration file, as well as other files you may have uploaded to the package, you can preview the contents before downloading the package.

  1. In the list of packages, and in the Package name column, select the name of the package.

  2. In the Preview of included files view, select a file name from the list of files to view the contents, or download the file via the download icon.

    The configuration file is always displayed by default.

    Files with content other than plain text cannot be previewed but only downloaded.

  3. When you have finished your preview, do one of the following:

    • Download the package directly from the preview view: Select Action, and then select Download package.

    • Delete the package directly from the preview view: Select Action, select Delete package, and then confirm the action.

    • Close the view and return to the list of packages.

Download installation packages

You can download packages with the status Available for download.

  1. In the list of packages, select the checkboxes for the packages you want to download.

  2. Select Actions, and then select Download package.

Delete installation packages

  1. In the list of packages, select the checkboxes for the packages you want to delete.

  2. Select Actions, and then select Delete package.