The purpose of this document is to provide the steps required to configure the Akumina AppManager for load balancing. Prior to executing these steps, the AppManager should first be installed either in the cloud on on-premises using the standard installation procedures. After these steps are complete, then load balancing can be enabled in the environment.
Step 1: Update the Configuration File Settings
Access the “unity.config” file in the AppManager installation location and make the following changes. This will instruct the AppManager to look for the DssConfig information from the SettingsAK list instead of the dss.config physical file.
Verify the following section in the unity.config file is set as seen below with the IdssConfig set to use the list:
<!–<register type=”IDssConfig” mapTo=”DssConfigFile” />–>
<register type=”IDssConfig” mapTo=”DssConfigSpList” />
Repeat this step on each server on which the AppManager will be installed for load balancing.
Step 2: Recycle the AppManager Application Pool
Recycle the application (using IIS) so that the changes take effect in AppManager.
Step 3: Launch AppManager and Set Global Settings
In the AppManager, Navigate to Settings and Edit the Global Settings.
- Set the Site Address to the appropriate parent site collection
- Set “Administrator Group” Permissions
- Set “Reporting Access Group” Permissions
Continue through the normal process of using the AppManager.
When AppManager is launched for a Site Collection, it will automatically detect that the configuration is set to use the DSSconfig information in a SharePoint list. It will automatically create a “SettingsAK” list in the root of the Site Collection and populate it from that point forward.
Migrating Previous Configuration Data (only if updating existing deployments)
If you are converting an existing AppManager deployment that has settings and apps already configured, then you will need to migrate those settings from the previous dss.config physical file into the new list-based setup. To do this, Akumina has implemented a migration tool to do a onetime migration.
To access and run the migration tool, navigate to the site collection parent in the AppManager. Copy the highlighted portion of the URL and append to your AppManager base URL.
As an example: https://akqa3b.azurewebsites.net/admin/debug?migratedss=force