Installation
If this is the very first time you are installing Triofox server, it is recommended that you do the all-in-one installation by preparing a clean Windows 2012 R2/2016/2019 virtual machine and installing with all the default parameters. The All-in-one deployment is the smallest fully functional setup and can be used for production environment with < 1000 users.
Step 1: Prepare the File Storage
Triofox server is about to cloudify your file storage and enable remote and mobile access, with sync and share capability. So, the first question is: What is your file storage solution?
Your file storage can be a Windows File Server network share or any storage devices that supports CIFS/SMB protocol. It can also be from iSCSI devices that you can mount storage directly as a drive letter in the Triofox server. It can also be a container inside a private instance of OpenStack Swift, a bucket in Amazon S3 compatible storage, or a container from Windows Azure blob storage. You will need the basic access information ready. For example,
Windows File Server
If it is a Windows File Server, you will need the UNC path to the network share and the user credentials for accessing the folder.
If it is from a local C: drive or local D: drive, you will need a local user credential that has full permission to the local folder.
OpenStack Swift
If it is OpenStack Swift, you will need the authentication URL and credentials and understand the version of your authentication setup, such as KeyStone V2 or KeyStone V3 or just the classic authentication.
Amazon S3
If it is Amazon S3, you will need the Access Key and Secret Key and a Bucket Name. If the Access Key and Secret Key is from an IAM user, you will need to make sure the IAM user has full permission to the bucket.
Windows Azure Blob Storage
You will need the "Storage Account Name" and the "Primary Key" and a container name.
The initial deployment of Triofox configures the back end storage to use the
C:\Triofox
directory on the Triofox server. This default back end storage location can be changed to another location at a later time by modifying the back end storage of the default server.
Step 2: Prepare Active Directory (Optional)
If you are integrating Active Directory, you will need the following information:
- The DNS name (or IP address) of an Active Directory Domain Controller.
- A service account that can access the Active Directory.
- The DNS name of the Active Directory Domain.
If your Active Directory is remotely located with regard to the Triofox Server, then you should use Server Agent software to connect the Active Directory instead of using LDAP to connect Active Directory.
Step 3: Prepare the Database Server
If you are installing the all-in-one instance, you can skip this step because the all-in-one installer will install a PostgreSQL and configure the database accordingly. See Step 5: Start Installation below for more about the all-in-one installation. This step is only for installation that has a separate database node which is not installed by default with any worker node. All Triofox servers in a cluster will share one single centralized database.
For Triofox, the default database engine for the "all in one" deployment is PostgreSQL.
There are two places that store persistent information. The first place is the File Storage mentioned in Step 1. The second place is the Triofox database. There is configuration information such as user name, team folder, shared folder, login token in the database. There is also runtime information such as audit trace and file change log in the database.
The default Triofox deployment utilizes a MySQL local database on the Triofox Server. We provide this option to allow the trial installation to be as simple as possible.
Currently Triofox supports MySQL or Microsoft SQL Server Database Management Systems (DBMS). Some good reasons for deploying an external database server are performance, scalability and/or high availability.
Microsoft SQL Server
If you are using an external Microsoft SQL Server as opposed to the default MySQL all-in-one deployment, then you must ensure the SQL Server Authentication is configured for Mixed Mode Authentication. The Triofox Server connection requires the use of a SQL account, not a Windows integrated authentication account.
During the setup of the first worker node, the installer will need to create a database, create tables inside the database and create stored procedures in the database. Therefore, it requires a SQL security account that has enough privileges for the installation.
If the database server is external to the Triofox server, make sure TCP protocol is enabled and firewall is opened to accept SQL connections. Default TCP port is 1433 and that port needs to be opened on firewall. If you have SQL Server listening on a different port, that port will need to be opened as well.
MySQL Server
MySQL typically listens on TCP port 3306. Make sure this port is opened on the firewall.
PostgreSQL
The default TCP port for PostgreSQL is usually 5432, however this can easily be changed in the postgresql.
Step 4: Prepare the Triofox Server
The easiest way to prepare the Triofox server is to have a clean Windows Server 2012/R2/2016/2019 OS with English locale and make sure the worker nodes are all in the same time zone.
We recommend Windows server 2019 or Windows server 2016 as a preferred server OS running on a virtual machine.
Supported Operating Systems
- Windows Server 2008 R2 with latest updates
- Windows Server 2012
- Windows Server 2012 R2
- Windows Server 2016
- Windows Server 2019
Supported CPU
- 64-bit Intel or AMD x64 architecture
- 2 - virtual CPUs minimum (4 - virtual CPUs or more are recommended)
Memory
8GB RAM minimum (16 GB or more is preferred)
Hard Disk Space
100 GB minimum, preferably SSD. This assumes back end file storage is not located on the Triofox server itself.
EC2 Server Type
If you are installing Triofox in Amazon Web Service (AWS), here is the minimum AWS EC2 instance types we recommend for production use.
- t2.xlarge (general purpose, 4 vCPU, 16 GB)
- t3.xlarge (general purpose, 4 vCPU, 16 GB)
Please check the AWS EC2 Instance Types for more information.
Azure Virtual Machine Size Recommendation
If you are installing Triofox in Microsoft Windows Azure, here is the minimum Azure Virtual Machine size we recommend for production use.
- D4a V4 (4 vCPU 16GB)
- D4as V4 (4 vCPU 16GB)
- D4d V4 (4 vCPU 16GB)
- D4ds V4 (4 vCPU 16GB)
- D4 v4 (4 vCPU 16GB)
Step 5: Start Installation
You can get the Triofox installation package from the Triofox partner portal (by login to http://www.Triofox.com) and get to the Private Triofox section.
Sign into the Triofox server console (RDP or physical console are fine) with administrator rights. Once you click the "Download" button on the Partner Portal, the installer will appear either in downloads or as a link at the bottom of your browser. Click the executable file to begin the installation.
You will see the welcome screen.
Click 'Next'
And accept the EULA and click Next.
Select the path you wish to install Triofox to.
Then click Install.
Triofox will install and then you will need to restart your system to complete the installation.
After the installation, the server will need a reboot, a web browser will pop up for the initial configuration.