> For the complete documentation index, see [llms.txt](https://docs.centara.online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.centara.online/getting-started/prerequisites.md).

# Install Centara Server

## 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
```

{% hint style="info" %}
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
{% endhint %}

## 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:**\
   \&#xNAN;*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`<br>
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*

{% code title="Centara.ini" %}

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

{% endcode %}

## 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.&#x20;

   <img src="/files/-Lhpp1T4bWHuxkYBFQlX" alt="" data-size="original">
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**. \
   &#x20;<img src="/files/-MlFn1HJCGcVVIIpJn2u" alt="" data-size="original">&#x20;
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.&#x20;
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.

![](/files/-LhpsN0-__ItMugfFdCA)

{% hint style="info" %}
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.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.centara.online/getting-started/prerequisites.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.