Release Notes - Version 2.0¶
The “White Label” settings have been renamed to “Build Image” settings. In addition, the setting
UseWhiteLabeldDockerImagehas been removed and the
WhiteLabelINIFileSettingssetting has been rename to
UseWhiteLabeldDockerImageis no longer required because all Web Portals now use the image build settings to create a new Docker image on upgrade, if necessary.
WhiteLabelIdleTimeouthas been renamed to
ContainerIdleTimeoutand is now a “Docker Setting” (see ContainerIdleTimeout).
IdleContainerTimeoutsetting has been renamed to
RemoveIdleContainerTimeto better distinguish this value from
SharedIniPathyou can specify a global path for the “teamdrive.ini” file (WEBCLIENT-350).
WhiteLabelINIFileSettingshas be rename to
ClientSettingsand is now a “General Setting”. Client settings that are set using the
ClientSettingssetting are then written to the
teamdrive.inifile. If a
SharedIniPathis specified, then they are read by the all TeamDrive agents, when a container starts. If not, then the client settings are written to the
/etc/teamdrive.inifile, which is part of the container image.
AgentCommandLineArgssettings is a read-only variable that specifies the command line arguments that are passed to the TeamDrive agent when the container starts.
MaxLoginLogAgesettings. These settings are used to detect Denial of Service and other brute force attacks targeting the Web Portal login (WEBCLIENT-344). See MaxLoginRate and MaxLoginLogAge for details.
Error messages returned by the Web Portal are now use the translation file provided by the TeamDrive Agent.
ContainerHostssetting (see ContainerHosts). Use this to specify entries for the “/etc/hosts” file of the container (WEBCLIENT-139).
You can now configure a proxy during setup of the Web Portal (WEBCLIENT-338).
Falsethe Web Portal now uses external authentication as required by the user, provided you are using TeamDrive Agent 126.96.36.19956 or later (WEBCLIENT-335).
As before, if
True, then Web Portal uses a specific authentication service (as specified by
See AuthServiceEnabled for more details.
Admin Consolesettings group.
The Web Portal will now redirect to another Web Portal, if a user attempts to login to the incorrect Web Portal (WEBCLIENT-333). This is done of the provider of the user is not in the list of
On the Registration Server of the user, you must set the
WEBPORTAL_API_URLprovider setting. This setting specifies the domain name of the Web Portal used by the provider. In addition, Registration Server version 4.5.4 is required. This version implements the “webportal” redirect required to implement this functionality.
If any of these conditions is not met, then the user will get the error message: “The provider you are registered to is not enabled for this web portal”.
Set the minimum client Agent version to 188.8.131.5207. This versio support the Web Portal redirect, and includes some error message improvements.
Setting the default distributor code, and language using the
extauth/login.htmlpages is not longer supported.
Added Multi-Registration Server support.
Fixed agent download URL.
All documents and security relavent data stored in containers run by the web portal are now encrypted when using TeamDrive Agent version 4.7 or later.
Encryption activates the so-called “super PIN” functionality implemented by Registration Server 4.2. When the super PIN is activated for an account the user is required to print out and save a 56-digit super PIN, and recovery URL (in the form of QR code) in a secure place.
After activation of the super PIN functionality the user can only access their account using their password, or the super PIN, or the recovery code (which can be retrieved using the recovery URL). Changing your password is also only possible using either the super PIN or recovery code.
Changes made to support local encryption of inboxes. Encryption of inboxes required Registration Server version 4.2 or later, and TeamDrive Agent version 4.7 or later.
ContainerDatabasessetting (WEBCLIENT-334). This setting allows you to specify an alternative path for the SQLite databases used by the containers. Normally all data is placed in the
When specified the new location will be mounted in the container under the path: “/teamdrive/dbs”. However, this path will only be used if you build a new image using the TeamDrive Agent version 184.108.40.20637 or later.
This version of the client supports the “–database-path” option which allows you to specify an alternative path for the SQLite database. When
ContainerDatabasesis set, the image build process will automatically add this option to the start parameters of the agent (see
- Changes for yvva 1.5.2 compatibility.
- Fixed a problem removing container data, remove directory was failing when a ‘$’ was in the path name.
- The Web Portal will now correctly use the database specified in the “td-webportal.my.cnf” file (WEBCLIENT-296). Previously the database name was hard-coded to “webportal”.
- Fixed: in case of an exception the temporary file created by syscall() is not be deleted (WEBCLIENT-316).
- Fixed: HTML entities conversion problem when editing setting “WhiteLabelDockerfile” (WEBCLIENT-323).
- When the docker image in being updated, the Web GUI will now return the error “Upgrade in progress, please try again shortly”, when the user attempts to login.
- Added API functions to enable and disabled a container (WEBCLIENT-324).
- Added support for “prelogin” call in order to support login changes (WEBCLIENT-327).
- Added “sqlite-synchronous=normal” as start parameter for the agents to reduce SQLite flush frequency
- Set client version to 220.127.116.1119
- Increased MinimumAgentVersion to 18.104.22.1685.
- Fixed problems the on demand creation and starting of containers that have been deleted (WEBCLIENT-304).
Please follow the new update process described in chapter Upgrading the TeamDrive Web Portal. The former separate GUI rpm package is not longer necessary. The standard Web Portal will update the docker Container image from the docker hub during the update step and will extract and update the files necessary for the GUI from this image. A white label Web Portal needs the white label agent .tar.gz to build a white label docker container image.
- Initial release of Web Portal 2.0.
Upgrading from previous versions of the Web Portal¶
As of version 2.0.4 you must run the
upgrade_now command from the console after
installing a new version of the Web Portal.
This command updates the database structure and the docker image used by the Web Portal. The Admin Console may return errors, and other random errors may occur before the upgrade had been completed.
To update the database structure and docker image start
upgrade_now;;. This command also upgrade the container image
used by the Web Portal. See the chapter Upgrading the TeamDrive Web Portal for details.
Key features and changes¶
Increased MinimumAgentVersion to 22.214.171.1248
External authentication supports both login and registration. This feature can be activated by setting
AuthServiceEnabledto True. To allow registration set
RegistrationEnabledto True. If no
RegistrationURLpage is specified then the Web Portal will use the “portal pages”, provided by the Registration Server.
External authentication can be embedded in the TeamDrive Web GUI, or can the external authentication pages can be used directly. A new setting:
UseEmbeddedLogin, must be set to
Truein order to use the embedded login form.
UseEmbeddedLoginis set to
Falseif you upgrade from a previous version of the Web Portal that was using external authentication. Otherwise, the default is
True. This is to ensure backwards compatibility, with previous versions that only supported the non-embedded form.
Accessing the Web Portal domain, for example:
https://webportal.yourdomain.com, will automatically present the login in the embedded or non-embedded form, as specified by
You can now use “explicit” links to the login page in order to set the default provider code and language, for the login or registration.
For the non-embedded login form use the following explicit link:
and for the embedded login form use the following explicit link:
CODEis the provider code, and
LGis the language code, for example
Note that the external authentication service must be able to handle the specified provider code and language.
Added a Container list page, which can be used to search for containers of a particular user and type. The container details page allows you to stop, start and delete containers.
Note that deleting a container will remove all the container data as well. This means that Web Portal users will find all spaces deactivated on next login. If the user looses his password he will also loose access to his data, unless he has a TeamDrive installation elsewhere.