Set up Assets Discovery Collector
Assets Discovery Collector is a tool that allows you to run multiple instances of Assets Discovery in parallel and integrate those results into one data set. You can also use Collector to scan a network remotely and transfer the resulting data to a different location.
Before you begin
- Download and install Assets Discovery
- You must have Jira Admin permissions as well as administrator permissions on your Windows or Linux system to install Assets Discovery.
Configure the various settings and run Collector
To start using Collector, you should configure its settings:
- As an administrator on your Windows or Linux system, open a command-line interpreter window.
This is required to write into the destination folder if you chooseC:\Program Files
or it will be needed to install Collector as a service. - Navigate to your Assets Discovery folder and type
collector.exe -s
in your terminal or command-line interpreter. - 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.
- Select the Common tab.
- Configure settings in the Common tab.
- To run the collector, open a command prompt window with administrator permissions, navigate to your Assets Discovery directory and type
collector.exe
.
Collector parameters
You can also use parameters to configure the settings of Assets Discovery Collector, show the current version, enable or disable Assets Discovery Collector as a service, or reset your password. To see all the available commands, type Collector -?
.
Command | Description |
---|---|
| Without a start up parameter, the collector will start a scan with the stored Settings |
| Open and configure the collector settings |
| Shows the version number of the collector |
| Installing Collector as a Service This is only available when you're using the Discovery Tool on Windows. |
| Installing Collector as a Service using a specific user account. |
| Uninstalling the Collector service This is only available when you're using the Discovery Tool on Windows. |
| Reset your password when you forgot it. |
Enable the Assets Discovery Collector service
On Windows-based systems, Collector can be used as an optional scheduled service that runs periodically.
If you wish to run tAssets Discovery Collector as a service, you can enable it using the setup utility:
- Navigate to your Assets Discovery directory and type
collector.exe -s
in your terminal or command-line interpreter. - 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.
- Select the Service tab.
- Select Install service.
- Next, install the service as a user. Select Custom User Account and enter the username in the format
Domain\Login
and the password. This user must be a member of the default Administrator group.The Standard System Account is selected by default. The service runs with system-level privileges. This is not recommended due to extensive privileges.
To disable the service, select Uninstall.
You can also enable the Assets Discovery Collector as a service using the command-line:
- As an administrator on your Windows or Linux system, open a command-line interpreter window.
- Navigate to your Assets Discovery directory and type
collector.exe -i
in your terminal or command-line interpreter. For a Custom User Account, typecollector.exe -i -user=<login> -password=<password>
.
To disable the service, type collector.exe -u
.
Collector settings
Here’s some of the basic settings you can configure in the Common tab.
Setting | Description |
---|---|
Instance Prefix | A user defined string that allows the identification of different instances of Collector after collector settings have been imported into Assets in Jira Service Management. |
Import Folder | The folder that contains the data from Assets Discovery (for example, multiple instances). |
Import ZIP Password | If the data is stored in an encrypted Zip-File (recommended), the collector will require the password to extra the data. |
Export Interval | Select the interval (in minutes) for how often the collector will transfer data to the import folder. |
Export Type | Select an export type for transferring the data to another system (either the Collector server or Jira Service Management). More about export type options |
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. |
Log Level | Select the level of information to record in the log file:
|
Delete logs after (days) | LogFiles (and folders) will be deleted after the configured time. The default is 7 days. |
Change Password | Here you can change your settings password. |
Install Service/Uninstall Service | This is available only when you're using the Discovery Tool on Windows. This allows you to install or uninstall Collector as a Windows service from the GUI. |