Using the Administration Console

The TeamDrive Registration Server Administration Console is an application written in PHP that provides a web-based interface to perform the following tasks:

  • View and edit user records / Import users using a CSV file
  • View and edit user device records (manage clients, updates and banner)
  • View and edit licences
  • Create storage manually
  • Manage Provider-specific email and html templates
  • Manage general server and Provider-specific settings

Access to the individual sections of the Administration Console is controlled by access rights — most administration pages are only visible and accessible to users that have the required privileges.

Administrative users can be divided into three groups:

  • The default Provider is usually the first one to be created. This Provider can access and manage all aspects of the Registration Server and can access his own users, devices, settings and licences as well as those of all other providers hosted on this Registration Server. (A Registration Server’s default Provider can be changed later by modifying the global server setting DefaultProvider)
  • Additional providers can only manage their own users, licences, and their Provider-specific settings. They can not access parts like global server settings.
  • Each Provider can grant access to the Administration Console to regular users. These users can only access those sections enabled by their assigned privileges and may also only manage users of the provider they belong to.

Security Considerations

We strongly recommend accessing the Administration Console via SSL/HTTPS only. Our preconfigured Virtual Appliance images provide a self signed SSL certificate and access is possible via HTTPS only. You should replace this certificate with an official one, if this server is publicly accessible.

You can also limit access to the Administration Console to individual IP addresses, by using the built-in provider setting LOGIN/LOGIN_IP. This setting defines the IP addresses (as a comma-separated list) that are allowed to connect to the Administration Console as a given provider.

If you require more flexibility in restricing access, e.g. by restricting it to an IP address range or by host/domain names, we suggest using the Apache http Server’s built-in functionality:

https://httpd.apache.org/docs/2.2/mod/mod_authz_host.html

The safest strategy is separating the Administration Console from the Registration Server by installing it on a dedicated server, which is only accessible by you.

Logging in / Logging out

To log into the TeamDrive Registration Server Admin Console, open the Admin Console’s URL in your web browser, e.g.

https://regserver.yourdomain.com/adminconsole/

Enter your username and password to log in.

TeamDrive_AdminConsole_Login_png

Access to the Administration Console is allowed for two separate user accounts:

  • The provider accounts that manage all aspects of a provider. These accounts are defined when setting up the Registration Server or by creating additional providers on the same Registration Server.
  • Regular TeamDrive users can also log in, if they have permission to log in to the console (see User Rights).

To log out, click the Logout button in the top right hand corner of any of the console pages.

TeamDrive_AdminConsole_Header_HighlightLogout_png

Changing the Login Password

To change the password for the account you are currently logged in with, click on the Change Password button in the top right-hand corner oft the screen, next to the Logout button.

TeamDrive_AdminConsole_Header_HighlightChangePw_png

You will see a form prompting you to enter your current password and a new one. Since the password is hidden, you are required to enter it twice, to ensure you have entered it correctly.

TeamDrive_AdminConsole_ChangePw_png

Once you have entered the current and new password, click Change Password to save the change, or click Back at any time to go back to the previous page.

Managing Users

Providers have administrative privileges to manage all users associated with their provider code. If you log in as a Provider user, you will be able to create/delete/edit user records belonging to that Provider, as well as manage various additional provider specific settings. When logging in as the default Provider, you are able to manage all users as well as all provider settings.

To list users belonging to you, click Manage Users.

TeamDrive_AdminConsole_Header_ManageUsers_png

By default, all users are listed. You can narrow down the search by typing in search criteria in the Filter Table section at the top of the page, and then clicking Apply Filter.

TeamDrive_AdminConsole_FilterTable_png

Click Clear Filter at any time to go back to displaying all available users.

When filtering results, you can use the percent character (‘%’) as a wildcard: for example, entering ‘john%smith‘ into the email field will match users with an email like john.smith@td.net, johnsmith@shaw.net, johnDoeSmith@gmail.com, etc.

TeamDrive_AdminConsole_ManageUsers_png

Depending on the number of results, there may be more than one page of output. Click the numbers and arrows above the table to browse through results. To sort the table by a column value, click the column’s name in the title row.

Click Configure Columns to bring up a dialogue that allows you to customize the table output. Select the columns that should be displayed and click Update to update the table view.

TeamDrive_AdminConsole_SelectColumns_png

Click Export results to CSV file at the bottom of the result list if you want to save the resulting table output into a comma-separated text file. Your web browser will prompt you for a file name under which the file will be stored locally.

TeamDrive_AdminConsole_ExportCSV_png

Click the More Info button at the end of a user’s row of information to view the user’s licence and device details. Click Less Info to hide this information again.

TeamDrive_AdminConsole_ManageUsers_MoreInfo_png

Click the Edit button next to a user’s email address to open up the user details page, which displays all of the user’s information, including licences and the user’s devices in more detail.

TeamDrive_AdminConsole_ManageUsers_Edit_png

