Installing Your CodeLogic Server on Fedora
The CodeLogic Server is installed from the CodeLogic repository using the RedHat package manager tool (RPM).
You must ensure that your system meets the specifications outlined in the CodeLogic Installation Requirements.
Internet access is only needed for installation and upgrading. Once installed, the CodeLogic Server is the package repository for the Linux and Windows agents.
The sample output is for reference only, it may differ on your system.
An ellipsis (…) indicates omitted output.
Before You Begin If you do not have internet access, see Commands for the command to list the dependencies for the CodeLogic Server. You will need to have the listed dependencies installed before installing CodeLogic.
-
Install and Configure the Docker Engine
Install the Docker Engine, version 20.10 or later, by following the instructions at: https://docs.docker.com/engine/install/centos/
Although sample output is included, please refer to the instructions at Docker Docs.
Sample output (Uninstall old versions)
$ sudo dnf remove docker \
docker-client \
docker-client-latest \
docker-common \
docker-latest \
docker-latest-logrotate \
docker-logrotate \
docker-selinux \
docker-engine-selinux \
docker-engine
…
Dependencies resolved.
…
Freed space: 17 M
Is this ok [y/N]: y
…
Complete!Sample output (Add Repo File)
$ sudo dnf -y install dnf-plugins-core
Fedora 34 - x86_64 - Updates
…
Complete!
$ sudo dnf config-manager \
--add-repo https://download.docker.com/linux/fedora/docker-ce.repo
Adding repo from: https://download.docker.com/linux/fedora/docker-ce.repoSample output (Install Docker Engine)
$ sudo dnf install docker-ce docker-ce-cli containerd.io
Docker CE Stable - x86_64 7.0 kB/s | 4.5 kB 00:00
Dependencies resolved.
…
Is this ok [y/N]: y
Downloading Packages:
…
Importing GPG key 0x621E9F35:
Userid : "Docker Release (CE rpm) <docker@docker.com>"
Fingerprint: 060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35
From : https://download.docker.com/linux/fedora/gpg
Is this ok [y/N]: y
Key imported successfully
…
Complete!Sample output (Verify Docker Engine)
$ sudo systemctl start docker
$ sudo docker run hello-world
Unable to find image 'hello-world:latest' locally
…
Status: Downloaded newer image for hello-world:latest
Hello from Docker!
This message shows that your installation appears to be working correctly.
…
$ docker --version
Docker version 20.10.6, build 370c289Configure the Docker engine to start on boot by following the instructions at:
https://docs.docker.com/engine/install/linux-postinstall/#configure-docker-to-start-on-boot.Sample output (Configure Docker to start on boot)
$ sudo systemctl enable docker.service
Created symlink /etc/systemd/system/multi-user.target.wants/docker.service → /usr/lib/systemd/system/docker.service.
$ sudo systemctl enable containerd.service
Created symlink /etc/systemd/system/multiuser.target.wants/containerd.service → /usr/lib/systemd/system/containerd.service.Install Docker Compose, version 1.27 or later, by following the instructions at: https://docs.docker.com/compose/install/#install-compose-on-linux-systems.
Sample output (Install Docker Compose)
$ sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 633 100 633 0 0 3956 0 --:--:-- --:--:-- --:--:-- 3931
100 12.1M 100 12.1M 0 0 2771k 0 0:00:04 0:00:04 --:--:-- 2911k
$ sudo chmod +x /usr/local/bin/docker-compose
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-composeSample output (Verify Docker Compose Installation)
$ docker-compose --version
docker-compose version 1.29.2, build 5becea4c -
Add the CodeLogic Repository to the Package Database
Command
Copysudo dnf config-manager --add-repo http://repo.codelogic.com/redhat/codelogic-server.repo
Sample output
$ sudo dnf config-manager \ --add-repo http://repo.codelogic.com/redhat/codelogic-server.repo
Adding repo from: http://repo.codelogic.com/redhat/codelogic-server.repo -
Command
Copysudo dnf install --assumeyes codelogic
-
-
Run the following command:
Command
Copysudo /opt/codelogic/pre_start_codelogic.sh
The script will confirm the protocol (http or https), hostname or IP address, and create a self-signed certificate for testing purposes.
-
If a signed certificate is available now, answer N to the Allow HTTP? question.
NOTEA self-signed certificate will be created regardless of the answer. The answer to this question determines the protocol (http or https) used for the software repository.
For example, if http://myserver.com is entered, the package repositories will use http. If https://myserver.com is entered, the package repositories will use https.
See Install a signed TLS certificate on the server below for more information.
-
Create a CodeLogic Administrator Account with an email address and password.
NOTEThe password must be between 8 and 256 characters in length (numbers, symbols, and mixed-case letters allowed).
-
When prompted, Would you like to install demo data? [Y/N] enter Y or N.
Demo data is provided as a resource to familiarize yourself with your CodeLogic Server and its features. For more information, see Demo Data.
NOTEDemo data is only available on new installs, not upgrades.
If CodeLogic detects an existing codelogic_neo4j_data data volume, you will not be able to overwrite the existing volume with the demo data.
-
-
Install a signed TLS certificate on the server
The signed TLS certificate and key file names must be named codelogic.crt and codelogic.key.
Copy the signed TLS certificate and key to /opt/codelogic/certs/ and restart the CodeLogic Server.
IMPORTANTThe certificate must be signed by a certificate authority. Although a self-signed certificate allows access to the GUI, the agents will not accept a self-signed certificate. For more information, see Using Internally Generated Certificates.
The self-signed certificate created by pre_start_codelogic.sh may be used for product evaluation.
Copysudo cp -p /path/to/signed/certificate.crt /opt/codelogic/certs/codelogic.crt
sudo cp -p /path/to/signed/certificate.key /opt/codelogic/certs/codelogic.key
sudo systemctl restart codelogic -
Verify that the CodeLogic Server is Running
The server is controlled via standard Linux facilities. For example, to view the status, use the systemctl command. Root permission is not needed to view the status.
Command
Copysystemctl status codelogic
Sample output
$ systemctl status codelogic
● codelogic.service - CodeLogic
Loaded: loaded (/lib/systemd/system/codelogic.service; enabled; vendor preset: enabled)
Active: active (exited) since Fri 2021-01-08 15:45:35 PST; 5h 25min ago
Docs: https://www.codelogic.com
https://info.codelogic.com/blog
Main PID: 1554 (code=exited, status=0/SUCCESS)
Tasks: 0 (limit: 19150)
Memory: 0B
CGroup: /system.slice/codelogic.service
Jan 08 15:46:01 ub20scratch docker-compose[1554]: Starting postgres ...
Jan 08 15:46:01 ub20scratch docker-compose[1554]: nginx is up-to-date
Jan 08 15:46:01 ub20scratch docker-compose[1554]: codelogic_autoheal_1 is up-to-date
Jan 08 15:46:01 ub20scratch docker-compose[1554]: mongodb is up-to-date
Jan 08 15:46:01 ub20scratch docker-compose[1554]: Starting neo4j ...
Jan 08 15:46:06 ub20scratch docker-compose[1554]: [69B blob data]
Jan 08 15:46:08 ub20scratch docker-compose[1554]: [77B blob data]
Jan 08 15:46:09 ub20scratch docker-compose[1554]: [77B blob data]
Jan 08 15:46:14 ub20scratch docker-compose[1554]: [125B blob data]
Jan 08 15:46:18 ub20scratch docker-compose[1554]: [48B blob data] -
Log in to the CodeLogic Server with the CodeLogic Administrator Account you created above.
If a signed TLS certificate has been copied to /opt/codelogic/certs, use https to log in the server using the default credentials.
If “y” was the response to the “Allow HTTP?” question, use http.
CopyURL (https): https://your_server/
URL (http): http://your_server/
Email: <email address>
Password: <password>NOTEYou MUST replace
your_server
with the actual address of your CodeLogic Server.NOTEIt may take 2-3 minutes after restarting CodeLogic before login is available.