Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Consistent troubleshooting chapters #439

Merged
merged 3 commits into from
Jan 17, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions src/22.4/kali/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,11 @@
```{include} /22.4/kali/optional-configs.md
```

```{include} /22.4/kali/troubleshooting.md
```{include} /22.4/kali/file-system.md
```

```{include} /22.4/kali/file-system.md
```{toctree}
:hidden: true

troubleshooting
```
18 changes: 10 additions & 8 deletions src/22.4/kali/troubleshooting.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
# Troubleshooting

## Troubleshooting A Kali Linux Installation

Here are some common issues encountered during installation and steps to fix them.
Expand All @@ -10,13 +12,13 @@ If you encounter an error regarding the PostgreSQL version when running `sudo gv
```{code-block}
:caption: Error indicating the need to upgrade your PostgreSQL cluster
┌──(dev㉿kali)-[~]
└─$ sudo gvm-setup
└─$ sudo gvm-setup

[>] Starting PostgreSQL service
[-] ERROR: The default PostgreSQL version (15) is not 16 that is required by libgvmd
[-] ERROR: libgvmd needs PostgreSQL 16 to use the port 5432
[-] ERROR: Use pg_upgradecluster to update your PostgreSQL cluster
```
```

To complete the Greenbone Community Edition setup you must:

Expand All @@ -32,12 +34,12 @@ To complete the Greenbone Community Edition setup you must:
```{warning} You should consider the contents of your existing PostgreSQL database and complete any backups of that data before you complete the following steps. It's also important to consider that upgrading Kali Linux packages could disrupt the functionality of your system.
```

You can list all existing PostgreSQL clusters using the command `pg_lsclusters`.
You can list all existing PostgreSQL clusters using the command `pg_lsclusters`.

```{code-block}
:caption: Listing the existing PostgreSQL clusters
┌──(dev㉿kali)-[~]
└─$ pg_lsclusters
└─$ pg_lsclusters
Ver Cluster Port Status Owner Data directory Log file
15 main 5432 online postgres /var/lib/postgresql/15/main /var/log/postgresql/postgresql-15-main.log
16 main 5433 online postgres /var/lib/postgresql/16/main /var/log/postgresql/postgresql-16-main.log
Expand Down Expand Up @@ -89,7 +91,7 @@ Now only the new PostgreSQL cluster exists.
```{code-block}
:caption: Listing the existing PostgreSQL clusters
┌──(dev㉿kali)-[~]
└─$ pg_lsclusters
└─$ pg_lsclusters
Ver Cluster Port Status Owner Data directory Log file
16 main 5433 online postgres /var/lib/postgresql/16/main /var/log/postgresql/postgresql-16-main.log
```
Expand All @@ -106,7 +108,7 @@ sudo -u postgres psql -c 'SHOW config_file'
┌──(dev㉿kali)-[~]
└─$ sudo -u postgres psql -c 'SHOW config_file'

config_file
config_file
-----------------------------------------
/etc/postgresql/16/main/postgresql.conf
(1 row)
Expand Down Expand Up @@ -155,7 +157,7 @@ You can find all available versions of `pg-gvm` using the `apt-cache search` com
```{code-block}
:caption: Searching the Linux package repository for all versions of pg-gvm
┌──(dev㉿kali)-[~]
└─$ apt-cache search pg-gvm
└─$ apt-cache search pg-gvm
postgresql-16-pg-gvm - PostgreSQL extension for ical object manipulation
```

Expand Down Expand Up @@ -208,7 +210,7 @@ In order to complete the database cluster migration, you may also need to update
```bash
sudo apt install pgcrypto

```
```

### 6. Complete The Greenbone Community Edition Setup

Expand Down
2 changes: 1 addition & 1 deletion src/22.4/source-build/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -260,6 +260,6 @@ export NOTUS_VERSION=22.6.0
```{toctree}
:hidden: true

troubleshooting
workflows
troubleshooting
```