The user details page is divided into several blocks and will show user information about:

  • Devices
  • Licences
  • Storage depots
  • User rights
  • User data

Devices

The device list shows information about all of the user’s installed TeamDrive Clients with details about the used licence key, the creation and last active time, IP address at the time of the creation, the Client version, platform and pending messages from other users. Clicking the message number (if the value is greater than zero) displays a list of users that sent messages to this device.

Please note that it is normal for inactive devices to have pending messages, these messages will be picked up when the device becomes active again.

Devices will stop receiving new messages after their active time has been reached (defined in the global InviteOldDevicesPeriodActive configuration setting). Messages will be automatically deleted once the message store time is reached (defined in the global InvitationStoragePeriod configuration setting).

TeamDrive_AdminConsole_UserData_Devices_png

You can delete one or multiple devices by checking the Delete checklist item for the device(s) in the User Devices section and clicking the Delete button on top of the column.

Note

A deleted device can be re-activated by the user. If you don’t want the user to re-activate his installation, you have to deactivate the user’s account.

The Wipe Device functionality deletes the Device’s entry in the Registration Server’ database after the Client confimed that all local data were deleted successfully (Space directories, caches, registration information).

Licences

This block is divided into two parts.

TeamDrive_AdminConsole_UserData_Licenses_png

The first list shows licences owned by the user. By default, each user has at least one default licence.

If the licence limit is greater than one, more than one user can use the same licence key until the defined licence limit is reached.

Clicking a licence key will switch to the licence overview page. The Edit button will directly switch to the licence modification menu. See Manage Licences for more details.

Clicking Unassign <user> from licence removes the reference between the user and the license key. The key will still exist and can be assigned to another user. Clicking Assign existing licence to <user> allows you to assign an additional unassigned license key to the current user.

An overlay dialogue will be displayed:

TeamDrive_AdminConsole_Licenses_Assign_png

By clicking on an entry, the licence will be assigned to the selected user. The licence fields Contractnumber and Email will be filled with the selected user data.

The second block is only visible if the user is using a licence which belongs to another licence owner. A licence can also have no owner reference.

Clicking Create new licence for ... will open the licence creation page. See Creating Licences for details.

Space Depots

TeamDrive_AdminConsole_UserData_Depot_png

If the user has Space Depots on TeamDrive Host Servers (e.g. the default depot), the Depot information will be displayed. The first Depot usually is the default Depot (if configured), which is marked grey. If the user has additional Depots on other host servers, they will be listed here as well.

The Depot information for the user is retrieved from the Host Server via an API call. This only works if API communication to the Host Server is configured and enabled. It might take a few seconds to retrieve all Depot and Space information from the Host Server, please be patient until the table is loaded.

Clicking Change limits allows you to change the storage and transfer limits for a depot.

TeamDrive_AdminConsole_UserData_DepotLimits_png

You can list all Spaces belonging to a Depot by clicking Show Spaces. Individual Spaces can be deleted as well, by clicking Delete Space in the respective table row.

An entire Depot including all Spaces can be deleted by clicking Delete Depot.

The button Deactivate Depot allows you to temporarily disable a user’s Space Depot on the Host Server. The user’s Clients will no longer be able to synchronize the Spaces contained in this Depot (the Spaces will be marked as “Disabled”), until you click Activate Depot again. This feature was added in version 3.0.018.4 of the Registration Server and requires version 3.0.013.8 (or later) of the Host Server.

TeamDrive_AdminConsole_SDepot_ShowSpaces_png

Clicking Assign new depot to ... brings up the Depot creation page. See Create Depot for more details.

Clicking Open Host Admin opens the respective TeamDrive Host Server’s administration console in a new browser window/tab. Please refer to the Host Server documentation for more information.

User Rights

Depending on what user you log in as, you have different rights and privileges.

When you log in as a Provider, you are granted a fixed set of rights depending on whether you are the default Provider or not. The default Provider is granted all rights, and therefore has administrative access to all records and settings belonging to any other Provider.

A regular Provider is granted all rights except for the following Super admin rights:

  • HAS_EDIT_SETTINGS_RIGHTS
  • HAS_MANAGE_SERVERS_RIGHTS
  • HAS_MANAGE_TASKS_RIGHTS
  • HAS_VIEW_ALL_RECORDS_RIGHTS
  • HAS_VIEW_SERVER_LOGS_RIGHTS

This means that regular Providers have administrative access to all records associated with their account, but can not edit records belonging to other Providers, or change settings that affect all Providers.

Providers can enable access to the Administration Console for selected users and grant them individual rights.

To grant/revoke user privileges, find the user you wish to modify in the list and click edit (this requires the HAS_EDIT_USER_RIGHTS privilege).

On the user editing page, you will see a panel titled User Rights (you will only see this section if you have HAS_GRANT_PRIVILEGES_RIGHTS)

Initially, there is only an unchecked checkbox labeled User has permission to log in to this console. Unless the box is checked, this user cannot log into the console.

