Integrate with the Lansweeper App for Jira Service Management Assets

[sophie]

This page provides instructions for installing and configuring the Lansweeper App for Jira Service Management Assets.

---

The Lansweeper App for Jira Service Management Assets enables seamless and efficient asset management. This integration fetches Lansweeper Assets and synchronizes them directly to Jira Service Management Assets, ensuring that your asset inventory is consolidated and up-to-date. You can schedule syncs at specific intervals based on your preferences, ensuring that your JSM Assets always reflect the latest information from Lansweeper. Advanced configurations allow you to filter asset types and fields, providing a tailor-made sync experience that aligns with your needs.

On this page:

• What are the Lansweeper App for Jira Service Management Assets features? 
• Prerequisites 
• Install the Lansweeper app 
• Configure the Lansweeper App for Jira Service Management Assets 
• Filter asset types 
• Configure asset fields 
• Check sync statistics 
• Manually run a full sync 
• View and manage assets 
• View linked objects 
• View object graph 
• Uninstall the Lansweeper app 
• Troubleshoot the Lansweeper App for Jira Service Management Assets 
• Known behaviors 

What are the Lansweeper App for Jira Service Management Assets features?

Automated sync of Lansweeper Assets with Jira Assets

• Sync Assets from Lansweeper and add them to Jira Assets, including their relation information.
• Configure and control the syncing interval.
• Create new Jira Assets if they don't already exist or update existing assets.

Filter Asset types

• View the list of all existing asset types for the configured Lansweeper Site.
• Turn on or off syncs for specific asset types.
• Find specific asset types through a search function.

Assets field configuration

• Configure Asset fields that need to be synced from Lansweeper to Jira Assets.
• Add up to 30 fields, including existing fields.

Sync statistics

• View the status of the sync process, including the start time, end time, and status.

Prerequisites

• A properly configured Jira Cloud instance.
• A Premium or Enterprise plan for the Jira Service Management cloud. See Change your plan for more information.
• A Pro or Enterprise plan for Lansweeper. See Pricing & Plans for more information.
• A Jira admin user.

Compatibility

Browser	Google Chrome
Lansweeper API version	Lansweeper API version 2.0
Jira Service Management Plan	Premium / Enterprise plan
App Hosting Type	Cloud
Development Platform	Atlassian Forge

Install the Lansweeper app

1. In your Jira Service Management account, go to Apps > Explore more apps.
2. In the search bar, search for Lansweeper App for Jira Service Management Assets.
3. Select Lansweeper App, then Get App > Get it now. The installation process begins. A message appears once the successful installation is completed.

Configure the Lansweeper App for Jira Service Management Assets

1. Ensure that the Premium/Enterprise plan is enabled for the Jira Service Management cloud. If not, change your plan.
2. In your Jira Service Management account, go to Apps > Manage your apps. From the left pane, select Lansweeper App for Jira Service Management Assets Configuration.
3. Select Allow access to allow the Lansweeper app to access Atlassian products on your behalf. You're redirected to a page that reviews what the Lansweeper app has access to. Select Accept.
4. The Lansweeper API URL is automatically populated and does not need to be edited.
5. Provide the Lansweeper Application Identity Code. To create a code, create a personal app in Lansweeper Sites then obtain the code.
6. In the Atlassian User Email ID enter your administrator email.
7. Create an Atlassian API Token and enter it in the Atlassian API Token field.
8. We recommend creating a new Object Schema for your Lansweeper app. Once the new Object schema is created, select Load Object Schema. Under Select Object Schema, select your Object Schema from the dropdown.
9. Create an asset import token using the External import type for your Object Schema. Paste the token in the Assets Import Token field.
10. Under Sync Interval, choose how often you'd like to schedule a sync.
11. Select Validate and Save. A success message appears once the configuration is saved successfully and a sync is automatically initiated.

Once you select Validate and Save, you can no longer edit the configuration fields. If you want to change your configuration, select Reset and reconfigure your fields.

Filter asset types

Once the sync is complete, you can view the list of asset types by going to Apps > Manage your apps > Lansweeper App for Jira Service Management Assets Configuration > Asset Types.

From here, you can find the entire list of synced assets. If you want to filter out specific asset types, use the toggle button for that asset under Enable/Disable Asset Type.

Use the search bar to find specific assets.

Configure asset fields

To configure asset fields, go to Apps > Manage your apps > Lansweeper App for Jira Service Management Assets Configuration > Asset Fields.

From there, you can view the list of available asset fields. Some fields are required and therefore not configurable.

You can remove some fields by deleting the Jira Asset Field Name and its corresponding Lansweeper Field Name. You can also edit the Jira Asset Field Name. Select Validate and Save to save your configuration.

To add new asset fields:

