Global Server Configuration interface guide
The Global Server Configuration interface is the UI for superadmins to configure and administer the Unblu Spark server.
Users with the necessary rights to access the Account Configuration interface have an Administration section in their Agent Desk user menu. The section contains a link labeled Global server settings which opens the Global Server Configuration interface.
The Global Server Configuration interface is only available in on-premises installations. |
License
The License menu item opens the overview of the license information for your Unblu Spark installation.
If you haven’t installed a license, Unblu displays the following message:
The Upload license action lets you specify the location of a license file.
Once you upload a valid license file, the License page displays more information:
-
The Server section shows the server identifier that was used to generate the license.
-
The Current license section displays information about the license you uploaded.
If you license a new feature or license additional capacity, you must update the license. For this reason, the Current license section also has an Upload license button.
Current license
The Current license section is divided into three parts:
- Information
-
The Information section lists some basic information about the license:
-
The status of the license. The status must be Active for you to be able to use Unblu Spark.
-
Who the license was issued to.
-
The expiration date of the license.
-
The license ID.
-
- Capacities
-
The Capacities section lists how many accounts, users, teams, and domains you can configure Unblu Spark with. It also tells you how many pods you can run Unblu Spark on in your Kubernetes cluster.
- Features
-
The Features section tells you which Unblu features are enabled in the current license. You can’t enable features in Unblu Spark that aren’t enabled in the license.
If you think there are discrepancies between the capacities or features you licensed and those listed on the License page, contact your Unblu account manager.
Settings
The Settings menu item gives you access to configuration and text properties that you can set in the GLOBAL
scope.
The Settings and Text tabs are described in the Settings section of the Account Configuration interface guide.
Manage accounts
The Manage accounts menu item give you access to the Account management page. The page provides an overview of all the accounts configured on this instance of Unblu Spark and a New account button.
Cicking the New account button opens a fly-in page where you can enter the name of the new account. Click Save at the bottom of the fly-in page to create the account.
In the overview, each account is listed with its avatar, its name, and the languages there are translations of the name for. You can filter the account overview by name.
Accounts you can impersonate into also have an Impersonate button and a Delete button .
-
Clicking the Impersonate button opens the Account Configuration interface for the account in question. At the top of the interface, Unblu displays a banner to remind you that you’re impersonating into the account:
Banner in the Account Configuration interface when impersonating into an accountTo return to the Global Server Configuration interface, click the Exit action in the banner.
-
Clicking the Delete button displays a modal dialog asking you to confirm that you want to delete the account and everything related to it. If you click Delete account, Unblu deletes the account and displays a confirmation toast. Click Undo in the confirmation toast to undo the action.
To access the account your user was created in, use the user menu. You can’t delete the account your user belongs to.
Clicking an existing account opens the Account details fly-in page, which displays the account name and lists how many agents, teams, domains, and API keys the account has.
Search users
The Search users menu item lets you search for users across all accounts. You must enter at least three characters in the Search field to see results. The search considers users' first and last name, username, and email address.
Users that match your search string are listed with their first name, last name, username, email address (if available), and the account they belong to. Each user entry in the search results also has a kebab menu with two options:
-
Impersonate into account opens the account the user belongs to. It opens the account with your own user and role.
-
Impersonate user lets you view the account the way the user would see it.
Session tracking
The Session tracking menu item give you access to an interface that lets you view the current sessions on an Unblu installation. The interface is intended only to be used under guidance by Unblu.
Migration
The Migration menu item gives you access to an interface that helps you to prepare migrating configuration and text properties from one version of Unblu Spark to the next.
-
Before you start, make sure you’re on the right tab, Configuration properties or Translation properties (for text properties).
-
Next, select which versions of Unblu you want to migrate between. You can only migrate between the versions listed in the Version steps option. You can’t migrate properties directly from, say, Unblu version 6.x.x to Unblu Spark 8.x.x. To do that, first migrate from 6.x.x to 7.x.x, then from 7.x.x to 8.x.x.
-
It isn’t required that you select the Scope that the properties that you want to migrate come from. However, if you select a scope that a property can’t be set in, the protocol displays an error.
-
Finally, enter the properties and their values in the Source text area.
When you click the Migrate button, Unblu determines which changes it would make to the properties you entered if you were to migrate to the next version of Unblu. These changes appear in the Destination text area.
For each property, the protocol lists the action Unblu would take during migration to the target version. The possible actions are:
- KEEP
-
There wouldn’t be any changes to the property or its value(s).
- REPLACE_NAME
-
The property was renamed, so its name would be updated.
- REPLACE_NAME_AND_VALUE
-
The property was renamed and its value(s) changed. The property would be renamed and its value adapted.
- REPLACE_VALUE
-
The property’s value(s) changed so its value would be adapted.
- DROP
-
The property is no longer used in the target version of Unblu. It wouldn’t have an effect on the target version.
- NEW
-
The property wasn’t present in the source version of Unblu.
- NOT_FOUND
-
There’s no migration information available for the property. Check you spelled the key correctly.
- NOT_VALID
-
The property wasn’t found in the selected scope. Check you selected the right scope.
Audit
The Audit menu item provides access to the audit log. Although you can filter by all entity types, only changes to global entities are displayed in the audit log.
File interceptors
The File interceptor menu item lets you define global file upload interceptors that apply to all accounts on the Collaboration Server.
For more information on using the interface, refer to File interceptors in the Account Configuration interface guide.
See also
-
For information on using the Account Configuration guide to administer an individual Unblu account, refer to Account Configuration interface guide.
-
For more information on impersonation, refer to the description of the
SUPER_ADMIN
role in User roles.