Checking the box enables the HAS_LOGIN_RIGHTS privilege, which allows this user to log into the Administration Console using his username and password.

After the box is checked, a list of additional available rights will be displayed. The rights that are shown depend on your own privileges — you can only grant/revoke rights that you possess yourself.

TeamDrive_AdminConsole_UserRights_png

The user’s privileges can be defined individually by checking any of the following Admin rights:

HAS_EDIT_USER_RIGHTS
The user can view/edit/delete/create user accounts, can view/delete user device records and can upload CSV files (to import user records). See Managing Users for details.
HAS_GRANT_PRIVILEGES_RIGHTS
The user is able to modify the permissions of other users (note that even with this right, users can only grant/revoke rights that they have themselves).
HAS_EDIT_LICENCE_RIGHTS
Means that this user can create/edit licences via the Manage Licences page (which is only available if licence management is enabled for this Registration Server). See Manage Licences for details.
HAS_EDIT_DISTRIBUTOR_RIGHTS
With this right, a user can edit the custom settings associated with this Provider (the Edit Provider Settings menu). See Editing Provider Settings for details.
HAS_MANAGE_BANNERS_RIGHTS
User can access the Manage Banners page. See Managing Banners for details.
HAS_MANAGE_DEPOTS_RIGHTS
User can access the Create Depot page and view / edit existing depots. See Create Depot for details.
HAS_MANAGE_EMAILS_RIGHTS
User can access the Manage Emails page to administer the email out queue. See View Mail Queue for details.
HAS_MANAGE_UPDATES_RIGHTS
User can access the Manage Updates page. See Manage Client Updates for details.
HAS_API_LOG_RIGHTS
User can access the View API Log page. See View API Log for details.
HAS_EXPORT_USERS_RIGHTS
User can export the user table to csv fromat.

And the following Super admin rights:

HAS_VIEW_ALL_RECORDS_RIGHTS
Indicates that this user can view/edit records that are associated with other providers. For example: with this privilege, a user belonging to provider D1 would be able to create/delete/edit users belonging to Provider D2. By default, only the default Provider has this privilege.
HAS_EDIT_SETTINGS_RIGHTS
This means that the user can edit server-wide settings (the Edit Settings menu). By default, only the default Provider has this privilege. See Registration Server Settings for details.
HAS_MANAGE_SERVERS_RIGHTS
The user has access to the Manage Servers page where he can en-/disable communication between the own registration server and all other servers available in the TDNS network. See Manage Servers for details.
HAS_MANAGE_TASKS_RIGHTS
User can access the Manage Auto Tasks page. See Manage Auto Tasks for details.
HAS_VIEW_SERVER_LOGS_RIGHTS
User can access the View Server Logs page. See View Server Logs for details.

Check the desired privileges you want to assign to this user and click Save Changes to apply the changes.

User Data

TeamDrive_AdminConsole_EditUserData_png

If a newly registered user has not activated his account yet (activated is set to no in the user’s details), you can activate the user’s account manually by clicking Activate user. If the user’s account was already activated, this option will not be displayed.

You can view and change the user’s details like email address, set a reference, department or the preferred language. Click Save Changes to commit any changes you made to these fields.

You can move the user to a different provider (only possible for the default provider) by clicking Set New Provider. You can define if the user will get a new depot and license based on the new provider default settings.

You can move the user to a different provider (only possible for the default provider) by clicking Set New Provider. You can define if the user will get a new depot and license based on the new provider default settings.

You can temporarily disable a user’s account by clicking Disable User. If you disable a user, the user’s Clients will receive a notification from the Registration Server and will inform the user about the account deactivation. At this point the Client disables all functionality and activity and the user can no longer use the TeamDrive service (e.g. creating Spaces, inviting users, etc.) until the account has been enabled again (access to the spaces in the filesystem is still possible).

Clicking Wipe User will wipe all of the user’s devices, delete the user’s key repositories, and disable the user. The devices of the user will delete all local data (Space directories, caches, registration information) and will delete itself on the in the Registration Server’ database. Licences and Space Depots will be preserved.

TeamDrive_AdminConsole_EditUserData_WipeUser_png

Clicking Delete User will delete the user record and all of the user’s devices. Additionally, you can choose to delete the user’s Space Depots and licences by selecting the appropriate checkboxes in the confirmation dialogue.

TeamDrive_AdminConsole_EditUserData_DeleteUser_png

You can reset a user’s password by clicking Invalidate Password in the bottom right-hand corner. The user’s Client will perform an automatic logout and ask the user to request a new temporary password which must be used to define an own new password.

Return to the main user list at any time by clicking Back in the bottom left-hand corner.

Adding Users Manually

To add a new user, click Create new user at the top of the Manage Users page.

TeamDrive_AdminConsole_Header_NewUser_png

This brings up a form where you can enter the new user’s details. Click Create user when you are done, or Back to cancel the operation and return to the user management page.

