Installation

Warning

If this is the very first time you are installing CentreStack server, it is recommended that you do the all-in-one installation by preparing a clean Windows 2022/2019/2016 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

CentreStack 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 CentreStack 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.

Note

The initial deployment of CentreStack configures the back end storage to use the C:\CentreStack directory on the CentreStack 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 tenant. Each CentreStack tenant can be configured for different back end storage locations.

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.

Note

If your Active Directory or the client’s Active Directory is remotely located with regard to the CentreStack Server, then you should use Server Agent software to connect the Active Directory instead of using LDAP to connect Active Directory.

Note

If you are using Single Sign-On service such as Azure AD, Active Directory Federation Service, OneLogin or OKTA, you can confige SAML based authentication instead of using Active Directory directly. Normally those identity service providers are connected to the corporate Active Directory anyway.

Step 3: Prepare the Database Server

Note

If you are installing the all-in-one instance, you can skip this step because the all-in-one installer will install a MySQL Community Edition 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 CentreStack servers in a cluster will share one single centralized database.

Warning

With the release of the CentreStack version 9.5.5409.41172, the default database engine for the “all in one” deployment has switched to PostgreSQL or MySQL Community Edition as opposed to Microsoft SQL Server Express Edition. The main reason to make this switch was to avoid the built-in limitations of SQL Server Express Edition (1 GB RAM and 10 GB max database file size).

There are two places that store persistent information. The first place is the File Storage mentioned in Step 1. The second place is the CentreStack 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 CentreStack deployment utilizes a MySQL local database on the CentreStack Server. We provide this option to allow the trial installation to be as simple as possible.

Currently CentreStack 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 CentreStack 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 CentreStack 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 Server

PostgreSQL usually is the default option for the all-in-one installation. The default port is 5679 but most of the time the database is running on the “localhost”, same as the CentreStack server.

Step 4: Prepare the CentreStack Server

The easiest way to prepare the CentreStack server is to have a clean Windows Server 2022/2019/2016 OS with English locale and make sure the worker nodes are all in the same time zone.

We recommend Windows server 2022, 2019 or Windows server 2016 as a preferred server OS running on a virtual machine.

Supported Operating Systems
  • Windows Server 2022

  • Windows Server 2019

  • Windows Server 2016

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 CentreStack server itself.

Step 5: Start Installation

You can get the CentreStack installation package from the CentreStack partner portal (by logging in to http://www.centrestack.com) and going to the Private CentreStack section.

_images/image_s2_5_1_v3.png

Sign into the CentreStack 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.

_images/image_s2_5_2_v3.png

Click ‘Next’

And accept the EULA

_images/image_s2_5_3_v3.png

Click ‘Next’

_images/image_s2_5_5_v3.png

And Click Install.

_images/image_s2_5_6_v2.png

After the installation has been completed successfully, a reboot is required. Click ‘Restart’.

Note

CentreStack will install and then you will need to restart your system to complete the installation.

Note

CentreStack is a multi-tenant solution. The Tenant Manager scope is defined for a tenant administrator. For a multi-tenant Cluster Server system, each tenant has an administrator. For a single-tenant Cluster Server system, the default cluster administrator is also the tenant administrator.

Warning

After the reboot and login to the Windows session again with the same Windows admin user credential, it may take 3-5 minutes before all the windows services start and a web browser page will pop-up.

For the next screen, if you have an existing database use the pull-down menu to select a different option otherwise use the default which will also install the PostgreSQL Community Edition database.

_images/image_s2_5_7_v2.png

In the next screen, enter your Partner Account login credentials to complete the installation.

_images/image_s2_5_8_v4.png