Introduction

Once the basic Platform configuration has been completed, it is time to start configuring the software. This includes the very important step of patching the Management Suite to the latest version of the software.

This article explains how to:

• Activate your license key
• Update the SW version
• Add a calendar integration
• Add a meeting room
• Add a video system
• Deploy our configuration and begin using the Synergy SKY Software

You can view our video tutorials at the bottom of this article for a full walkthrough assisted by one of our engineers.

 

Prerequisites

Facet	Description
Synergy SKY Platform Configuration	The Synergy SKY product has been deployed and running in a virtualized environment and the basic platform configuration has been completed. If this requirement is not already fulfilled, please start here.
API Key	As a Synergy SKY customer, you receive a license document containing information regarding your license. Before you can continue with this guide, make sure that you have your API key available.
Service Account	This account should have FullAccess permissions to the Room resource calendars we intend to have the Synergy SKY software monitor.
Room Resource Calendar	The room must have the appropriate permissions and settings based on your current calendar integration.
Video System Access	IP address, login credentials.
Internet Access from Software Server	This is required for license activation as well as some MCU and Sensor access.

 

Note: This guide will explain how to configure the Synergy SKY Software for EWS, using a Cisco endpoint and Cisco Webex. For Graph API, Google API, or for more details on EWS API, as well as adding other endpoint and meeting types, please refer to our other guides or contact support@synergysky.com.

 

Configuration Reference

For more details related to each of the configuration pages in this guide, please refer to the Configuration Reference.

 

Step-by-Step Guide

Opening the Configuration Tool

1. Open the browser and enter the server URL/IP address, e.g. https://192.168.56.185.

2. Click Synergy CONFIG to enter the global configuration. When prompted for credentials, use the following default credentials for first time login:

Username: admin@localhost

Password: Newpassword6

You can and should change this password by navigating to /config/General-Settings/Authentication:

Options are either basic (user/password) or keycloak

Activate Your License Key

1. Click GENERAL SETTINGS and then License
   
2. Provide your API key and click Validate. Once the API key is validated, the license details will populate, including expiry date and number of rooms covered by your license.
   
3. Click Save Changes, and then deploy the configuration changes in order for the license information to take effect.

Important Note:

• If you fail to validate; Check your server can access the license server by verifying that it can reach licensing.synergysky.com
  • General Requirements

Upgrade Management Suite to latest version

Synergy SKY Management Suite uses a base image + patch for initial installations. This base + patch method helps keep our various deploys consistent and simple. Updating the software after initial deploy is crucial for proper functionality.

1. Navigate to CONFIG TOOL > Software Updates
   The page will display your current version
   
2. Click "UPDATE INFORMATION" to check for the latest version
3. The latest available release will display.
   
4. Click "UPDATE" and monitor while the update is performed
5. After the upgrade process is completed, click the "Return to Synergy SKY Management Suite" button
6. Navigate back to CONFIG TOOL > Software Updates to verify you're running the latest version

Note: The software must be patched before continuing.

 

 

Adding a Calendar Integration

The Synergy SKY Software requires a calendar integration in order to run. The supported calendars are Microsoft Exchange on-prem, Microsoft Office 365 (Exchange Online) and Google Calendar. You will need an Exchange or Google Workspace administrator user to configure the respective calendar system prior to adding the calendar integration by following the relevant guide below:

• How To: Configure for Exchange with EWS
• How To: Configure for Exchange with Graph API (Office 365)
• How To: Configure for Google Calendar (Google Workspace)

Note: This guide will explain how to add an EWS integration. For Graph API, Google API, or for more details on EWS API, please refer to our guides. Also see our Configuration Reference for more information on the individual fields.

1. Start here: GENERAL SETTINGS > Integrations Settings
2. Under Connections, click ADD CONNECTION
3. From the drop-down menu, select your connection type. In this example, we are using EWS
4. Name the connection. This is necessary for later steps
5. Fill in the remaining empty fields
6. Click TEST CONNECTION
   
   
7. Click SAVE to save the room and return to the previous page
8. Under API Integrations, click ADD API INTEGRATION
9. From 'Used for' dropdown, select Calendar
10. A new dropdown will appear called 'Connection', select your named calendar connection
11. The remaining fields should auto-populate. Verify they are correct
12. We recommend leaving Polling Interval at 0
    Note: For EWS integrations, Microsoft Exchange sometimes requires the username to be in the format of "domain\username" and sometimes "username@domain". In the latter cases the domain field is optional.
13. Click SAVE to save the integration
14. Ensure the new API Integration is ENABLED
    
15. In the top-right corner of the page, click SAVE CHANGES

 

Adding a Meeting Room

In this section, we will choose which meeting room resources should be monitored by the Software.

For adding additional rooms, or rooms of different types, see our How To on adding rooms in this guide.

1. Under GENERAL SETTINGS > Rooms
2. Click ADD ROOMS and wait for available rooms lists to load
3. Use the dropdown to find a specific Room List, or search for a specific room by name or address
4. When you find the rooms you wish to add, click them to select, then click ADD SELECTED
   1. Alternatively, if the room you wish to add is not a part of the list, or you have not configured your list in exchange. Add the room manually by typing the name and email address.
      
5. The selected rooms will show in the Rooms list
   
6. Click SAVE CHANGES

Note: You can click 'Edit' next to the newly added room to change the occupancy limit, or its prescribed VMR pool.

 

 

Adding a Video System

In this step we will add and define a video system, then we will tie it to the room we configured in the previous step.

For more details, or instructions on adding systems of different types (Poly, other), see our guide.

1. Under GENERAL SETTINGS > Video Systems
2. Click ADD VIDEOSYSTEM
3. From the drop-down menu, select the room we added in the last step
4. Select the Manufacturer from the dropdown
5. Enter the Video System's IP address (applicable for Cisco endpoints only)
6. Enter the login credentials for the endpoint. These will be the same used to log into the endpoint from the unit's web interface, which is accessed by browsing to the IP address in a web browser (Cisco endpoints only)
7. Enter the URI for the system.
   
8. Click the TEST CONNECTION button at the bottom
   • A successful test will populate the 'Serial Number' field
9. Enable required features by clicking on any of the corresponding sliders
10. Click SAVE to return to the previous page
11. Click SAVE CHANGES in the top-right of the page

 

 

Deploying a saved configuration

After each change we make in the various sections of the software, you must SAVE CHANGES before moving to the next. After saving, a notice appears stating that your changes have been saved to the database, but not yet deployed/applied.

Note: You can choose to deploy after every SAVED change, or you can make multiple changes to the configuration and deploy them all at once. For additional information on how to name, organize, and manage your configuration versions, see our How To here.

1. Under CONFIG TOOL > Configuration Versions
2. At the bottom of the Configuration Versions page, click the line named "Current" to select the staged configuration we've created
3. Click DEPLOY CONFIGURATION to apply those changes
4. Click OK to confirm deploy
5. The list at the bottom will update with your current configuration set. By default, deployed configurations are named "Publish Current"
   

Next Step

You have now completed the basic configuration of the Synergy SKY Software, and are ready to tailor make it to suit your needs. The next step in the configuration procedure is to review our guides that describe how to expand and configure the Software to your specific environment.

For an overview of all sections of the Configuration Tool, please refer to the Configuration Reference.

 

Video Tutorial