Before you start using Orchestration apps such as MS Active Directory that require you to connect to a private on-premise network, you need to download and install the Orchestration server on one of the systems in that network. The Orchestration server needs a Windows system to work. Make sure you go through the minimum requirements and identify the right computer to run the Orchestration server.

System Requirements

  1. Operating System: Windows Server 2016, Windows Server 2019

  2. CPU: 4 cores

  3. RAM:  8GB of RAM or more

  4. Storage:  10 GB of free space in your hard drive

  5. Admin Access required to run the orchestration server’s Installer (FO-OSR.msi) 

  6. Ensure that one of the .NET Framework versions 4.6, 4.7, or 4.8 is enabled as a Windows feature on the server. To check if any of these .NET features are enabled, follow the steps below:

    1. Navigate to the "Server Manager" on your Windows server.

    2. Click on "Manage" and select "Add Roles and Features."

    3. In the "Add Roles and Features Wizard," proceed to the "Features" section.

    4. Scroll down to locate the ".NET Framework 4.x Features" option.

    5. Expand this section to view the available .NET versions (4.6, 4.7, or 4.8).

    6. Verify that one of these .NET Framework versions is selected (enabled).

    7. If not, select the appropriate .NET version and proceed with the installation. 
      By following these steps, you can confirm that the required .NET feature is enabled on the server.

      Note: We highly recommend using an independent server (with configs provided in the document) and it should not be used for any other purpose. i.e No other app should be installed on the OSR server.

Here’s how you can set up an Orchestration Server:-

1. Create an Orchestration Server on the Freshservice portal

  1. Head over to Admin-> Automations & Productivity > Automation > Orchestration Center. If your account has more than one workspace, navigate to Admin > Global Settings > Automations & Productivity > Automation > Orchestration Center.
  2. Click on the Orchestration Server Tab




  1. Hit the Create Server button and fill in the form with the necessary details

    • Name-  Give your server a meaningful name for example: Based on the location of the network.

    • Description- Add a description (optional)

    • Secret Key-  This will be auto-generated once the Orchestration Server is created successfully. (Note: You’ll need this key during the installation phase)

2. Download and Install the Orchestration Server

  1. Under the Orchestration Server tab, click on Download Windows Installer



  2. Once your download is complete, click on the setup file “FO-OSR.msi” to start the installation wizard.

  3. Proxy Server Configuration: You can select checkbox Use a Proxy Server’ to use this feature

    Q) Why is the Proxy setting included in the installation wizard?
    → Many enterprises don’t allow direct communication with the server, they use a proxy-server as an intermediate.
    To fulfil this requirement we have introduced a checkbox ‘    Use a Proxy Server’ under ‘Proxy Setting’ page

    If selected ‘Use a Proxy Server’ in Proxy Setting page then

    1. Hostname: Give the private IP of the proxy server.

    2. Port: Give the port number of the proxy server

    3. Username: Give the username of the proxy server

    4. Password: Give the password of the proxy server.

    5. Type: Give the Protocol used (generally http, socks4, socks5)


  1. Secret Key:
    Q) What is the Secret Key in the Account Configuration installation wizard?
    → It is a token used for authorization of each and every request originated from Orchestration Server to Freshservice Account.

    Q) Where will I find the Secret Key in the Freshservice Account?

    1. Head over to Admin-> Orchestration Center.

    2. Click on the Orchestration Server Tab

    3. Select one of the Orchestration Server from the list shown

    4. Copy the Secret Key    


  2. Select the folder
    By default, Orchestration Server will be Installed inside     C:\Program Files\Freshworks\
    Click on the ‘Change’ button to change the destination folder.

  3. Complete the installation 

    1. Verify if services (‘Orchestration Server’ and ‘Orchestration Server - WinRM_SSH’) are running in your Services tray.

       


See how to install and use the MS Active Directory Orchestration App by leveraging the Orchestration Server.