Docs: add dependency installation commands for RHEL based systems #2059
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
|
underdarknl
previously approved these changes
Nov 27, 2023
|
@Stef16Robbe thank you! RHEL should be a first class citizen in the OpenKat ecosystem. |
Rieven
reviewed
Nov 27, 2023
Co-authored-by: Rieven <[email protected]>
ammar92
previously approved these changes
Nov 28, 2023
|
@Stef16Robbe Thanks! This is a nice addition to our docs. I'm currently trying to get it to work on Fedora. During the build phase it has troubles connecting and building the Postgres database. Haven't figured out yet what is going wrong, so I'll continue debugging. |
@stephanie0x00 Good thing you double checked! On my current working install I also get some Postgres "Connection refused" logs, but it does work after a few tries: I did a sanity check on a completely clean install again, and I seem to run into the same issue as you are: On my working system I haven't done any installs related to postgres (to my knowledge, I checked my dnf history), so I'm not sure where this is coming from. First thoughts were installing postgresql, and initializing the database using nc is looking for the postgres server so I thought I should start it: But I'm not familiar enough yet with OpenKat's build process to solve this immediately but I'll look into it. |
|
I think I've found the culprit. The
[
{
"Id": "8fce43ca81084c2802f622576f5b0eb51ad9ce233e4f5945887e7a8fb69180a7",
"Created": "2023-11-28T18:54:50.722449397Z",
"Path": "docker-entrypoint.sh",
"Args": [
"postgres"
],
"State": {
"Status": "restarting",
"Running": true,
"Paused": false,
"Restarting": true,
"OOMKilled": false,
"Dead": false,
"Pid": 0,
"ExitCode": 1,
"Error": "",
"StartedAt": "2023-11-28T19:05:43.225254661Z",
"FinishedAt": "2023-11-28T19:05:43.497627847Z",
"Health": {
"Status": "unhealthy",
"FailingStreak": 0,
"Log": []
}
},
"Image": "sha256:8cde386e2e85cce0eb684d0b27ddf6a8abbecd05d5af43bbbdf7be12c47c44e8",
"ResolvConfPath": "/var/lib/docker/containers/8fce43ca81084c2802f622576f5b0eb51ad9ce233e4f5945887e7a8fb69180a7/resolv.conf",
"HostnamePath": "/var/lib/docker/containers/8fce43ca81084c2802f622576f5b0eb51ad9ce233e4f5945887e7a8fb69180a7/hostname",
"HostsPath": "/var/lib/docker/containers/8fce43ca81084c2802f622576f5b0eb51ad9ce233e4f5945887e7a8fb69180a7/hosts",
"LogPath": "/var/lib/docker/containers/8fce43ca81084c2802f622576f5b0eb51ad9ce233e4f5945887e7a8fb69180a7/8fce43ca81084c2802f622576f5b0eb51ad9ce233e4f5945887e7a8fb69180a7-json.log",
"Name": "/nl-kat-coordination_postgres_1",
"RestartCount": 20,
"Driver": "overlay2",
"Platform": "linux",
"MountLabel": "",
"ProcessLabel": "",
"AppArmorProfile": "",
"ExecIDs": null,
"HostConfig": {
"Binds": [
"/home/vm/nl-kat-coordination/init-user-db.sh:/docker-entrypoint-initdb.d/init-user-db.sh:rw",
"nl-kat-coordination_postgres-data:/var/lib/postgresql/data:rw"
],
"ContainerIDFile": "",
"LogConfig": {
"Type": "json-file",
"Config": {}
},
"NetworkMode": "nl-kat-coordination_default",
"PortBindings": {
"5432/tcp": [
{
"HostIp": "127.0.0.1",
"HostPort": "5432"
}
]
},
"RestartPolicy": {
"Name": "unless-stopped",
"MaximumRetryCount": 0
},
"AutoRemove": false,
"VolumeDriver": "",
"VolumesFrom": [],
"ConsoleSize": [
0,
0
],
"CapAdd": null,
"CapDrop": null,
"CgroupnsMode": "private",
"Dns": null,
"DnsOptions": null,
"DnsSearch": null,
"ExtraHosts": null,
"GroupAdd": null,
"IpcMode": "private",
"Cgroup": "",
"Links": null,
"OomScoreAdj": 0,
"PidMode": "",
"Privileged": false,
"PublishAllPorts": false,
"ReadonlyRootfs": false,
"SecurityOpt": null,
"UTSMode": "",
"UsernsMode": "",
"ShmSize": 268435456,
"Runtime": "runc",
"Isolation": "",
"CpuShares": 0,
"Memory": 0,
"NanoCpus": 0,
"CgroupParent": "",
"BlkioWeight": 0,
"BlkioWeightDevice": null,
"BlkioDeviceReadBps": null,
"BlkioDeviceWriteBps": null,
"BlkioDeviceReadIOps": null,
"BlkioDeviceWriteIOps": null,
"CpuPeriod": 0,
"CpuQuota": 0,
"CpuRealtimePeriod": 0,
"CpuRealtimeRuntime": 0,
"CpusetCpus": "",
"CpusetMems": "",
"Devices": null,
"DeviceCgroupRules": null,
"DeviceRequests": null,
"MemoryReservation": 0,
"MemorySwap": 0,
"MemorySwappiness": null,
"OomKillDisable": null,
"PidsLimit": null,
"Ulimits": null,
"CpuCount": 0,
"CpuPercent": 0,
"IOMaximumIOps": 0,
"IOMaximumBandwidth": 0,
"MaskedPaths": [
"/proc/asound",
"/proc/acpi",
"/proc/kcore",
"/proc/keys",
"/proc/latency_stats",
"/proc/timer_list",
"/proc/timer_stats",
"/proc/sched_debug",
"/proc/scsi",
"/sys/firmware",
"/sys/devices/virtual/powercap"
],
"ReadonlyPaths": [
"/proc/bus",
"/proc/fs",
"/proc/irq",
"/proc/sys",
"/proc/sysrq-trigger"
]
},
"GraphDriver": {
"Data": {
"LowerDir": "/var/lib/docker/overlay2/cf1cb3f8f161bbc01e214c3de0a99bab32fd27f23f5bdd0afcee67fcbcf8d8cc-init/diff:/var/lib/docker/overlay2/bf11b07e05c7804886f05b5c2899175e59e2a1746bf297b5346b2705dca200d8/diff:/var/lib/docker/overlay2/cc80e97863ae501c650527a801daf421c5da854becdadfeea450366f4530fe80/diff:/var/lib/docker/overlay2/bdf0410de364bdf60dd8faf79b8434a60849998b7463e2bc5140c81becb5c587/diff:/var/lib/docker/overlay2/85851aede087b2dbcb1cbe5a34baaac6a4d40d8859ba6a296c6bd74e2b89ba0d/diff:/var/lib/docker/overlay2/4329defb157d543487caecacea39a3bbb58cd36eedcf96bef634c6c8ccb52fd4/diff:/var/lib/docker/overlay2/bc841e2dffe9406e0e27049fa50b0e1de106838ad55f765d3466c66318fbf251/diff:/var/lib/docker/overlay2/b3a6a25854a677f1c3ef7c3f98d15becb71cf7a53ea4b16938499801696e9544/diff:/var/lib/docker/overlay2/5bcca77da300879d0a8e0ef010ad2054d8e746be443be4cbf24be6d31bb06a81/diff:/var/lib/docker/overlay2/0f68c186f48ae8b52cb2f588593a5c93ef48fe783abb6b9061551ad3ad1f5071/diff:/var/lib/docker/overlay2/c35617472e3b40877315b4c60fa2bb0dd9127e22f25f3366c3b45dbeb84c3c5f/diff:/var/lib/docker/overlay2/29465a8d0cc609b6910431eac602a97916f748c8f5e0587175f73805c73df380/diff:/var/lib/docker/overlay2/d688d1b0a16dcbb361b560201e06c7afa14d8d28ea8dd9456d2901413592c379/diff:/var/lib/docker/overlay2/328aa7e6f630e61da5cc8f6f31201669d08e1db97b99a268f79ccabd10d119c9/diff",
"MergedDir": "/var/lib/docker/overlay2/cf1cb3f8f161bbc01e214c3de0a99bab32fd27f23f5bdd0afcee67fcbcf8d8cc/merged",
"UpperDir": "/var/lib/docker/overlay2/cf1cb3f8f161bbc01e214c3de0a99bab32fd27f23f5bdd0afcee67fcbcf8d8cc/diff",
"WorkDir": "/var/lib/docker/overlay2/cf1cb3f8f161bbc01e214c3de0a99bab32fd27f23f5bdd0afcee67fcbcf8d8cc/work"
},
"Name": "overlay2"
},
"Mounts": [
{
"Type": "bind",
"Source": "/home/vm/nl-kat-coordination/init-user-db.sh",
"Destination": "/docker-entrypoint-initdb.d/init-user-db.sh",
"Mode": "rw",
"RW": true,
"Propagation": "rprivate"
},
{
"Type": "volume",
"Name": "nl-kat-coordination_postgres-data",
"Source": "/var/lib/docker/volumes/nl-kat-coordination_postgres-data/_data",
"Destination": "/var/lib/postgresql/data",
"Driver": "local",
"Mode": "rw",
"RW": true,
"Propagation": ""
}
],
"Config": {
"Hostname": "8fce43ca8108",
"Domainname": "",
"User": "",
"AttachStdin": false,
"AttachStdout": false,
"AttachStderr": false,
"ExposedPorts": {
"5432/tcp": {}
},
"Tty": false,
"OpenStdin": false,
"StdinOnce": false,
"Env": [
"DATABASE_MIGRATION=true",
"DEBUG=True",
"TWOFACTOR_ENABLED=False",
"OCTOPOES_API=http://octopoes_api:80",
"SCHEDULER_API=http://scheduler:8000",
"KEIKO_API=http://keiko:8000",
"KATALOGUS_API=http://katalogus:8000",
"XTDB_URI=http://crux:3000",
"BOEFJE_API=http://boefje:8000",
"BYTES_API=http://bytes:8000",
"DJANGO_SUPERUSER_EMAIL=superuser@localhost",
"DJANGO_SUPERUSER_FULL_NAME=KAT Superuser",
"DJANGO_ALLOWED_HOSTS=127.0.0.1,localhost",
"DJANGO_CSRF_TRUSTED_ORIGINS=http://localhost,http://127.0.0.1",
"ROCKY_DB_USER_CREATEDB=CREATEDB",
"POSTGRES_USER=postgres",
"POSTGRES_PASSWORD=",
"RABBITMQ_DEFAULT_VHOST=kat",
"RABBITMQ_DEFAULT_USER=",
"RABBITMQ_DEFAULT_PASS=",
"QUEUE_URI=amqp://:@rabbitmq:5672/kat",
"BYTES_USERNAME=",
"BYTES_PASSWORD=",
"DJANGO_SUPERUSER_PASSWORD=",
"SECRET_KEY=",
"ROCKY_DB=rocky",
"ROCKY_DB_USER=rocky_app",
"ROCKY_DB_HOST=postgres",
"ROCKY_DB_PORT=5432",
"ROCKY_DB_PASSWORD=",
"KATALOGUS_DB=katalogus",
"KATALOGUS_DB_USER=katalogus_app",
"KATALOGUS_DB_PASSWORD=",
"KATALOGUS_DB_URI=postgresql://katalogus_app:@postgres:5432/katalogus",
"BYTES_SECRET=",
"BYTES_DB=bytes",
"BYTES_DB_USER=bytes_app",
"BYTES_DB_PASSWORD=",
"BYTES_DB_URI=postgresql://bytes_app:@postgres:5432/bytes",
"SCHEDULER_DB=scheduler",
"SCHEDULER_DB_USER=scheduler_app",
"SCHEDULER_DB_PASSWORD=",
"SCHEDULER_DB_URI=postgresql://scheduler_app:@postgres:5432/scheduler",
"APPS=ROCKY BYTES KATALOGUS SCHEDULER",
"PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/postgresql/15/bin",
"GOSU_VERSION=1.16",
"LANG=en_US.utf8",
"PG_MAJOR=15",
"PG_VERSION=15.5-1.pgdg120+1",
"PGDATA=/var/lib/postgresql/data"
],
"Cmd": [
"postgres"
],
"Healthcheck": {
"Test": [
"CMD",
"gosu",
"postgres",
"pg_isready"
],
"Interval": 10000000000,
"Retries": 10
},
"Image": "postgres:15",
"Volumes": {
"/docker-entrypoint-initdb.d/init-user-db.sh": {},
"/var/lib/postgresql/data": {}
},
"WorkingDir": "",
"Entrypoint": [
"docker-entrypoint.sh"
],
"OnBuild": null,
"Labels": {
"com.docker.compose.config-hash": "0219337d410e4efac50465a3746714f2846b85d968cd16f0749a26bd1003d99c",
"com.docker.compose.container-number": "1",
"com.docker.compose.oneoff": "False",
"com.docker.compose.project": "nl-kat-coordination",
"com.docker.compose.project.config_files": "../docker-compose.yml",
"com.docker.compose.project.working_dir": "/home/vm/nl-kat-coordination",
"com.docker.compose.service": "postgres",
"com.docker.compose.version": "1.29.2"
},
"StopSignal": "SIGINT"
},
"NetworkSettings": {
"Bridge": "",
"SandboxID": "9a022ccb9a8ba468571495441ac28549b167293fede232ca7a0c691a3b6f2a25",
"HairpinMode": false,
"LinkLocalIPv6Address": "",
"LinkLocalIPv6PrefixLen": 0,
"Ports": {},
"SandboxKey": "/var/run/docker/netns/9a022ccb9a8b",
"SecondaryIPAddresses": null,
"SecondaryIPv6Addresses": null,
"EndpointID": "",
"Gateway": "",
"GlobalIPv6Address": "",
"GlobalIPv6PrefixLen": 0,
"IPAddress": "",
"IPPrefixLen": 0,
"IPv6Gateway": "",
"MacAddress": "",
"Networks": {
"nl-kat-coordination_default": {
"IPAMConfig": null,
"Links": null,
"Aliases": [
"8fce43ca8108",
"postgres"
],
"NetworkID": "75a2e81d9e566d2696a2bb3ee96503ec09a0ec7cb41df00f6d202162558ddc19",
"EndpointID": "",
"Gateway": "",
"IPAddress": "",
"IPPrefixLen": 0,
"IPv6Gateway": "",
"GlobalIPv6Address": "",
"GlobalIPv6PrefixLen": 0,
"MacAddress": "",
"DriverOpts": null
}
}
}
}
] |
|
The error says it all basically, and it can also be seen in the After that everything ran smoothly and I was able to start OpenKat and walk through the onboarding.
|
|
@Stef16Robbe The installation of What I also noticed was that our current installation steps are a bit confusing as to whether or not to install Docker from the repositories, as we mention that |
Make it more clear when to install from the Docker repositories, add the docker-compose symlink and add 'make env'.
stephanie0x00
previously approved these changes
Dec 4, 2023
Fixed trailing spaces
underdarknl
approved these changes
Dec 5, 2023
jpbruinsslot
added a commit
that referenced
this pull request
Dec 6, 2023
* main: (25 commits) Create object history API (#2074) Bump actions/github-script from 6 to 7 (#2076) Installation manual for Windows (2) (#2096) Update howdoesitwork.rst (#2091) Add benchmarking script to the scheduler (#2071) Add fix-poetry-merge-conflict makefile command (#2088) Bump sphinx-rtd-theme from 1.2.2 to 2.0.0 (#2080) Lower quality level so the CI check doesn't fail (#2086) Update xtdb version in octopoes CI docker compose and docker-compose.release-example.yml (#2085) Name test nodes by testname instead of uuid (#2087) Upgrade to Pydantic v2 (#1912) Docs: add dependency installation commands for RHEL based systems (#2059) Fix/2072 (#2082) Feature/service to systems reports rocky (#2073) Update scheduler python packages (#2062) Add uvicorn back as non-dev dependency (#2053) Bump `cryptography` (#2070) Filter tree objects with depth=1 for Findings (#1982) Bump aiohttp from 3.8.6 to 3.9.0 in /boefjes (#2061) Translations update from Hosted Weblate (#2057) ...
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Changes
docs/source/technical_design/localinstall.rstIssue link
Closes 2058
Demo
N.A.
Code Checklist
Communication
Checklist for code reviewers:
Copy-paste the checklist from the docs/source/templates folder into your comment.
Checklist for QA:
Copy-paste the checklist from the docs/source/templates folder into your comment.