Deploy the Creatio .NET Core application server on Linux

Before you deploy the server, take the following steps:

• Prepare the Creatio setup files. Read more >>>

• Deploy the database server. Read more >>>

• Deploy the Creatio caching server (Redis). Read more >>>

• Modify the ConnectionStrings.config file. Read more >>>

Method 1. Deploy Creatio .NET Core on Linux directly 

To deploy the Creatio application server:

• Install .NET Core, a GDI+ compatible API for non-Windows operating systems, and development libraries and header files for GNU C. Read more >>>

• Run the Creatio application server. Read more >>>

Install .NET Core and other Creaito dependencies 

1. Download the packages-microsoft-prod package:

   wget -q https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb

2. Log in as root:

   sudo su

3. Install the downloaded package:

   dpkg -i packages-microsoft-prod.deb

4. Update the package lists:

   apt-get update

5. Install the APT transport for downloading via the HTTP Secure protocol:

   apt-get install apt-transport-https

6. Update the package lists:

   apt-get update

7. Install .NET Core:

   apt-get install dotnet-sdk-3.1

8. Install a GDI+ compatible API for non-Windows operating systems:

   apt-get install -y libgdiplus

9. Install development libraries and header files for GNU C:

   apt-get install -y libc6-dev

10. Log out from your root session:

    exit

Run the Creatio application server 

<add key="CookiesSameSiteMode" value="Lax" />

To run Creatio:

1. Open the directory that contains Creatio setup files:

   cd /path/to/application/directory/

2. Run the .NET Core server:

   COMPlus_ThreadPool_ForceMinWorkerThreads=100 dotnet Terrasoft.WebHost.dll

Creatio HTTP version will be available on port 5000.

Creatio HTTPS version will be available on port 5002.

Method 2. Deploy Creatio .NET Core on Linux using Docker 

Use this deployment method to run a compartmentalized Creatio application. We assume that you have installed the Redis sever, deployed the Creatio database, and set up the ConnectionStrings.config file using the instructions in the previous steps.

To deploy Creatio application server using Docker:

• Make Redis accessible from the Docker container. Read more >>>

• Install Docker. Read more >>>

• Create a Dockerfile. Read more >>>

• Build and run a Docker image. Read more >>>

Configure the Creatio caching server (Redis) 

1. Open redis.conf in a text editor as root. For example, use the Nano text editor:

   sudo nano /etc/redis/redis.conf

2. Locate the “bind 127.0.0.1 ::1” entry. Replace the entry with “bind 0.0.0.0” to listen to all available IPV4 interfaces.

3. Save changes and exit the editor.

4. Restart the Redis server:

   sudo systemctl restart redis-server

Install Docker 

To install Docker, run:

sudo apt-get install docker

Create a Dockerfile 

/path/to/application/directory/ is the directory that contains unpacked Creatio installation files.

1. Open the Creatio directory:

   cd /path/to/application/directory/

2. Create a Dockerfile using a text editor. For example, use the Nano text editor:

   nano Dockerfile

3. Insert the following code:

   FROM mcr.microsoft.com/dotnet/core/sdk:3.1 AS base
   EXPOSE 5000 5002
   RUN apt-get update && \
   apt-get -y --no-install-recommends install \
   libgdiplus \
   libc6-dev && \
   apt-get clean all && \
   rm -rf /var/lib/apt/lists/* /var/cache/apt/*
   WORKDIR /app
   COPY . ./
   FROM base AS final
   WORKDIR /app
   ENV ASPNETCORE_ENVIRONMENT Development
   ENV TZ US/Eastern
   ENV COMPlus_ThreadPool_ForceMinWorkerThreads 100
   ENTRYPOINT ["dotnet", "Terrasoft.WebHost.dll"]

4. Press Ctrl+O to save the changes.

5. Press Ctrl+X to exit the editor.

Build and run a Docker image 

<add key="CookiesSameSiteMode" value="Lax" />

Build a Docker image:

docker build -f Dockerfile -t creatioimg .

Run the docker image:

docker run -p http_port_number:5000 -p https_port_number:5002  -d --dns=DNS_server_ip --dns-search=DNS_address_suffix -v /logspath/mycreatio:/app/Logs --name Creatio creatioimg

http_port_number is a port number. Docker will serve the HTTP version on this port

https_port_number is a port number. Docker will serve the HTTPS version on this port

DNS_server_ip is the IP address of a DNS server that enables the container to resolve Internet domains. You can use multiple --dns flags for multiple DNS servers.

DNS_address_suffix is a DNS search domain that enables the container to search for non-fully-qualified hostnames. You can use multiple --dns-search flags for multiple DNS search domains.

Creatio HTTP version will be available on port http_port_number.

Creatio HTTPS version will be available on port https_port_number.

Configure Creatio .NET Core for HTTPS 

Before you start working in Creatio via HTTPS, take the following steps:

1. Obtain a *.pfx digital certificate from the certification center.

   Note. If you use a self-signed certificate, Creatio mobile application cannot connect to the Creatio website due to security policies of mobile applications.

2. Go to Creatio root directory and open appsettings.json.
3. Specify your website address, path to the certificate, and certificate password in the “Https” block.

"Https": {
    "Url": "https://::5002",
    "Certificate": {
    "Path": "C:\\Projects\\site\\20210215_103239\\localhost.pfx",
    "Password": "Password"
    }
}