<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><p data-pasted="true"><strong>In this guide we will cover:</strong></p><p data-pasted="true"><strong>- Installing the Halo Integrator</strong></p><p><strong>- Configuring the Halo Integrator</strong></p><p><strong>- Setting up different Scheduled Tasks for your Halo Integrator</strong></p><p><strong>- Upgrading your Halo Integrator</strong></p><p><br></p><p><br></p><p><strong>Related Guides:</strong></p><ul><li style="font-weight: bold;"><a href="https://support.haloservicedesk.com/portal/kb?id=1062" target="_blank" rel="noopener noreferrer">Halo Integrator</a></li><li style="font-weight: bold;"><a href="https://support.haloservicedesk.com/portal/kb?id=1095" target="_blank" rel="noopener noreferrer">Active Directory</a></li><li style="font-weight: bold;"><a href="https://support.haloservicedesk.com/portal/kb?id=1073" target="_blank" rel="noopener noreferrer">Lansweeper</a></li></ul><p><br></p><p><strong><span style="font-size: 12pt;">This guide will cover how to install, setup and upgrade the 'Locally Hosted' version of the Halo Integrator. For information on what the Halo Integrator is and if you need to host your own please see: <a target="_blank" rel="noopener noreferrer" data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/1062" data-pasted="true" style="font-size: 12pt;">Halo Integrator</a>.</span></strong></p><p><br></p><p><br></p><p data-pasted="true"><strong><span style="font-size: 14pt;"><strong data-pasted="true">Installing the Halo Integrator</strong></span></strong></p><p>The Halo Integrator can be accessed and installed via the Halo Integrator Module by navigating to Configuration > Integrations > Halo Integrator</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRhMjJiYjM5LWI1NGYtNGIzOS05NDJmLTg5ZjQ3MjMxOGQxNyJ9.bE4bofcLU4bzxIRMlx9AD48-3S6o99QsLl6wuVzVNhI" class="fr-fic fr-fil fr-dib" width="1268" style="width: 1270px; height: 591.624px;" height="592"></p><p><strong><span style="font-size: 10pt;">Fig 1. Locating the Halo Integrator Module</span></strong></p><p><br></p><p>The module contains information which is useful for hosting your own Halo Integrator as well as monitoring your Halo Hosted Integrator. However, we mainly care about these two features for hosting our own Halo Integrator:</p><ul><li>The ability to download the latest version of the Halo Integrator as a zip file.</li><li>Seeing which integrations are currently enabled in our Halo Instance</li></ul><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjU5Mjg1NWQwLWFiZDUtNDg1NC1iZGYyLWMwZTkxMjAyMTM3NiJ9.gN_DD1ThPzaJhfoebLspRwEJCUuErgmukSc6GU-lPp4" class="fr-fic fr-fil fr-dib" width="783" style="width: 785px; height: 537.219px;" height="537"></p><p><strong><span style="font-size: 10pt;">Fig 2. Install the Halo Integrator and check Enabled Integrations</span></strong></p><p><br></p><p>By selecting the hyperlink above we can install a zip file containing the Halo Integrator. </p><p><br></p><p data-pasted="true"><strong><span style="font-size: 14pt;"><strong data-pasted="true">Configuring the Halo Integrator</strong></span></strong></p><p>Now that we have installed the Halo Integrator we need to configure a file directory to store it and configure the Halo Integrator application.</p><p><br></p><p>First we will create a folder to store our local Halo Integrator. Make sure to name this accurately so we do not forget what this is used for. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFiNzM1NjVkLTUyMjEtNDExOC1hMTRmLWEyNzc3MzczMmU1NyJ9.LrjiihzYIxpXWIyc0A2xGrqbAgRWjCKjgFirKN-nCok" class="fr-fic fr-fil fr-dib" width="956" style="width: 958px; height: 302.217px;" height="302"></p><p><strong><span style="font-size: 10pt;">Fig 3. Halo Integrator Folder</span></strong></p><p><br></p><p>Then you will need to extract the zip file to the folder location. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU2ZjI5MDg1LWIyZmYtNGUxZi05ODNhLTVmMjFlNjBiZTQ3NiJ9.hbNvV8n_fbonHEfdh7HG23wQKLbhMrADbS2bpJEmOn8" class="fr-fic fr-fil fr-dib" width="713" style="width: 715px; height: 462.907px;" height="463"></p><p><strong><span style="font-size: 10pt;">Fig 4. Extracting the Integrator zip file from downloads</span></strong></p><p><br></p><p>Now select the folder we have created and extract the zip file to here:</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjUzZGYyZDdjLTc5MTctNGU0OC1hN2ViLTgwNGQ2NzQ1MDg3NSJ9.q0LDlSBTO0GImxHJa-sEeh0F5FdhwAO3zFwSE_yWtlY" class="fr-fic fr-fil fr-dib" width="553" style="width: 555px; height: 472.945px;" height="473"></p><p><strong><span style="font-size: 10pt;">Fig 5. </span></strong><span style="font-size: 10pt;"><strong>Selecting the Integrator Folder to extract to</strong></span></p><p><br></p><p>With this extracted we can now view the folder which will contain the Halo Integrator and a x64 Halo Integrator.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjVjYmZkOTFkLTE3NGMtNGRlYy1hNjU4LTIyZjI2NzViMWY1OSJ9.EvQR4fJ4Cjkv5KTjS6nKiE7I6pg7UwpfEYTyE2hJckM" class="fr-fic fr-fil fr-dib" width="874" style="width: 876px; height: 272.64px;" height="273"></p><p><strong><span style="font-size: 10pt;">Fig 6. The two Halo Integrators in our Integrator Folder</span></strong></p><p><br></p><p>Now we can proceed with validating and setting up the connection between our locally hosted integrator and our Halo instance using the API. The Halo Integrator has four main tabs:</p><ol><li>Basic Configuration<ol><li>Halo URL - This is the URL of your Halo instance</li><li>Client ID - This is either the default client ID or from a separate Halo API application. This should already be populated based off of downloading the application.</li><li>Client Secret - This is either the default client ID or from a separate Halo API application</li></ol></li><li>Integrations<ol><li>This tab allows you to select which integrations to sync using the Halo Integrator. Note that integrations must be enabled both here and in Halo's configuration.</li></ol></li><li>Processing<ol><li>This tab allows you to manually process integration syncs. We can either select all integrations or specific modules. This is useful for testing before setting up recurring syncs with task scheduler. </li></ol></li><li>About<ol><li>Provides information on the version of the Integrator as well as contact information for Halo Support. </li></ol></li></ol><p><br></p><p>Within the basic configuration tab we should already have the client ID populated:</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjkzYjYzYjc4LWU5NDUtNGUzNS1hYTM1LTFjZmFkNmViMzFmYSJ9.BbEwCc65guLTAlaM7iesjvKvByp_wM4Bm8l5XZTKL9c" class="fr-fic fr-fil fr-dib" width="480" style="width: 482px; height: 543.394px;" height="543"></p><p><strong><span style="font-size: 10pt;">Fig 7. Halo Integrator pre-populated with the Client ID</span></strong></p><p><br></p><p>All we need to do is input our Halo URL:</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY0NTM4NjY0LTE5MzEtNDgwMS04OTkyLWE3YzVkY2YxNWE0MCJ9.APgV20jAX2SDUdoh2TEJDldUpGXcUHBwXOzmhFjGlN0" class="fr-fic fr-fil fr-dib" width="490" style="width: 492px; height: 557.637px;" height="558"></p><p><strong><span style="font-size: 10pt;">Fig 8. Halo Integrator with the Halo URL</span></strong></p><p><br></p><p>The final part is to input a client secret. We can use either our own Halo API Application or the default set in Configuration > Integrations > Halo Integrator. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY0ZDM2M2JiLWZmZjItNGFhYS1iNGVjLWUyMTg4NTUzYTU5MyJ9.xkqcLjGBwXb3hIG30mkg42-uoBcbpUo4csriGa2R6iQ" class="fr-fic fr-fil fr-dib" width="946" style="width: 948px; height: 581.374px;" height="581"></p><p><strong><span style="font-size: 10pt;">Fig 9. </span></strong><span style="font-size: 10pt;"><strong>The Halo Integrator Module</strong></span></p><p><br></p><p>Before generating the secret you will need to choose an agent for the Halo Integrator to log in as in the "Agent to log in as" field. We recommend creating an API only agent with administrator access, this will only be used to execute synchronization processes. API only agents will not use up a licence.</p><p><br></p><p style="margin-left: 20px;"><strong>Create an API Only Agent</strong></p><p data-pasted="true" style="margin-left: 20px;">Go to Configuration > Teams & Agents > Agents > New. Configure the agent with the following properties:</p><p style="margin-left: 20px;">Give them a descriptive Username</p><p style="margin-left: 20px;">Assign an administrator-level role in Roles (e.g., "HaloITSM Administrator")</p><p style="margin-left: 20px;">Check Is an API-only Agent</p><p style="margin-left: 20px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdiYjQxOTViLTZiOGMtNGI3Yy04ZjcxLTAwOTFhZDk0MmQ0NSJ9.in6USUtHTEVmAV56jmxXyA3EYxMkM1YHEYvTs-INMUw" class="fr-fic fr-fil fr-dib" width="969" style="width: 971px; height: 588.925px;" height="589"></p><p style="margin-left: 20px;"><strong><span style="font-size: 10pt;">Fig 10. Create API only Agent</span></strong></p><p style="margin-left: 20px;"><br></p><p style="margin-left: 20px;">Now save the agent. Once created set this agent to be the agent to log in as for the Halo Integrator. </p><p><br></p><p>Now we can generate a new client secret for the Halo Integrator to use using the "Generate New Client Secret". </p><p><br></p><p>Once we select the button to "Generate New Client Secret" we will receive a popup warning.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhhNDRmMTExLTllMWUtNDkyZi1hNzkxLTQzZjRhZDk2NTQ1NyJ9.bOkbf3m5RtK15Qa95macqXnLuFIlveLiEiz0J0iNwJc" class="fr-fic fr-fil fr-dib" width="830" height="132"></p><p><strong><span style="font-size: 10pt;">Fig 11. </span></strong><span style="font-size: 10pt;"><strong>Generating a new client secret warning</strong></span></p><p><br></p><p>Then we can specifically generate a new secret, copy it and input into the basic configuration tab of the Halo Integrator.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI5MzJiZWY3LWQyNWEtNDJkNC1hYTRiLWJmY2QxZGVkNzgyMSJ9.0I8lyN7riheONxNqVfa3_Eto0b8fdqpJJ5nfUwS_3-E" class="fr-fic fr-fil fr-dib" width="871" style="width: 873px; height: 201.188px;" height="201"></p><p><strong><span style="font-size: 10pt;">Fig 12. Generating a new Client Secret</span></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU0ZDUyZWI4LTk1MGEtNDczMi1iODE1LTRhNWY1NTQ2M2I1NSJ9.H1Khb0GUadf0W5ZiWqK2w-MGileHq-8A-eox9E__8Ac" class="fr-fic fr-fil fr-dib" width="523" style="width: 525px; height: 586.833px;" height="587"></p><p><strong><span style="font-size: 10pt;">Fig 13. Inputted the Client Secret into the Basic Configuration tab</span></strong></p><p><br></p><p><strong><span style="color: rgb(235, 107, 86);">Important: If this button "Generate New Client Secret" is clicked again, this will replace the existing secret. You will need to update the secret in your Halo Integrator, otherwise this will not run. </span></strong></p><p><br></p><p>With this done we can now select save. This will add an appsettings.json file into our integrator folder. This will contain an array of integrations we have set to be processed as well as the encrypted connection string for the Halo Integrator executable file.</p><p><br></p><p><strong><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjU2MDNmMTM0LTFlZDMtNDJjMS1iNzViLThiM2I1NGUxYmUxZSJ9.yTr39obp830TJqHuo2S0H8ZKn-cIA3Lx913rZlRGDcY" class="fr-fic fr-fil fr-dib" width="769" style="width: 771px; height: 205.721px;" height="206"></strong></p><p><strong><span style="font-size: 10pt;">Fig 14. Newly generated appsettings.json file</span></strong></p><p><strong><br></strong></p><p>Now we can validate the connection for the Halo Integrator. If this is successful this will display a green message if not it will throw an error. If you do receive an error it may be to do with the credentials you have inputted previously.</p><p><strong><br></strong></p><p><strong><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBkYzQzMDNhLWEzY2MtNGViMS05MjljLThjMDI3OTg0ZGY3MyJ9.gRG74dLwxdchctYEqRlmV1TaOwas3MBkq8bK7GQZd1c" class="fr-fic fr-fil fr-dib" width="503" style="width: 505px; height: 566.779px;" height="567"></strong></p><p><strong><span style="font-size: 10pt;">Fig 15. Validated Halo Integrator</span></strong></p><p><br></p><p>With this complete, we can now select the integrations we would like to process within the integrations tab.</p><p><br></p><p><strong><em>Note: Integrations must be enabled both here and in Halo's configuration (within the integration setup page).<br></em></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjVmY2ZjY2MzLThhZTEtNGU5NS05NmRlLTU2ZjNjOGQ5M2FkNSJ9.fSM1OiuY_dTjzZYgADEn8iApe2t8uD1XFrHApKLfTlQ" class="fr-fic fr-fil fr-dib" width="519" style="width: 521px; height: 583.59px;" height="584"></p><p><strong><span style="font-size: 10pt;">Fig 16. Incoming Mail selected as an integration to process</span></strong></p><p><br></p><p>For every integration we select this will be added to a module array within the appsettings.json file. This becomes useful for determining the different schedules we would like to sync our integrations. Notice I have selected incoming mail and the powershell integration to be processed. However, these will be processed on different schedules using task scheduler.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI3ZjMzYjUwLWY1ZGMtNGJlMy05ZTViLTgyMjc5MzlkZTZlZiJ9.v0RoP6Wz1ne-hMVILnNMdDTNotksXYcudAzC2Wv3iWw" class="fr-fic fr-fil fr-dib" width="698" style="width: 700px; height: 467.783px;" height="468"></p><p><strong><span style="font-size: 10pt;">Fig 17. Module array within the appsettings.json file</span></strong></p><p><br></p><p>Then with these integrations selected we now move to the processing tab. Here we can manually process and test individual integrations or all of them at once. Test manually here before setting up recurring imports.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQxYTQ2ZThmLWE3MDQtNDdlOS1iOTM5LWQ0NThiODIyNzM2YyJ9.bqu7ktegal67Kx-7HvnT4xlIwl6xzmRE3ijc1z-f4tY" class="fr-fic fr-fil fr-dib" width="454" style="width: 456px; height: 515.478px;" height="515"></p><p><strong><span style="font-size: 10pt;">Fig 18. Processing tab</span></strong></p><p><br></p><p>For example, I can manually process the PowerShell integration. Which will search for the integration, determine if there is anything to be synced and process this. This will also generate a log folder within your integrator folder. This is where you can view any logs for your integrations processed by this Halo Integrator. </p><p><br></p><p><strong><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ0ODFiZjI2LTljNDUtNDI1NS1hOGE0LTkzYTMwMmZmODY1YiJ9.H5Sf-ImokyT-9yI9ZQEd6C2-BvSc9Fqo3t0BifZFBeM" class="fr-fic fr-fil fr-dib" width="443" style="width: 445px; height: 507.27px;" height="507"></strong><strong><span style="font-size: 10pt;">Fig 19. Manually processing an integration</span></strong></p><p><br></p><p>With this complete we have now setup the Halo Integrator, validated it's connection and tested the syncing of an integration. The last step is to setup a recurring sync using task scheduler. This will allow syncs to take place automatically. </p><p><br></p><p data-pasted="true"><strong><span style="font-size: 14pt;"><strong data-pasted="true">Setting up different Scheduled Tasks for your Halo Integrator</strong></span></strong></p><p>A Windows scheduled task must be created to run the locally hosted Halo Integrator on a recurring schedule. As per the instructions shown in figure 18 on the processing tab, the scheduled task must point to the application file with an additional argument of AUTO. The AUTO parameter starts the processing after the application is loaded by the scheduled task.</p><p><br></p><p>You would only need to configure the first three tabs within task scheduler as well as the last one. To begin you can search for "Task Scheduler":</p><p><br></p><p data-pasted="true"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJlYzA0Y2E4LTFkZTctNGIxYy1iYzQxLWYxODFiOWQwNmEyYSJ9.q-dm78YZT760qnFeVTA4DUoaRidxHegPiFbH_AICQCc" class="fr-fic fr-fil fr-dib" width="528" style="width: 530px; height: 530px;" height="530"></p><p><strong><span style="font-size: 10pt;">Fig 20. Search for Task Scheduler</span></strong></p><p><br></p><p><span style="font-size: 11pt;">Then create a task either by right clicking on the task scheduler library or navigating to actions then selecting "Create Task":</span></p><p><br></p><p><strong><span style="font-size: 10pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM1MDI3NTZmLTMyNTEtNDQzYy1iN2RkLWIzZmI3NjZjMzkxMCJ9.bTQOQy9E6IKZJV3533aIvXA8J2VPwDYX98__8PQvZn4" class="fr-fic fr-fil fr-dib" width="1283" style="width: 1285px; height: 300.647px;" height="301"></span></strong></p><p><strong><span style="font-size: 10pt;">Fig 21. Creating a task within task scheduler</span></strong></p><p><strong><span style="font-size: 11pt;"><br></span></strong></p><p><span style="font-size: 11pt;">Now we can proceed with configuring four tabs within the task to run the Halo Integrator automatically as follows:</span></p><ol><li style="font-size: 11pt;">General</li><li style="font-size: 11pt;">Triggers</li><li style="font-size: 11pt;">Actions</li><li style="font-size: 11pt;">Settings</li></ol><p><br></p><p><span style="font-size: 11pt;">Because each integration (or different entities for the same integration) may require processing on different frequencies, you will likely find that you need to create multiple scheduled tasks pointing at different instances of the Halo Integrator configuration. This is covered in the next section, however, for the moment we can create one task.</span></p><p><br></p><p><span style="font-size: 11pt;"><strong>General Tab<br></strong></span></p><p><span style="font-size: 11pt;">First we need to configure the General tab as shown in figure 21.</span></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc1ZjA3MTU1LWMzOTQtNDcwMC1iZTQ2LTU5NDQ4YzQ3NmVhNyJ9.K-CqHNB6mgfd-THPEeF2BIesLXwGxJIFMPCI02ZUjvE" class="fr-fic fr-fil fr-dib" width="630" height="481"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 22. Enabling the Task to run despite the user account not being logged in and with highest privileges</span></strong></p><p><br></p><p><strong><span style="font-size: 11pt;">Triggers Tab</span></strong></p><p><span style="font-size: 11pt;">Secondly we need to configure the Triggers tab. This is where we determine the schedule we want the Halo Integrator to process our integrations. In my example, I am setting up the triggers for the incoming email sync which should run more frequently e.g. every five minutes. This can be done as shown in figure 23.</span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhhM2NjNTFhLThlN2QtNDllNi1hODEyLTliMThkYzMxOGQ0YiJ9.UcriqDnKVizGW3Jt_AGzBmKFfktE7-iU52rjWmHPK8c" class="fr-fic fr-fil fr-dib" width="1252" height="517"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 13. Creating a trigger for the Task and setting its schedule</span></strong></p><p><br></p><p><span style="font-size: 11pt;"><strong>Actions Tab<br></strong></span></p><p><span style="font-size: 11pt;">Thirdly, we now need to configure the actions tab. This will determine which integrations we are executing and which Integrator is responsible for this.</span></p><p><span style="font-size: 11pt;"><br></span></p><p><span style="font-size: 11pt;">It is important to note that this involve inputting file paths which will be with back slashes as follows:</span></p><ul><li style="font-size: 11pt;">Program/script <ul style="font-size: initial;"><li style="font-size: 11pt;">The file path location of the integrator we want to run.</li><li data-pasted="true" style="font-weight: bold; font-size: 11pt;"><strong>C:\Users\LennyClifton\Desktop\Integrator File\HaloIntegrator.exe</strong></li></ul></li><li style="font-size: 11pt;">Add arguments <ul style="font-size: initial;"><li style="font-size: 11pt;">The appsettings file we have generated. This is the list of integrations we want to be processed by this scheduled task.</li><li style="font-weight: bold; font-size: 11pt;"><strong>AUTO C:\Users\LennyClifton\Desktop\Integrator File\appsettings.json</strong></li></ul></li><li style="font-size: 11pt;">Start in<ul style="font-size: initial;"><li style="font-size: 11pt;">The file directory that is storing our Halo Integrator and appsettings file. This is required and must be set to the folder where the Halo DB Integrator application file is located and allows any logs that are created from running the Halo Integrator to be created in that location.</li><li data-pasted="true" style="font-weight: bold; font-size: 11pt;"><strong>C:\Users\LennyClifton\Desktop\Integrator File\</strong></li></ul></li></ul><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY0NDdmZGMzLTczNWQtNDMzNC1iMzdlLWZiNDE3MmJlOTA3ZSJ9.ul0Q_9ah6ySbpWY7L3BRLgMpFDTb0DrqzgIl3wcxo6U" class="fr-fic fr-fil fr-dib" width="672" height="750"></p><p><span style="font-size: 10pt;"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 24. Configuring the Actions tab</span></strong></span></p><p><br></p><p><strong><span style="font-size: 11pt;">Settings Tab</span></strong></p><p><span style="font-size: 11pt;">Finally, we must now configure the "Settings" tab of the scheduled task. Here we only need to make one change and that is to ensure we have the task set to "run a new instance in parallel".</span></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImYwN2IzNzIyLWJiNzktNDMzYi05NDFjLWEzNDFmYTZkMDEwMiJ9._FbCFZHRviFRV0-8QJX7RxtPfxNfYPCxSJCnWGL6LuU" class="fr-fic fr-fil fr-dib" width="948" height="718"></p><p><span style="font-size: 10pt;"><span style="font-size: 10pt;"> <span style="font-size: 10pt;" data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 25. Enabling "run a new instance in parallel"</span></strong></span></span></span></p><p><br></p><p data-pasted="true"><span style="font-size: 11pt;">This means that if the integrator takes longer to process than its scheduled interval, the next scheduled run will still start and both batches will run in parallel.</span></p><p><br></p><p data-pasted="true"><strong><span style="font-size: 14pt;"><strong data-pasted="true">Setting up different Scheduled Tasks for your Halo Integrator</strong></span></strong></p><p data-pasted="true">The frequency in which the scheduled task should be run is determined by the integrations that are being processed by the Halo Integrator, and how much data will be processed via the third-party sync. An integration such as incoming mail is recommended to run every few minutes, whereas the Azure Active Directory integration that may import thousands of users must be run much less frequently, otherwise, the sync will never be able to complete. This is recommended to be daily.</p><p><br></p><p>If you are unsure of how frequently a Halo Integrator sync should be run, please contact the Halo Support Team.</p><p><br></p><p data-pasted="true">Because each integration (or different entities for the same integration) may require processing on different frequencies, you will likely find that you need to create multiple scheduled tasks pointing at different instances of the Halo Integrator configuration. To do this, you can add a second argument to the scheduled task that states the location of the appsettings.json file you wish to use.</p><p><br></p><p>First, you should create your second appsettings.json file. To create a second file, create a copy of your current appsettings.json file and rename this. Manually open the Halo Integrator - it will be reading its configuration from the appsettings.json file in the root folder. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjUyNjM1ODYxLWU4MzAtNDE4ZS05ZDE3LTE3NzEyZGEwZTkyYSJ9.myOGtufQOPDQKffAvjn0zEBRjKkufhLE4ddMowSk7G8" class="fr-fic fr-fil fr-dib" width="964" height="771"></p><p><strong><span style="font-size: 10pt;">Fig 26. Module List with the original appsettings.json file</span></strong></p><p><br></p><p>Make any necessary configuration adjustments, such as enabling/disabling integrations. Click the Save button, which will save any changes to your appsettings.json file. You now have two separate appsettings.json files. For example I may only want to process incoming mail so I have removed it from the array and copied this to my five minute folder. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhlMTQ0ZDlhLTI2MTMtNDc4Zi04OWE1LWU0NmFkNzQ4OGYyOSJ9.5K1Dcwabxj55hi7ZpBR9i8uThW77IdBYfQR7_8uNuNE" class="fr-fic fr-fil fr-dib" width="686" height="505"></p><p><strong><span style="font-size: 10pt;">Fig 27. Copied appsettings.json file with only the incoming mail integration listed</span></strong></p><p><br></p><p>It is a requirement that the configuration file be called appsettings.json. You must therefore move your copied version to a separate folder and rename it back to appsettings.json. An example of how you could do this is as follows, where each folder name references the frequency of the Halo Integrator sync associated with the appsettings.json file. Both folders contain a file called appsettings.json, and the HaloIntegrator.exe file is in the C:\HaloIntegrator folder.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjgyMmQ4ZGY3LTVkMzMtNDM0NS05Yjc4LWNmMmU5ZDM5ZDllMyJ9.Ci_pO9MoyXlZ7kCfuS7On9nj_OOI0_BqLRbWzBZjNZw" class="fr-fic fr-fil fr-dib" width="1190" height="325"></p><p><span style="font-size: 10pt;" data-pasted="true"><span style="font-size: 10pt;"><span style="font-size: 10pt;" data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 28. File structure for our different schedules</span></strong></span></span></span></p><p><br></p><p><span data-pasted="true"><span style="font-size: 10pt;"><span data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRmOGI0NmM0LTVkYmItNGM0MS1iNjVmLTg4ZWRmOTBhYTIyYyJ9.z_3wIn9ZKmQG-wVDGT5LUbqIadrUqstfk61gkzM2UFk" class="fr-fic fr-fil fr-dib" width="1269" height="295"></span></strong></span></span></span></p><p><span data-pasted="true"><span style="font-size: 10pt;"><span data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;"><span style="font-size: 10pt;" data-pasted="true"><span style="font-size: 10pt;"><span style="font-size: 10pt;" data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 29. appsettings.json file within my 5 minute schedule</span></strong></span></span></span></span></strong></span></span></span></p><p><br></p><p><span data-pasted="true"><span style="font-size: 11pt;"><span data-pasted="true">With this file structure the <strong>Actions </strong>tab would look like this:</span></span></span></p><ul><li data-pasted="true" style="font-size: 11pt;">Program/script <ul style="font-size: initial;"><li data-pasted="true" style="font-weight: bold; font-size: 11pt;"><strong>C:\Users\LennyClifton\Desktop\Integrator File\HaloIntegrator.exe</strong></li></ul></li><li style="font-size: 11pt;">Add arguments <ul style="font-size: initial;"><li style="font-weight: bold; font-size: 11pt;" data-pasted="true"><strong>AUTO C:\Users\LennyClifton\Desktop\Integrator File\5 Mins\appsettings.json</strong></li></ul></li><li style="font-size: 11pt;">Start in<ul style="font-size: initial;"><li style="font-size: 11pt;"><strong>C:\Users\LennyClifton\Desktop\Integrator File\</strong></li></ul></li></ul><p><span style="font-size: 11pt;">You can then test this has been setup correctly by manually running the scheduled task to see if it processes any information.</span><span style="font-size: 10pt;"><br></span></p><p><br></p><p data-pasted="true"><strong><span style="font-size: 14pt;"><strong data-pasted="true">Upgrading your Halo Integrator</strong></span></strong></p><p>The Halo Integrator will not be automatically upgraded at the same time as your Halo instance. This means that you will have to reinstall the Halo Integrator, extract it and copy the integrator application over to your file directory and replace the old Integrator with the new one. </p><p><br></p><p>You can compare the versions of the Halo Integrator by running the application and checking the top right of the application.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjkwYTE0ZDlhLTE0YTMtNDIxMy1iNmJmLTA3OTM2N2FhZTg1NyJ9.PiNZ0LVTYdKOkJ7CiJXL_UnOUrqcvtrPrEcQVanXVOQ" class="fr-fic fr-fil fr-dib" width="894" height="260"></p><p><strong><span style="font-size: 10pt;">Fig 30. Checking the Halo Integrator Version. This can be checked in the about tab</span></strong></p><p><br></p><p>Or you can see that the file size will be larger.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjkwZWNlOWVkLTExOTAtNDNmMi1hZjA3LTcyYThmN2IzMDMxNSJ9.eFMAoCnRX_In1sain5cX95740ZWbnU1bzCN71R1_rhs" class="fr-fic fr-fil fr-dib" width="1222" height="334"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 31. Checking the Halo Integrator file size</span></strong></p>
