Site Integration Services

From Hornbill
(Difference between revisions)
Jump to: navigation, search
(Download the Hornbill SIS)
(Pairing a SIS with your Hornbill instance)
 
Line 103: Line 103:
 
<li>Click the '''Pair with Instance''' button</li></ol>
 
<li>Click the '''Pair with Instance''' button</li></ol>
 
<gallery class="center">
 
<gallery class="center">
File:ITOM_Hornbill_Site_Integration_Server_Localhost.JPG|Your Instance ID and a valid authorization code are required to pair a SIS with your Hornbill instance
+
File:ITOM_Hornbill_Site_Integration_Server_Localhost.JPG|Your Instance ID and valid authorization code are required to pair an SIS with your Hornbill instance
File:SISHomePage.png|Once paired, the status of the SIS can be viewed at <nowiki>http://localhost:11117</nowiki>
+
File:SISHomePage.png|Once paired, the SIS status is reviewable via <nowiki>http://localhost:11117</nowiki>
 
</gallery>
 
</gallery>
 +
 
== Managing the List of Site Integration Services==
 
== Managing the List of Site Integration Services==
 
Any Site Integration Service connectors you have created can be viewed and managed in the SIS list found in '''''Hornbill Administration > Home > ITOM > Site Integration Services'''''. The list displays the following information:
 
Any Site Integration Service connectors you have created can be viewed and managed in the SIS list found in '''''Hornbill Administration > Home > ITOM > Site Integration Services'''''. The list displays the following information:

Latest revision as of 07:54, 1 July 2020

Home > Administration > ITOM > Site Integrations Services Index

[edit] Introduction

Hornbill's Site Integration Service (SIS) is a package that needs to be installed on a server within your organization. It runs as a standard Windows NT Service and once paired with your Hornbill instance, monitors the ITOM Job Queue for any jobs that it needs to execute. The SIS polls the paired Hornbill instance every 5 seconds, acting as the heartbeat to the cloud.

The SIS is self updating and is accessible via a web page, which allows for the initial pairing and display of the current status of the service.

Should jobs be detected during a polling interval, the SIS pulls all information from the paired instance with regards to the jobs that are required to be undertaken on specified devices on the network. There are currently two types of job that can be initiated; Computer Discovery and IT Automation. Automation jobs are powered via pre-built packages provided by Hornbill or can be custom-built using the ITOM Package Creator.

[edit] Related Articles

[edit] Technical Considerations

[edit] System Requirements

  • OS: Windows Server 2012, 2012 R2, 2016 or 2019
  • RAM: 4GB
  • Free Disk: 10GB
  • CPU load is minimal
  • Can be run on virtual as well as physical machines.

[edit] Connectivity

  • The SIS communicates with your Hornbill instance using HTTPS.
  • Your Hornbill instance will only respond to pings from a paired SIS.
  • Proxies are not yet supported by the SIS.

[edit] Discovery and Deployment

The SIS is capable of discovering all Windows machines and deploying ITOM Packages on those 32 and 64 bit Windows operating systems currently supported by Microsoft. Depending on the content of the package, there may be additional OS requirements}}

[edit] Download the Hornbill SIS

The Hornbill SIS package can be downloaded from Hornbill Administration via Home > ITOM > Site Integration Services and clicking the button labelled "Download Site Integration Server". The SIS package is downloaded as an executible (.exe).


SISToolbar.png



Description of the options found in the SIS Toolbar (beginning from the left):

  • Refresh - A refresh of the list may be required to display any new devices discovered while you are viewing the list
  • Show - Displays Connectors from the selected Group
  • + Create Group - (Selectable via the drop-down) allows for the Creation of SIS Groups'
  • Paired / Not Paired - Toggle button that allows the display of Paired or Not Paired SIS
  • Download Site Integration Server - Downloads the on premise SIS Installer
  • Move Selected To... - Moves the selected SIS entries to the selected Group
  • NewPackageButton.png - Add a new SIS Connector
  • Delete - Deletes the selected SIS entries


[edit] Install the Hornbill SIS

Click "Install" to begin installing the SIS
The Site Integration Service is installed as a Windows NT Service called "ESPSisService"

