User Tools

Site Tools


development:applications:polaris:manualpullconfiguration

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
development:applications:polaris:manualpullconfiguration [2018/05/03 13:12] adowlingdevelopment:applications:polaris:manualpullconfiguration [2021/06/25 10:09] (current) – external edit 127.0.0.1
Line 1: Line 1:
 +====== Manual Pull in EMS ======
 + --- //[[anna.dowling@errigal.com|Anna Dowling]] 2018/05/03 04:43//
 +
 +===== Introduction =====
 +As part of IDMS-2390 a feature was requested by ATC to allow certain users to start the file sync retrieval and processing on demand from inside the EMS application.
 +This follows a similar look and feel to our other sync processes but is only available on the EMS overview panel to users with visibility assigned to their accounts. If the user has the correct permissions they will see a new Sync menu display with the option Remote Database Sync.
 +
 +{{ :development:applications:polaris:screen_shot_2018-05-03_at_11.58.28.png |}}
 +
 +
 +===== Permissions =====
 +The permissions needed in order to use this sync functionality are assigned through the Global Admin Tool from the EMS Permissions options. The name of the permission needed is **"Perform Remote Database Sync"**
 +
 +===== Processing =====
 +The task which is run when this process is kicked off is called **RemoteFileRequestTask**. When the perform sync button is clicked and the process started this task is directly from the class **RemoteFileSyncActionHandler** as opposed to being called via a schedule.
 +
 +**The task performs the following functions:**
 +  - Performs an sftp GET on the **RemoteFileHost** to retrieve the RemoteFile.
 +  - Runs any associated RemoteFileDiscoveryConfiguration scripts associated with the **RemoteFile**.
 +  - In this case the script which is run parses the csv file retrieved and updates any "Asset" data (element data) that has changed in Polaris in order to propagate that change into the SnmpManager database.
 +  - The task will run in the background if the broswer window is closed as the task can take 15 to 30 minutes to complete depending on the volume of updates parsed in the file. This is indicated to the user as show below:
 +{{ :development:applications:polaris:screen_shot_2018-05-03_at_13.09.55.png |}}
 +  - Once the process is finished an entry is created in the **GeneralDiscoverySyncHistory** which will display in the Sync history table associated with the task run as demonstrated below. If a failure occurs during the file retrieval this will display to the user in this table:
 +
 +{{ :development:applications:polaris:screen_shot_2018-05-03_at_13.04.09.png |}}
 +
 +===== Concurrency =====
 +The syncs cannot run concurrently, so if a second user tries to perform a sync while the first one is still in progress they will be notified that this action is not possible:
 +
 +{{ :development:applications:polaris:screen_shot_2018-05-03_at_13.12.04.png |}} 
 +