Windward DocumentationIntegration SalesforceInstalling the Windward Maestro Runner

Installing the Windward Maestro Runner

This article will go over how to obtain and install the Windward Maestro Runner on your system

Pre-Requisites

  • An instance of the RESTful Engine setup with a reachable endpoint.
  • An Azure Tables storage account.

Obtaining the Windward Maestro Runner

[This will contain info on where to download the runner]

Configuring the Windward Maestro Runner

After you obtain the MaestroRunner.zip file, extract it to the location of your choice (i.e. C:/MaestroRunner). This zip file should contain 3 sub-directories as well as a bunch of .dll files, a MaestroRunner.exe file as well as an appsettings.json file.  The appsettings.json contains the configuration settings for this app and will be the file we edit right now.

Open up appsettings.json and notice how the configuration file is empty.

In the RESTfulEngineEndpoint put the url of your instance of the RESTful engine.  If this is not set, the Windward Maestro Runner will not work as it has nowhere to communicate in order to generate your document.

The next configuration we will set is the Plugins:StoragePluginPath property.  This application stores user and template information in a database so we need to configure which storage plugin to use.

Currently there is just a plugin for Azure Tables storage but additional plugins for different storage platforms will be added in the future.

In the main MaestroRunner folder should be a sub-directory called Plugins and within that folder should be another directory called AzureTables.  If you navigate within that folder you should see a .dll file called AzureTablesStoragePlugin.dll.  This is the file and path we need to enter in the StoragePluginPath config property.  Grab the full path to that file and put it in that config property.

At this point, you should have the StoragePluginPath and the RESTfulEngineEndpoint set.

Under Plugins:StorageAccountSettings there are 2 properties, AccountName and AccountKey.  These are for your Azure Table Storage credentials.  This can be found in your Azure Portal under your storage account.

If you don't have an Azure Tables Storage account setup you can use this link to help you get setup:

https://gcits.com/knowledge-base/how-to-create-an-azure-storage-account-in-the-new-portal/

Now navigate to your Azure Storage account and click on Access Keys on the settings sidebar.  Then you should see an account name and 2 keys. 

 Put the account name in the AccountName property in the config file.  And then grab one of the keys and put that in the AccountKey property in the config file.

The next step is to setup the OAuthConfig properties.  There's a little more to this step so please follow the steps of Create A Connected App in Salesforce to get those properties setup.

After the OAuthConfig configurations have been setup, the Windward Maestro Runner should be fully configured and ready to use.

0 Comments

Add your comment

E-Mail me when someone replies to this comment