1. Find the Lansweeper Field name you desire from the list of available asset types.
2. Select the field name to copy its full name to your clipboard.
3. In the Asset Fields table, scroll to an empty row and paste your copied field name in the Lansweeper Field Name column.
4. Provide a name in the Jira Asset Field Name column.
5. Select Validate and Save. A success message appears if the configuration has been successful.

To restore default settings, select Restore Default.

Check sync statistics

Go to Apps > Manage your apps > Lansweeper App for Jira Service Management Assets Configuration > Statistics.

You can see the previous five sync attempts from here, including their start time, end time, and status.

Manually run a full sync

If you want to refresh your asset data between scheduled syncs, go to Apps > Manage your apps > Lansweeper App for Jira Service Management Assets Configuration > Connection and scroll to the bottom of the page. Select Run Full Sync.

In the pop-up, select Continue to proceed with the full sync.

View and manage assets

1. In your Jira Service Management account, select Hardware. All of the asset types that have been imported from Lansweeper are displayed within the Hardware section.
2. Select an asset type from the list. The asset type window is displayed, including a list of all the assets of that type.
   
3. Select an asset from the list for more information, including the asset name, key, host site, and more. Select the Lansweeper Asset URL link to view the asset on your Lansweeper Site. See configure asset fields to edit these fields.
4. In the Linked issues section, view any Jira issues that have been created that are related to the asset.

View linked objects

The Lansweeper app allows you to easily view which objects are linked to each other. To see linked objects:

1. Go to Assets > Hardware and select the asset type you desire from the list, then the specific asset from that type.
2. In the Linked objects section, you can view the outbound and inbound references and their relation types.

Select the object link to be taken to that assets page.

View object graph

The object graph provides a visual representation of your linked objects. To view the object graph:

1. Go to Assets > Hardware and select the asset type you desire from the list, then the specific asset from that type.
2. In the Linked objects section, select Object graph.

Select the object link in the right pane to be taken to that asset's object graph.

Uninstall the Lansweeper app

1. In your Jira Service Management account, go to Apps > Manage your apps > Manage apps.
2. Select Lansweeper App for Jira Service Management Assets > Uninstall.
3. In the pop-up, select Uninstall.

Troubleshoot the Lansweeper App for Jira Service Management Assets

General issues

If an error or issue arises, check the application logs to determine what has occurred. To get the application logs:

1. Log into Atlassian Admin as a system administrator.
2. Select Products > Sites and products.
3. Select Connected Apps.
4. Select the three dots, then Download logs.

Unable to install/activate the Lansweeper app on Jira Cloud

If an error occurs while attempting to install or activate the Lansweeper app on Jira Cloud, review and follow the steps on Installing Marketplace apps.

Permission errors

If the permissions are not correctly set after you install the Lansweeper app, attempt the following fixes:

• Uninstall the app, then reinstall and reconfigure the app.
• Revoke access and reload the configuration page. To revoke access:
  • Go to Atlassian Admin. Select your organization if you have more than one.
  • Select the site's name and URL to open the Admin for that site.
  • Select Products, then select the site from the left-hand side.
  • Select Connected apps from the Site Settings menu.
  • Select Manage authorization for the app.
  • Select Revoke access.

If issues persist, contact Lansweeper Support.

Known behaviors

To view the list of known behaviors, select the spoiler dropdown.

Spoiler

• Any configuration parameter changes made after the sync process has started will not affect the current sync process and will be reflected in the next sync.
• In case of deletion of assets from the Lansweeper side, the deleted assets may remain in JSM Assets.
• If the user resets the configuration page while a syncing process is currently running, the syncing process may fail.
• If an unexpected error occurred during the sync process, the status of the process will remain in the in-progress state and the user may need to wait for 24 hours after which the sync progress is reset automatically. Users can also reset the configuration to restart the sync process.
• At max 100 object schemas will be shown in the "Select Object Schema" select button on the App configuration page.
• If any failure occurs at some point during the asset ingestion process, the app will retry the failed function a maximum of 4 times. The app will mark the sync process as failed if the error persists.
• Due to a limitation from the Atlassian Jira side, the user may be unable to access the user-side logs.
• In Asset Fields Mapping, a new field is created into the current object schema whenever a user changes an existing Jira asset field name or adds a new Jira assets field. The mapping changes will be reflected in the next sync cycle. The currently running sync process may get affected by new mapping changes as the current checkpoint will be removed after the mapping changes are validated and saved successfully.
• The user needs to refresh the page to see new asset types in the Asset Types tab.
• If any asset is manually added to JSM Assets, it will remain as it is and will not be affected by the sync unless it has the same asset key as the Lansweeper Asset.
• If any asset is deleted from JSM Assets, it will get recreated if it comes under the next scheduled sync from Lansweeper, which brings the updated assets after the last sync.

---

Was this post helpful? Select Yes or No below!
Did you have a similar issue and a different solution? Or did you not find the information you needed? Create a post in our Community Forum for your fellow IT Heroes!
More questions? Browse our Quick Tech Solutions.

---