TeamDrive_AdminConsole_NewUserForm_png

In case you are logged in as the default Provider, you will see a drop-down menu allowing you to specify the Provider that this user will belong to. A regular Provider can only create users for his own account.

Note

Note that usernames need to be unique, not just locally, but across the TDNS if your Registration Server is connected to the TDNS. If you enter an username that is already registered on another Registration Server, the Administration Console will return an error.

You can either specify a password by deactivating Request password on first login, or have the user request a temporary password upon first log in (the default).

Adding Users via CSV File Import

In addition to adding users manually, you can automatically create multiple user accounts by importing them via CSV files (which could have been created by extracting the user data from another directory service or user account source).

This requires that CSV import is enabled and configured correctly in the provider settings. See chapter Importing User Accounts via CSV Files for more details on the configuration of the CSV import functionality and the structure of the CSV file.

To upload a CSV user list via the Administration Console, go to the user management page and click Upload CSV file in the top left-hand corner (Your user account needs to have the HAS_EDIT_USER_RIGHTS privilege to have access to this page).

TeamDrive_AdminConsole_UploadCSV_png

A file selection dialogue will pop up, allowing you to select a local CSV file to upload. Select a file and click Open. After the upload has finished, you will see a page that confirms if the upload was successful or if any errors occurred. Click Back to return to the user management page.

TeamDrive_AdminConsole_CSVUploadStatus_png

The users defined in the CSV file will be added or updated the next time the import script runs.

Downloading CSV Import Logs

When data is imported from a CSV file, an import log is created. This log contains information about the success/failure of the import.

Navigate to the Server Management / CSV User imports section to view a list of all uploaded CSV files, their status and the log output of the previous import run.

TeamDrive_AdminConsole_CSVLogs_png

A page will come up that lists available logs. Each uploaded file can be downloaded again by clicking Download CSV. The status of each log indicates whether the import was successful, and at what time the log was created and processed. Click Download Success or Download Error to download a log of the successful or failed import. Click Delete to remove CSV files.

TeamDrive_AdminConsole_CSVLogList_png

Click Back to return to the user management page.

Manage Clients

This section allows administrate all client related tasks, like manage Devices, Client Updates, Banners and Download Client Log Files.

TeamDrive_AdminConsole_ManageClients_TopSeg_png

Managing Devices

The Manage Devices menu provides a user independent view of all Client installations. Different filters can be defined to limit the results, e.g. by Client version, OS platform or last active date. If you are logged in as the default provider, you can restrict the result list to only display a single provider’s devices, too.

You can wipe or delete multiple devices by checking the respective devices and clicking the Wipe or Delete button on top of the column.

The result set can also be exported as a CSV file by clicking Export results to CSV file on the bottom of the table.

TeamDrive_AdminConsole_Devices_png

Manage Client Updates

To inform your users about the availability of a new version of the TeamDrive Client, you can utilize the “update notification” feature. These update notifications will only be displayed in the desktop clients and consist of HTML pages including the release notes and other update related information.

This feature can be activated and configured in the Manage Client Updates menu.

TeamDrive_AdminConsole_ManageUpdates_png

The default provider can create update notifications for any other provider record by selecting the desired Provider from the selection list on top of the page.

The admin console supports separate updates for TeamDrive 3 and 4.

For TeamDrive 3 client update notifications: You need to prepare HTML pages (with embedded CSS) that contain the notification text in advance, one for every language.

In both cases you have to upload the default update language of your available update languages in the “Provider Settings” (as defined in UPDATE/UPDATE_DEFAULT_LANG).

For TeamDrive 4 client update notifications: You could leave the HTML pages empty, only the version number is important. The TeamDrive 4 client could not display HTML pages. It will only show up, that a newer version exists.

For TeamDrive 4 client update notifications: You could leave the HTML pages empty, only the version number is important. The TeamDrive 4 client could not display HTML pages. It will only show up, that a newer version exists.

You can start by downloading the following template files as the basis:

If you don’t have prior knowledge of creating HTML and CSS, here are some useful hints for customizing these templates:

  • Open the files with any (pure) text editor
  • Ignore most of the top and scroll down to the bottom
  • Don’t change any of the “HTML commands (tags)”. A tag is everything that is in between < and >
  • Replace all the placeholder text with your update notification (headlines and new/changed features in the list)
  • If you want to change the text sizes and colors you can specify them in CSS under the “User-definable settings”

Note

Don’t change the encoding type and leave it at UTF-8. Special Unicode characters like e.g. German Umlauts must not be encoded to HTML entities. So leave all the äöüß as they are and don’t use &auml;, &ouml;, &uuml; or &szlig;.

The Version field defines the new version number you want your users to update to. The number must be provided in the form of <major>.<minor>.<maint>.<build> e.g. “3.2.2.900”.

The Active field defines whether the update notification is on, off or only be shown to a selected test user. You can specify a test user which will receive the notification every time he logs on by entering the user name in the provider setting UPDATE/UPDATE_TEST_USER.

