Host Server Settings¶
This chapter lists and describes the available configuration options for the TeamDrive Host Server.
You can review and modify most of these via the TeamDrive Host Server Administration Console by clicking Settings. Some settings are marked as read-only (“R/O”), they can not be changed.
APIAccessList¶
A white list of IP addresses (separated by commas or spaces) of machines that are permitted to access the Host Server API. For example, the IP address of the host running the TeamDrive Registration Server Administration Console should be added here.
APIChecksumRequired¶
If set to True
, then each call to the API must include a checksum hash,
constructed using the API Hash defined in APISalt
.
APILogEntryTimeout¶
API Log entries older than this value, in days, will be removed. If set to zero the API Log entries will never be removed.
APILogging¶
Set to True
if API logging should be enabled. Every API access will be
logged in the database table hostapilog.TD2APIRequests
.
APIReturnSpaceNames¶
Set to True
if Space names should be returned through the API. This
requires the setting StoreSpaceNames
to be set to True
as well,
otherwise this option has no effect.
APISalt¶
This is a unique character sequence that must be identical to the API Salt of the associated Registration Server.
ClientPollFrequency¶
The interval in which Clients poll their Spaces for updates, in seconds. 0 or empty means the Clients will use their default.
DefaultLanguage¶
This is the default language used if the browser specifies an unknown language. This setting is only used when the user requests public files from the Hosting Service. The value is used to select the correct language template for interaction with the user. See Customizing html templates for published files for further details.
EmailOriginHost¶
This is the host name of the system that will send the email.
EmailReplyToAddress¶
This is the email address that user will see as sender of the e-mail. And it is the email address that will be used if the user replies to the email. Normally a “no-reply” type email address is used, since the user is not intended to reply to email sent by the Hosting System.
EmailSenderAddress¶
This is the email address that will appear as sender in email envelope. If an email bounces, this address will be notified.
EmailSendTimeout¶
This is the timeout in seconds used when sending emails.
EnforceTrafficLimit¶
When set to False
, the traffic quota for all Depots will be considered
unlimited.
ExtAuthEnabled¶
Set to True
to enable External Authentication. External Authentication
allows the administrative users of the Host Server to be mananged in a central
location, such as an LDAP server.
ExtAuthURL¶
This is the URL that is used by the Host Server to verify the login of a user, when using External Authentication. The Host Server adds two arguments when the URL is requested: username and password. The URL should reference a page that performs verification, and returns information about the user required by the Host Server. A generic example, and an LDAP example for performing External Authentication are provided with the Host Server distribution.
HostServerBucketID¶
A unique ID used to ensure that multiple Host Servers cannot use the same S3 bucket. This is a read-only setting that cannot be modified.
HttpsUsedByAdmin¶
Set to True
if the Host Server Admin Console must be accessed using HTTPS.
HttpsUsedByClients¶
Set to True
if the TeanDrive Clients should use HTTPS to access the data
stored in Spaces. By default this value is False
because TLS (Transport
Layer Security) is generally not required by TeamDrive as the data is
end-to-end encrypted.
HttpsUsedByPublish¶
Set to True
if published files must be uploaded and downloaded using
HTTPS. This ensures that the file content cannot be intercepted in transit
from the TeamDrive Client to the Host Server, and from the Host Server to the
web client downloading the file.
ImportS3tagFiles¶
This setting is set to True
until all S3 action tag files have been
imported by the S3 Daemon, it has no effect when TSHS is enabled. It must be
set manually to False
when all action tag files have been imported.
LogFileThreshold¶
This is the threshold (in bytes) after which a the Client last.log
is
renamed to a number log.
MaxFileAge¶
This is the maximum age, in days, that a file normally transferred to the S3 object store by the S3 Daemon can be before it is automatically transferred. Normally files are transferred just after they have been written, but if for some reason the file is not transferred this will trigger the transfer. This setting should be long enough to guarantee that no file will be transferred that is still in the process of being uploaded.
MaxRecordsDisplayed¶
This setting determines the maximum number of records that may be retrieved from the database at any a time (e.g. when displaying user or space information on the Administration Console. This parameter may only be changed by a Superuser.
ModuleLogFile¶
The path and name of the Apache module (mod_pspace
) log file. This file
must be owned and writable by the system user the Apache HTTP Server runs
under (e.g. apache
).
ModuleLogLevel¶
This is the maximum level of logging of messages logged by the Apache module
(mod_pspace
). A higher number results in more verbose logging. Possible
values are: 1 = Protocol, 2 = Error, 3 = Warning, 4 = Trace, 5 = Debug.
ProviderCode¶
This is the 4-digit code of provider (distributor/tenant) under which this this Host Server is registered. This is a read-only setting that cannot be modified after the initial server setup.
RegistrationDeviceID¶
This is the ID returned by the Registration Server upon registration. It is the ID of the user under which the Host Server is registered. This setting cannot be changed.
RegServerName¶
The name of the Registration Server associated with this host. This value cannot be altered after registration.
RegServerURL¶
This is the URL used to access the Registration Server. This value may not be altered after registration.
S3AccessKey¶
The access (public) key, used to access the specified bucket on an S3-compatible object store.
S3ArchiveLogs¶
Set this value to True
if the S3 logs used for calculating traffic are to be
archived instead of deleted.
S3AuthTimeout¶
The number of seconds an S3 authenticated query string is valid
S3Brand¶
This setting specifies the type of S3 storage. Possible options are: Amazon or OpenStack.
S3DataBucketName¶
The name of the Bucket on the S3-compatible object store that will contain the Space data
S3EnableRedirect¶
When S3 redirect is enabled, the Host Server will redirect the Client to download objects directly from the S3-compatible object store, when appropriate. The alternative is that all downloads are performed via the Host Server (the Host Server acts like a Proxy that fetches data from the object store and forwards it to the Client).
S3LogBucketName¶
The bucket that contains the S3 access log files. These log files are used to analyse and calculate traffic.
S3Options¶
S3 options control the way the S3-compatible object store is accessed. For example, the number of parallel threads during upload, whether to use multipart uploads, etc.
S3ProcessedPath¶
If S3ArchiveLogs
is set to True
, then the logs stored in
S3ToProcessPath
are moved to this path, after they have been used to
calculate traffic.
S3SecretKey¶
The S3 secret (private) key used to acces the specified bucket on the S3-compatible object store.
S3Server¶
This is the domain name of the S3-compatible object store, e.g.
s3.amazonaws.com
.
S3SyncActive¶
Set to True
when data stored by the Host Server (Space data) should be
transferred to an S3 compatible cloud storage. Transfer to S3 is possible from
both Volume storage and TSHS.
S3ToProcessPath¶
The path in which the S3 access logs are stored. The access logs are used to calculate traffic caused by direct downloads from S3 storage.
ServerVersion¶
The current server version. This value cannot be changed.
ServiceDisplayName¶
This name is displayed in the top left of the Host Server Administration Console. Initially, is is set to the domain name of the Host Server. The name is used for display purposes only, and may be set to any value.
ServiceHostURL¶
This is the Host URL used by the clients to create and access Space data. It can not be changed.
ServiceUniqueName¶
This is a unique name of the Hosting Service, consisting of the Host Server’s domain name and the associated Registration Server. This value can not be changed.
SessionTimeout¶
This is the idle time in seconds after which you are required to login to the Host Server Admin Console again.
ShowDeletedObjects¶
Set to True
to display Spaces and other objects in the Administration
Console that have the Deleted status.
SMTPServerHost (R/O)¶
This is the host (and port) of the SMTP server used to send emails.
SnapshotThreshold¶
The log threshold, in bytes, after which the Client will create a new snapshot of a Space, 0 or empty means the Client will use its default.
SpaceStatisticEnabled¶
Set to True
if Space Statistics should be exported.
SpaceStatisticExportPath¶
This is the path for the files containing the exported Space Statistics,
default is: ../docs/p1a/statistic/
.
StatisticPollFactor¶
Multiple the ClientPollFrequency
by this amount to determine the how often
the client retrieves the statistics, 0 or empty means the client will use its
default value of 5
StoreSpaceNames¶
Set to True
if the Host Server should store the names of Spaces defined by
the user.
TimeDiffTolerance¶
This is the maximum allowed difference in time between the Client and the Host Server. The value is given in seconds. Currently this setting only affects Clients using version 3 of the TeamDrive Protocol. Since the Client automatically synchronises its time with the server, the time difference should only be due to the time required to send a request from the Client to the Server.
TSHSEnabled¶
Set to True
to enable TSHS (TeamDrive Scalable Hosting Storage). If
changed, a restart of the Apache HTTP Server required.
TSHSExecutable¶
This is a reference to the tshs
executable. This path must be set
correctly if TSHS is enabled.
TSHSImportVolumes¶
This setting is set automatically when TSHS is enabled. It is set to True
if
Space data is stored on the Host Server Volumes when TSHS is enabled. It must
be set manually to False
when all data has been transfered from the Host
Volumes to TSHS.
TSHSMyCnfFile¶
This is a reference to the my.cnf
file that is used by TSHS. The
my.cnf
file must contain a group called [tshs]
which specifies the
connection to the TSHS Admin MySQL database.
UseTwoFactorAuth¶
Set to True
to enable 2-Factor Authentication via email for Superusers.