• Products
  • Get started
  • Documentation
  • Resources

Configure the Assets Discovery collector

To use the Assets Discovery collector, you first must download the Assets Discovery software package and extract the contents, then configure the collector, and then run the local executable.

You must have Jira admin permissions - as well as administrator permissions on your Windows or Linux system - to use these tools.

Download and extract the Assets Discovery collector

The Assets Discovery collector is included in your Assets Discovery software package.

  1. Download the latest version of the Assets Discovery from the Atlassian Marketplace.

  2. Create a directory to hold the tool. Please note that Assets Discovery Tool must be able to both read and write data within this directory. 

    1. For Windows users, we recommend creating a new directory in C:\Program Files.

    2. For Unix users, we recommend creating a new directory in /opt/.

  3. Extract all of the files from the Assets Discovery package into your directory.

Configure the Assets Discovery Collector

  1. As an administrator on your Windows or Linux system, open a command-line interpreter window.

  2. Navigate to your Assets Discovery and type collector.exe -s in your terminal or command-line interpreter.

  3. Enter your password. If this is the first time you have used Assets Discovery you will be asked to enter and confirm a new password. This password must contain at least 8 characters including at least one uppercase, one lowercase, one numeric and one non-alphanumeric (symbol) character.

  4. Select the Common tab.

  5. Configure settings in the Common tab:

    1. Instance Prefix - Select a user defined string that allows the identification of different instances of the collector after they have been imported into Assets in Jira Service Management.

    2. Import Folder - Select the folder that contains the data from Assets Discovery.

    3. Import ZIP Password - If the data is stored in an encrypted Zip-File (recommended), the collector will require the password to extra the data.

    4. Export Interval - Select the interval (in minutes) for how often the collector will transfer data to the import folder.

    5. Export Type - Select an export type for transferring the data to another system. These are the options:

      1. None - the data will not transferred and available under the /scan folder.

      2. File Copy - transfer the data to a other local folder or a remote UNC-Path. You will have to provide the following information:

        1. File/Export Path - The destination path for the exported data. If you are using a remote folder you must use a full UNC-path. A mapped network drive path will not work.

      3. SFTP - transfer the data as per SSH File Transfer Protocol. You will have to provide a login and a password.

        1. File/Export Path - the destination path for the exported data. By default port 22 is used, you can use a different port by adding it with the a colon ':' as a modifier.

        2. Login - the user must have rights to write into the folder at the destination server.

        3. Password - the password for the user that is used for the authentication.

      4. SFTP RSA - transfer the data as per SSH File Transfer Protocol with RSA-Private-Key Authentication.

        1. File/Export Path - the destination path for the exported data. By default port 22 is used, you can use a different port by adding it with the a colon ':' as a modifier.

        2. Login - the user must have rights to write into the folder at the destination server.

        3. Passphrase - the passphrase of the RSA private key.

        4. RSA File - the local path to the RSA private key file of the user that is used for the authentication.

      5. You will have to provide a login, a password, and the local path to the RSA private key.

    6. Export ZIP Password - If desired, you can set a password for the zip file (AES-256). It is recommended to use encryption any time that data is transported.

    7. Log Level - Select the level of information to record in the log file:

      1. Normal - the logfile will only contain basic information.

      2. Debug - the logfile will contain detailed information that can help you debug problems when using the collector tool.

    8. Delete logs after (days) - LogFiles (and folders) will be deleted after the configured time. The default is 7 days.

    9. Change Password - Here you can change your settings password.

Enable the Assets Discovery service

If you wish to run the Assets Discovery collector as a service, you can enable it using the setup utility:

  1. Navigate to your Assets Discovery directory and type collector.exe -s in your terminal or command-line interpreter.

  2. Enter your password. If this is the first time you have used Assets Discovery you will be asked to enter and confirm a new password. This password must contain at least 8 characters including at least one uppercase, one lowercase, one numeric and one non-alphanumeric (symbol) character.

  3. Select the Common tab.

  4. Select Install Service.

You can also enable the Assets Discovery collector as a service using the command-line:

  1. As an administrator on your Windows or Linux system, open a command-line interpreter window.

  2. Navigate to your Assets Discovery directory and type collector.exe -i in your terminal or command-line interpreter.

Disable the Assets Discovery service

To disable the Assets Discovery collector service using the setup utility:

  1. Navigate to your Assets Discovery directory and type discovery.exe -s in your terminal or command-line interpreter.

  2. Enter your password. If this is the first time you have used Assets Discovery you will be asked to enter and confirm a new password. This password must contain at least 8 characters including at least one uppercase, one lowercase, one numeric and one non-alphanumeric (symbol) character.

  3. Select the Common tab.

  4. Select Uninstall Service.

You can also disable the Assets Discovery collector as a service by using the command-line:

  1. As an administrator on your Windows or Linux system, open a command-line interpreter window.

  2. Navigate to your Assets Discovery directory and type collector.exe -u in your terminal or command-line interpreter.

Additional Help