Upload a file by selecting the local file name and clicking Add. After the HTML file has been uploaded, you can see a preview by clicking View. To upload a new version of the page, click Upload. You can obtain a copy of the page by clicking Download. To remove the page, click Delete.

By default, uploaded notifications are inactive. To test the notifications with your test user first, change Active to Test. If your tests are successful, change Active to Yes, which will trigger the update notifications for all languages of that version to be activated and displayed for all your users after the server cache has been refreshed.

Clicking Update in the TeamDrive Client update notification window will open a specified download page in the user’s local web browser.

The URL of this download page can be defined in the provider setting REDIRECT/REDIRECT_DOWNLOAD. Usually it should point to the download location where your users can obtain a new version of the TeamDrive Client, e.g. http://www.yourdomain.com/download.html.

Managing Banners

The TeamDrive 3 desktop Client applications provide space at the bottom of the application window to display “Banner Ads” or other content (e.g. notifications, announcements, etc.). Additionally, a smaller banner can be displayed in the “Create Space” dialogue.

Banners are displayed by the Client if the license assigned to it includes the “Banner Package”. This is the case for the default license that is created automatically, unless you have defined a custom default license (e.g. by changing the default value of DEFAULT_FREE_FEATURE or DEFAULT_LICENSEKEY). The provider setting BANNER/BANNER_ENABLED must be set to True.

Banners consist of static images and some surrounding HTML code that is rendered by the Client’s embedded HTML rendering engine. You can customize banners by clicking Manage Client / Manage Banners on the navigation bar. You need to be logged in as the default provider or with a user account that has the HAS_MANAGE_BANNERS_RIGHTS privilege.

TeamDrive_AdminConsole_ManageBanners_png

As the default Provider, you can choose which Provider’s banners you want to manage by selecting the appropriate name from the selection list. As a regular provider, you can only edit and manage your own banners.

Banners are language-specific, you can define which languages you want to support by adding the desired language codes (comma separated) to the provider settings BANNER/BANNER_ALLOWED_LANG and BANNER/BANNER_DEFAULT_LANG. Select the language you want to manage by selecting it from the Language drop down list.

You need to create these HTML and PNG elements separately before uploading them to the Registration Server. You can download examples for each element from the Banner management page by clicking download example page/image.

Download and modify these to match your requirements. When done, select the appropriate file for each element in the Upload Banner Files block before clicking Upload to send the files to the Registration Server in one batch.

Repeat this upload steps until you have uploaded banners for all the languages you need to support.

TeamDrive_AdminConsole_ManageBanners_Upload_png

After you uploaded all banner elements for all languages, they will be listed in the Current Banners block of the page. Clicking View will display the current element (viewing the HTML code may result in what seems like an empty page). Clicking Edit will allow you to modify the code of the HTML elements and upload another version of the PNG image for the images.

TeamDrive_AdminConsole_ManageBanners_Current_png

Note

Note that new banners will only be displayed by the Clients after a restart.

Client Log Files

The Admin Console allows downloading client log files for troubleshooting purposes.

TeamDrive_AdminConsole_DownloadClientLogs_png

Manage Licences

The menu is only visible if the provider setting LICENSE/ALLOW_MANAGE_LICENSE is set to True. Users could only access the page having the HAS_EDIT_LICENCE_RIGHTS privilege.

Each user receives a default licence when he registers a device. The feature enabled for the default licence can be defined in the Provider settings via the CLIENT/DEFAULT_FREE_FEATURE setting.

Instead of defining a default feature, it’s also possible to define a default licence key which will be used by all users by entering the licence key in the CLIENT/DEFAULT_LICENSEKEY setting.

To manage licences, click Manage Licences in the top menu bar.

TeamDrive_AdminConsole_ManageLicenses_TopSeg_png

The table can be filtered in the same way that the user table can be filtered. Enter your search criteria in the Filter table form at the top of the page, click Apply Filter to apply your criteria. Click Clear Filter to return to the full table view.

To customize the columns displayed, click Configure columns on the top right of the table. Select the desired columns and click Update to refresh the table view.

TeamDrive_AdminConsole_ManageLicenses_ConfigCols_png

As with the user page, the search results may be displayed over several pages. To export the result set in a CSV file, click Export results to CSV file at the bottom of the table. This will bring up your browser’s file saving dialogue.

To display additional details about a licence, click More Info on the right side of the row. This will list all users this licence key has been assigned to as well as the change history of the licence. Click Less Info to hide these details again.

TeamDrive_AdminConsole_ManageLicenses_MainSeg_png

Editing Licences

To edit a licence, find the licence in the Licences table and click Edit.

TeamDrive_AdminConsole_EditLicenses_png

This will bring up the licence editing menu:

TeamDrive_AdminConsole_EditLicenses_EditMenu_png

