Install Centara Server

Centara Server is a web application that runs on Internet Information Service within a Windows Server. Below are the prerequisites that must exist in order for it to run properly.

Prerequisites

To get started there's a few prerequisites that must be met.

First off, HB International will provide you with the following.

• Site-id

• GetCentara.exe

• If used; a Single-sign-on secret

Acquiring Centara Server

1. Place GetCentara.exe command line in C:\Centara

2. Run the following command from a Command terminal

cd c:\Centara
.\GetCentara server 2.7.1.600 site-id

Site names are allocated and registered by Centara support. Centara can only be downloaded to a previously registered site.

Application files will be installed to a sub-directory with the name of site-id, i.e. in the above example, Centara Server would be installed into c:\centara\site-id\CentaraServer

Web server configuration

1. Open the IIS management console

2. Add an application pool with .NET 4 Integrated Pipeline

3. Add application

   1. Assign the application pool generated in the previous step

   2. Set physical path to C:\Centara\site-id\CentaraServer

   3. Set alias to site-id

File system permissions

1. Give the Application Pool Identity read access to C:\Centara\site-id\CentaraServer and all sub-directories.

2. Give the Application Pool Identity write access to C:\Centara\site-id\CentaraServer\APP_DATA and all sub-directories.

Database configuration

1. Make sure that CLR integration is enabled. sp_configure 'show advanced options', 1; GO RECONFIGURE; GO sp_configure 'clr enabled', 1; GO RECONFIGURE; GO On some SQL Servers you may get error like this: CREATE or ALTER ASSEMBLY for assembly 'Centara.Database' with the SAFE or EXTERNAL_ACCESS option failed because the 'clr strict security' option of sp_configure is set to 1. Microsoft recommends that you sign the assembly with a certificate or asymmetric key that has a corresponding login with UNSAFE ASSEMBLY permission. Alternatively, you can trust the assembly using sp_add_trusted_assembly. For such cases you will want to execute the following script: EXEC sp_configure 'clr strict security', 0; GO RECONFIGURE; GO

2. Create a login and user for the Centara Server web application. create login CentaraServerWebApplication with password='secret-cwsa-password'

3. Create empty database owner by the user. create database CentaraServer use CentaraServer exec sp_changeDbOwner CentaraServerWebApplication

4. Create Centara.ini in c:\Centara\site-id

Centara.ini

[General]
Database=Initial Catalog=CentaraServer;Data Source=localhost;User Id=CentaraServerWebApplication;Password=secret-cwsa-password

Running Centara server

1. Browse to http://localhost/site-id

2. Choose region plugin and click Save.

3. Click on Upgrade Database. Database will be created. DBCompare will run and provide results.

   

4. Click Continue to Centara.

5. Fill out the following Server Settings and then click Save.

   1. Authentication (for single-sign-on only if applicable)

      1. Authority URL = https://users.centara.online

      2. Client-Secret = [as provided from HB International]

   2. Installation

      1. Server URL = [your site URL]

      2. Site-ID = [your site-id]

6. DBCompare will run once more to check for a need for any additional database changes. If no additional changes are needed, a screen will show that the database is up to date. Click Continue to Centara.

7. Once DBCompare has completed, a list of services will attempt or run one by one, indicating with a green light if each service has started successfully.

8. Create the administrator user providing email and password. Passwords must have at least one non letter or digit character, at least one digit ('0'-'9') and at least one uppercase ('A'-'Z'). Click Create administrator.

9. Centara Server will launch.

If single-sign-on text fields were populated then single-sign-on has been enabled. Centara Server will though need to be restarted in order for this feature to be activated.