Once downloaded, the Hornbill SIS is installed as a Windows NT Service. Local administration rights will be required on the computer where the SIS is to be installed.

  1. Locate the downloaded executable and double click to begin
  2. Click Install
  3. Click Ok to Confirm the Installation
  4. Close the Install dialog
  5. Open the Services MMC Console
  6. Start the EspSisService



[edit] Creating a SIS Connector in your Hornbill Instance

  1. Navigate to Hornbill Administration > Home > ITOM > Site Integration Services
  2. Click the NewPackageButton.png button to add a new SIS Connector
  3. Enter the following details:
    1. Name - name used to identify the SIS server to the Hornbill Instance
    2. Group - Should be a least one default group, others can be selected via drop down if created previously
  4. Click the Create Site Integration Service button
Image: 350 pixels
  1. The Authorisation Key is displayed, and should be recorded for later use
  2. See the next section for details of how to pair your SIS with your Hornbill instance
  3. Should you choose not to complete the pairing at this time, the connector can be found by selecting the Not Paired filter in your list of SIS Connectors
Information
The Authorisation Key is valid for 1 hour. Should the SIS connector and SIS installation not be paired during this time, the key will expire and the unpaired SIS connector will be removed

[edit] Pairing a SIS with your Hornbill instance

Once the ESPSisService is running, you can begin the process of pairing it to your Hornbill instance.

  1. Open the Browser and navigate to http://localhost:11117. If you're already there, refresh the page
  2. After several seconds, you will be prompted for your instance id and an authorization code
  3. If you already have an authorization code, skip to step 10, otherwise continue with the next step.
  4. To obtain an Authorization code, a new SIS connector must be added to the SIS list in Hornbill Administration > Home > ITOM > Site Integration Services
  5. At the top right of the list in Hornbill Administration, click the "+" button to add a new SIS connector
  6. Add an appropriate name and description and click "Add Site Integration Service Connector"
  7. Details of the new SIS entry will appear, including an Authorization code.
  8. Copy the Authorization code
  9. Return to the SIS pairing page page http://localhost:11117
  10. Enter the instance ID and authorization code
  11. Click the Pair with Instance button

[edit] Managing the List of Site Integration Services

Any Site Integration Service connectors you have created can be viewed and managed in the SIS list found in Hornbill Administration > Home > ITOM > Site Integration Services. The list displays the following information:

  • Name - the name of the Connector (provided when first created)
  • Group - displays the group that the Connector belongs to
  • Description - displays any further detail you've provided about the connector
  • Service Type - shows the operating system architecture of the Server hosting the SIS installation (64 or 32-bit)}}
  • Service State - lets you enable or disable the SIS
  • Online Status - displays the current status.
  • Service Build - displays the SIS Server version. Any Service showing an older build may highlight that there is an issue with automatic updates for that service
  • Last Seen On- this will display the last time there was communication between the Hornbill SIS Service and the SIS Server



[edit] Grouping Site Integration Servers

The creation of groups enable SIS connectors, and thus SIS installations, to be logically grouped together. A group can consist of a single SIS. Multiple SIS installations may be necessary depending on the environment and potential load and also allows for the provision of failover protection. The number of SIS installations will be dependant on the environment and your needs.

  • Load Balancing
When more than one server is placed within a group, Jobs sent to the group for processing will be processed by the next available SIS server spreading the load.
  • Failover protection
SIS servers all poll the Job queue for jobs and thus if a server fails one of the other servers its group will pick the next available job. Any job that is currently being processed by the SIS server will fail and the status will be set to accordingly. If the job has already been pushed to a client and executed then it will potentially be orphaned and the status in the Job queue will be set to Timed-Out.
Information
If a standalone SIS server fails then all jobs aimed at that server will be left in the Job queue and will not be processed until the server is up and running again.

[edit] Creating a Group

164×139px
  1. From the ITOM page select Site Integration Services
  2. Click the Show dropdown
  3. Click +Create Group option
  4. Enter the New Group Name
  5. Click Apply


Personal tools
Namespaces

Variants
Views
Actions
Navigation
Tools