On this page, you can change various features of a licence, e.g. the Client features, number of users, owner, user as well as an expiry date.

Once you have finished making changes, click Save Changes to apply them. Delete a licence by clicking Delete license.

Each modification creates an entry in the licence’s Change History, which is displayed below the editing dialogue.

Creating Licences

For creating new licenses the provider setting LICENSE/ALLOW_CREATE_LICENSE must be set to True.

To create a new licence, click Create new licence.

If you are logged in as the default provider, you will get a select list to choose a provider for which you would like to create a licence for. Otherwise you could only create licenses for yourself.

TeamDrive_AdminConsole_CreateLicense_CreateMenu_png

Customize terms and features of the licence according to your requirements.

You can assign this licence to a user by clicking click to select user and selecting a user name from the popup window. This is optional. A licence without a user reference is an unbound licence.

Click Create Licence to create it. Clicking Back will return to the licence overview page.

Create Depot

Every user usually receives a default Space depot, if this is enabled in the provider settings (HOSTSERVER/HAS_DEFAULT_DEPOT must be set to True).

Click Create Depot to create new Space depots on a Host Server and assign them to selected users.

TeamDrive_AdminConsole_CreateDepot_png

If there is more than one Host Server associated with your provider account, you can choose the location of the Space Depot by selecting the Host Server from a dropdown list all registered servers. Please set the provider settings HOSTSERVER/AUTO_DISTRIBUTE_DEPOT to True to distribute more than the default depot to new client installation.

Type in a letter in the Depot owner field to get a list of available user names. A select list below the field will show all matching user names.

You can define a Storage Limit by entering the desired amount in the input field. By default, the traffic limit will be set to 10 times the storage limit. If required, you can modify these limits later on via the user administration page as documented in chapter Space Depots.

It is possible to assign a Space depot to multiple users. Type in a letter in Users to invite field to get a select list with matching usernames. Click on the ‘+’-sign to add more users which should also be able to create Spaces in this Depot.

Click Create Depot to finalize the Depot creation.

The user’s Clients will automatically be notified about the additional Depot.

Manage Templates

You could manage the email and html templates. The email templates will be used to send out notification emails to your users. The html templates will be shown when clicking on activation links for confirm the activation or changing the email address.

TeamDrive_AdminConsole_ManageTemplates_TopSeg_png

Manage Email Templates

The Registration Server is shipped with the default set of email templates located in /opt/teamdrive/regserver/setup/templates/email.

A new created provider will use the default templates from the file system.

TeamDrive_AdminConsole_EditEmailTemplates_png

The templates are combined into groups for a better overview. A few groups will be hidden by default, because they are not necessary in your case due to your current settings. For example: The mail templates in the group USER-INVITE-USER are only necessary, if you define a value for the provider setting REFERRAL/PROMOTION_UPGRADE. Using the button Show you could make the templates visible even you are not using them.

The templates are combined to the following groups:

TeamDrive_AdminConsole_EmailTemplatesGroups_png

  • CLIENT-INTERACTION: This is the default set of templates which are necessary in all cases. They are important for the client interaction like recieving the activation mail, sending invitation mails to other users and for password and email changes.
  • TRIAL-LICENSE: Only necessary if you offer trial licenses to your users.
  • USER-INVITE-USER: Only necessary if you offer a referral program for your users.
  • SERVER-ADMINISTRATION: These templates will only be used for the server setup and two factor authentication in the admin console.
  • API: Only necessary if you will offer an own web interface for your users and you will use the Registration Server API to allow users to register and manage their accounts. Will also be used by the adminconsole in case of changing the email address or password. You have to allow sending mails from the API using the provider setting API/API_SEND_EMAIL
  • API-LICENSE-CHANGES: Only necessary if you use the API and you want to send confirmation mails for license creation and changes.

The provider could edit the default templates by clicking Edit next to each template to open it in an editor window. The templates are using macros which are placed into [[...]] and will be substituted by a value at the time when the template will be processed. You will find a list of all macros in the chapter Templates for Client actions in the TeamDrive Registration Server Reference Guide.

TeamDrive_AdminConsole_ChangeEmailTemplates_png

By saving the changes, the modified template will be stored in the database for this provider and the default template in the file system will not be used any more.

The templates are language specific. For each language you want to support you have to create a set of email templates. The supported languages for the mail templates will be defined in the provider setting EMAIL/EMAIL_ALLOWED_LANG.

Manage HTML Templates

The Registration Server is shipped with the default set of html templates located in /opt/teamdrive/regserver/setup/templates/html.

For the html templates the Registration Server is using the same logic as for the email templates. A new created provider will use the default templates from the file system until the provider is changing one of the template. The modified version will be stored in the database.

TeamDrive_AdminConsole_EditHtmlTemplates_png

The html templates are language specific too. The supported languages for them will be defined in the provider setting ACTIVATION/ACTIVATION_ALLOWED_LANG.

Server Management

