Install Assets Discovery
Download Discovery
- You can download Discovery for both Cloud and Data Center from the Atlassian Marketplace.
- If you're using Jira Service Management Data Center, note that Assets Discovery has two parts: the Discovery app and the Discovery tool.
Once you install the app, you can use it to download the Discovery tool. Go to Manage Apps > Assets Discovery > Discovery Download and download the tool from the link on the page.
Extracting Discovery
Assets Discovery is available in the form of a package that contains MSI (Microsoft Installer) installers for the Discovery Tools (Assets Discovery and the Assets Discovery collector) and the Assets Discovery Agent. Before you run Assets Discovery, you must unpack the package and install the application into a directory on your local system.
After downloading Discovery:
- Create a directory to hold the tool. Note that Assets Discovery Tool must be able to both read and write data within this directory.
- For Windows users, we recommend creating a new directory in
C:\Program Files. Or, you can use the default folderC:\Program Files\Atlassian\Discovery Tools, which is automatically selected when you run the installer. - For Unix users, we recommend creating a new directory in
/opt/.
- For Windows users, we recommend creating a new directory in
Unpack the files from the Assets Discovery package into your directory and install Discovery.
If you’re using a Windows machine, run
Discovery_Tools_Setup.msiinstaller package. If you’re installing the agent, use theDiscovery_Agent_Setup.msipackage.The agent installer allows you to configure the secure token either through the installer GUI or by using the command line parameter:
msiexec /i "Discovery_Agent_Setup.msi" /qn AGENTTOKEN="your_token_here". You can obtain the secure token from Assets Discovery. Once installed, the agent will be ready to communicate with the Discovery Tool immediately.
Additionally, you can configure a firewall rule to open a specified TCP port during installation by using the MSI user interface.
If you’re using a Linux machine, you'll need an additional package to unpack MSI.
How to use Assets Discovery
After downloading and installing Discovery, follow the four steps outlined below to start using Discovery:
| Step | Description |
|---|---|
Configure the settings in Assets Discovery | Before you can scan your local system you should configure settings such as the general settings for the tool, the settings that determine which patterns are detected, the range of IP addresses you want to scan, and the credentials that are used to access the assets in your network. Learn how to set up Assets Discovery |
| Prepare to import to Assets in Jira Service Management | Before you can start importing the data Discovery has scanned, you’ll need to create an import configuration in Jira Service Management:
|
| Run Assets Discovery | To generate information about your network, Assets Discovery must be run so it can scan your local system. Assets Discovery will generate a data file containing detailed information about your network and the devices in it. The default location of this data file is the |
| Make use of the data collected by Discovery | You can transfer the resulting data to a different location in three different ways:
|
You must have Jira admin permissions - as well as administrator permissions on your Windows or Linux system - to use these tools.
Importing data for the first time? Learn the best practices
Downgrade Assets Discovery
To downgrade your Assets Discovery to a previous version:
Backup your current configuration:
Run the following command:
Discovery.exe -backup. This will create a.zipfile named Discovery_Config_Backup.zip.Copy this backup file to a secure location.
Uninstall the current version of Assets Discovery from your system.
Download and install the desired lower version of Assets Discovery from the Atlassian Marketplace.
If you’re using Jira Service Management Data Center, you can download zip files of our previous versions from the maven repository.Extract your Discovery_Config_Backup.zip backup file into the installation directory of the newly installed lower version.
Ensure that all configurations are correctly restored and verify the functionality of the downgraded version.
Downgrade Discovery Agent
To downgrade your Discovery Agent to a previous version:
Backup your current configuration:
Run the following command:
Discovery_Agent.exe -backup. This will create a.zipfile named Agent_Config_Backup.zip.Copy this backup file to a secure location.
Uninstall the current version of Discovery Agent from your system.
Download and install the desired lower version of Discovery Agent.
Extract the Agent_Config_Backup.zip backup file into the installation directory of the newly installed lower version.
Ensure that all configurations are correctly restored and verify the functionality of the downgraded version.