Skip to content

Commit

Permalink
Add 1.2.2 upgrading docs
Browse files Browse the repository at this point in the history
  • Loading branch information
yhabteab committed Jul 19, 2023
1 parent ce9d04b commit 2b53be0
Showing 1 changed file with 35 additions and 0 deletions.
35 changes: 35 additions & 0 deletions doc/80-Upgrading.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,41 @@
Upgrading Icinga Certificate Monitoring is straightforward.
Usually the only manual steps involved are schema updates for the database.

## Upgrading to version 1.2.2

Icinga Certificate Monitoring version `1.2.2` requires a schema update for the database. We have dropped the use of **INI**
files to store jobs and are using the database instead. So you need to migrate your job configs to the database.

> **Warning**
>
> If you're not using Icinga Web 2 version `>= 2.12`, it's essential that you perform the migration steps in the
> exact order as described below.
If you're already using Icinga Web 2 version `>= 2.12`, then you don't need to perform any of these steps manually. Icinga
Web 2 provides you with the ability to perform such migrations in a simple way. You may be familiar with such an automation
if you're an Icinga Director user. For those who are not using the latest version of Icinga Web 2, please follow the
instructions below.

Before migrating your jobs from **INI** to the database, you need to first apply the migration script. This will create
the tables we need to store the jobs and schedules in the database.

You may use the following command to apply the database schema upgrade file:
<!-- {% if not icingaDocs %} -->

**Note:** If you haven't installed this module from packages, then please adapt the schema path to the correct installation path.

<!-- {% endif %} -->
```sql
# mysql -u root -p x509 < /usr/share/icingaweb2/modules/x509/schema/mysql-upgrades/1.2.2.sql
```

Afterward, you can safely migrate your jobs with the following command. Keep in mind that you need to specify an
Icinga Web 2 username that will be used as the author of these jobs in the database.

```
# icingacli x509 migrate jobs --author "icingaadmin"
```

## Upgrading to version 1.2.0

Icinga Certificate Monitoring version 1.2.0 requires a schema update for the database. We have changed all `timestamp`
Expand Down

0 comments on commit 2b53be0

Please sign in to comment.