This section allows administrate all Registration Server related configurations and the possibility to view several log files.

TeamDrive_AdminConsole_ManageServers_TopSeg_png

View Mail Queue

Click View mail queue to get an overview of the current mail queue, which lists all emails that have not been delivered to the respective users yet.

TeamDrive_AdminConsole_ManageEmailQ_png

Pending outgoing emails can be shown here due to the fact that the “Send Emails” auto task hasn’t procesed the mail queue recently (such messages have the status “created”), or there were issues with the email address or when submitting messages to the MTA (the status of these messages is “failed”).

Click Reset Status to enqueue a message for delivery again. Click Delete to remove a message from the queue.

View Server Logs

The Admin Console allows viewing selected server log files for troubleshooting purposes. The View Server Logs page is only visible for the Registration Server’s default provider and any user having the HAS_VIEW_SERVER_LOGS_RIGHTS privilege.

TeamDrive_AdminConsole_ViewServerLogs_png

Depending on the availability and access permissions, the following log files can be viewed by selecting them from the selection list after Show log file:

  • /var/log/httpd/error_log
  • /var/log/td-regserver.log
  • /var/log/td-adminconsole-api.log
  • /var/log/td-adminconsole-failedlogins.log

As it requires physical read access to these logs, this feature works best when the Administration Console is installed on the same host where the Registration Server instance is running on. Log files can only be viewed if the user that the Apache HTTP Server is running under (usually apache) has the required read access privileges to view these files.

The list of log files is defined in the (read-only) Reg Server setting ServerLogFiles and can only be modified by updating the setting in the database directly.

/var/log/httpd/error_log: It’s the standard apache error log file.

/var/log/td-regserver.log: The yvva background task will log errors into this file and also the errors which might occur from the client requests will be logged to this file.

/var/log/td-adminconsole-api.log: The API requests from the admin console to the registration server API and host server API will be logged to this file.

/var/log/td-adminconsole-failedlogins.log: Failed logins to the admin console will be logged to this file.

View API Log

Most of the tasks performed via the Administration Console result in API calls being sent to the Registration Server. You can also utilize API calls in your own applications, if you need to interact with the Registration Server.

See the chapter Registration Server API in the TeamDrive Registration Server Reference Guide for an overview of the available API calls.

If you enabled the logging in your provider setting API/API_REQUEST_LOGGING and you are either logged in as the default provider or with a provider/user account that has the HAS_API_LOG_RIGHTS privilege, you can view a log of all incoming API requests and their results by clicking View API Log in the menu bar.

TeamDrive_AdminConsole_ViewAPILog_png

The API request log is stored in the Registration Server’s MySQL database and can be filtered by various criteria, e.g. Date created, User, and Command.

The default Provider is capable of viewing all API requests of all other Providers and can also apply a search filter by selecting a specific Provider name from the Provider dropdown menu. Regular Provider accounts can only view their own API requests.

Note

Note that enabling API logging by default will significantly contribute to the growth of the Registration Server’s MySQL database. On a busy site, we recommend to only enable API logging for debugging purposes or to enable the CleanUp auto task that removes log entries older than 30 days from the API log table. See Manage Auto Tasks for details.

Provider Settings

There is a number of provider specific configuration options that can be customized based on your requiremements. To edit Provider settings, click Server Management/Provider Settings in the top menu bar.

The provider specific data is devided into to parts: the provider record with the basic provider informations and the individual settings for the provider to control the features and functionality of the Registration Server.

Warning

Changes to the Provider settings will only be active after the caching period defined in RegServer/CacheIntervall has passed (the default is 1800 seconds or 30 minutes). If no cache interval was set, you need to restart the Apache HTTP Server of the Registration Server to reload these values.

Provider record

The top of the page provides a section that allows you to edit the Provider user details itself. Edit the values in the text fields and click Save Changes to make changes.

TeamDrive_AdminConsole_EditProvSet_P1_png

Depending on your privileges, you will also see an option at the very top of the page Select a Provider to edit. The page will display the values and settings for whichever Provider is selected in this box. A new provider could also be added by clicking on Add Provider.... By default, only the default Provider has access to these both options.

For adding a provider you need a valid and pre-registered provider code:

TeamDrive_AdminConsole_CreateProvider_png

Please provide values for the following required fields: the provider code you recieved from TeamDrive Systems GmbH, username, password, language, first and last name, company name and sender email.

Telephone and IP Login List are optional fields.

In case that your Registration Server is part of TDNS, you have to fill in the TDNS Server ID and TDNS Checksum.

Editing Provider Settings

The lower section of the page shows list of customizable settings for the selected Provider, grouped in categories.

The available settings and their function are described in the Reference Guide.

To change a setting, select one of the categories (e.g. AUTHSERVICE, CLIENT, EMAIL or HOSTSERVER). The settings in each group are devided in two blocks:

TeamDrive_AdminConsole_EditProvSet_P2_png

