Installation on Linux

Installing .Net Core

Microsoft provides detailed documentation explaining how to install the .Net Core runtime on various Linux platforms. If you are not planning on doing any development with the CxAnalytix code, installing the SDK is not required.

It is not recommended to attempt to follow the "Manual Installation" instructions for the .Net Core install. Please use your chosen Linux distribution's package manager to install .Net Core.

Red Hat Enterprise Linux 8

sudo yum update -y ; sudo yum install -y dotnet-runtime-3.1

CxAnalytix CLI Installation

Due to Linux not requiring a file extension to indicate dotnet is executable, the name of the configuration file is a bit different. Use the following command to make a symbolic link to the dotnet.exe.config file:

ln -s dotnet.exe.config dotnet.config

Execution of the command line can be performed with the following command:

dotnet CxAnalytixCLI.dll

CxAnalytix Daemon Installation

There is not a platform-specific installer for CxAnalytix at the time this documentation was written. The following steps can be used to install the CxAnalytix Daemon on a Linux system that uses systemd.

Perform the following steps as root

1. Configure the system to have the same time zone as the SAST Manager.

2. Make directory /var/log/cxanalytix

3. Execute chown root:nobody /var/log/cxanalytix

4. Execute chmod g+w /var/log/cxanalytix

5. Make directory /etc/cxanalytix

6. Execute: chown root:nobody /etc/cxanalytix

7. Execute chmod g+w /etc/cxanalytix

8. Make the directory /opt/cxanalytix and copy the installation artifacts there.

9. Execute: chown root:nobody /opt/cxanalytix

10. Execute: chmod g+w /opt/cxanalytix

11. Modify the CxAnalytixDaemon.log4net file to output logs into /var/log/cxanalytix

12. Make a symbolic link to the /opt/cxanalytix/dotnet.exe.config file be executing: ln -s /opt/cxanalytix/dotnet.exe.config /opt/cxanalytix/dotnet.config

13. Modify /opt/cxanalytix/dotnet.exe.config file to have the appropriate connection parameters:

    1. CxConnection for the SAST and M&O connection
    2. CxCredentials for the login credentials
    3. CxAnalyticsService for:
       1. ProcessPeriodMinutes - suggest minimum 120
       2. ConcurrentThreads - suggest maximum 2*CPUs
       3. StateDataStoragePath - Use /etc/cxanalytix
    4. CxLogOutput for:
       1. Point it to /var/log/cxanalytix so that old log files can be periodically purged

14. Copy the file cxanalytix.service to /etc/systemd/system/

15. Enable the daemon by executing: systemctl enable cxanalytix

16. Start the daemon by executing: systemctl start cxanalytix