The upper white marked area with the settings which are added to the provider. Change the desired setting either by entering a new value or selecting one from the drop down menu, and click Save in that value’s row. Do not change more than one value at once — always save your change before modifiying another value. Note that not all settings are editable. To remove a setting click Unset. The entry will disappear from the upper list and could be found in the lower list now and the pre-defined default value will be used. Note that not all settings could be removed.

TeamDrive_AdminConsole_EditProvSet_P3_png

The lower grey marked area with additional settings which are not currently added to the provider and which will use the pre-defined default values. To change the default value, click on Set to add this setting for the provider and change the value as described above in the upper list. If you added all available settings, the grey marked box will disappear.

Manage Servers

Click Manage Servers in the navigation bar to perform some management tasks related to the Host Servers associated with your Registration Server and how your Registration Server communicates with other Registration Servers in the TeamDrive Network.

TeamDrive_AdminConsole_ManageHostServers_png

The Host Servers section lists all Host Servers that have been registered/associated with providers hosted on your Registration Server instance. From here you can also obtain the Activation Code that is required to finalize the Host Server installation and registration process (see the Team Drive Host Server Installation Guide for details). It’s also possible to remove a Host Server by clicking Delete Server, which detaches it from the provider account it has been registered with and deletes the corresponding user and device entry.

Note

Only a Host Server which is not already in use by clients can be deleted.

Important

Please enable HTTPS for the API communication between Registration Server and Host Server in case that your Server is configured to allow HTTPS communication (setting HostServer/API_USE_SSL_FOR_HOST).

If TDNS access is enabled (setting RegServer/TDNSEnabled), the Manage Servers page also allows you to enable communication with other Registration Servers.

TeamDrive_AdminConsole_ManageRegServers_png

Enabling a Registration Server allows your local users to directly invite users managed on that other Registration Server into their Spaces.

By default, communication with all other servers is disabled/enabled according to the RegServer/TDNSAutoWhiteList setting. This setting can either be changed directly on the Server Management/Registration Server Settings page, or on the Manage Servers page by changing the default to enabled/disabled and clicking “Save”.

Note

The communication to TeamDriveMaster must always be enabled in case your are using the TeamDrive standard client.

You can set exceptions to the current default rule by entering a specific server name in the form field at the bottom of the page and clicking “Add”. The current list of exceptions is displayed along with the the chosen default rule.

Another exception to the default is the Master Registration Server, which is enabled/disabled separately via the selection field at the top of this section of the page.

If communication with other servers is enabled by default, your Registration Server obtains a list of all known Registration Servers from the Master Registration Server “TeamDriveMaster” every 12 hours via a background task (see Manage Auto Tasks).

Registration Server Settings

By default, the Registration Server’s global settings can only be changed by the default provider. Click Server Management/Registration Server Settings in the navigation bar.

TeamDrive_AdminConsole_EditServerSettings_png

Warning

Changes to the Registration Server settings will only be active after the caching period defined in RegServer/CacheIntervall has passed (the default is 1800 seconds or 30 minutes). If no cache interval was set, you need to restart the Apache HTTP Server of the Registration Server to reload these values.

To change a setting, select one of the toplevel categories (e.g. Client or RegServer), change the desired setting either by entering a new value or selecting one from the drop down menu, and click Save in that value’s row. Do not change more than one value at once — always save your change before modifiying another value. Note that not all settings are editable.

TeamDrive_AdminConsole_EditServerSettingsSave_png

Each setting provides a short description about its meaning. All settings and possible values are explained in more detail in the Reference Guide.

Manage Auto Tasks

There is a number of background jobs that are being performed by the Yvva-based td-regserver service. The individual tasks are explained in more detail in chapter Auto Tasks.

To review and configure these automatic tasks, click Server Management -> Manage Auto Tasks in the top menu bar. Note that this option is only available to the default provider and users having the HAS_MANAGE_TASKS_RIGHTS privilege. In general it’s not necessary to change the default values.

You will see a list of currently available tasks, their status and description as well as some run time information.

TeamDrive_AdminConsole_ManageAutoTasks_png

To edit a task, click Edit next to the desired task. You will see a form that allows you to enable or disable the task and modify some of the task’s parameters, e.g. the frequency in which this task will be called.

If no frequency is provided, the task is scheduled to run every time the td-regserver background service wakes up (10 seconds by default, as defined in file /etc/td-regserver.conf).

We do not recommend to change any other settings of existing tasks or to remove or disable the system’s default tasks.

TeamDrive_AdminConsole_ManageAutoTasks_EditTask_png

After you are finished, click Save to save any changes you have made, or Back to return to the list of tasks.

TeamDrive_AdminConsole_ManageAutoTasks_CreateTask_png

To create a new task, click Create new task on top of the page. Creating new tasks can be necessary to add custom functionality which requires server side processing. New background tasks need to be implemented in PBT code and must be integrated into to Registration Server’s code base.

Fill in the form fields with the required values and click Create Task.