Workaround (Before Werk Availability)

If you encounter Jira notification issues and cannot immediately update to a version containing this fix, you can manually update the Jira Python library within your site.

Step-by-step guide

1. Log in to the Checkmk server
   Access the server hosting your Checkmk site via SSH with an account that has permission to manage the site.
   
   

2. Switch to the site user
   Run the following command, replacing mysite with the name of your Checkmk site:

   root@linuxhost:~$ su mysite

    

3. Stop the site

   OMD[mysite]:~$ omd stop

    

4. Update the Jira Python library
   Install the latest available version of the Jira Python module with:

   OMD[mysite]:~$ pip3 install jira --upgrade

   • This pulls the newest Jira package from the Python Package Index.

   • It overshadows the version that ships with Checkmk.

   • Only the jira dependency is updated; other dependencies remain untouched.

    

5. Start the site to apply changes

   OMD[mysite]:~$ omd start

Remove Workaround (Before Updating Checkmk)

It is important to remove the manually updated dependency before performing the update to the Checkmk version that introduces a persistent fix. Otherwise, the package may interfere with later upgrades.

 Step-by-step guide

1. Stop the Checkmk site

   OMD[mysite]:~$ omd stop

    

2. Uninstall the manually installed Jira library

   OMD[mysite]:~$ pip3 uninstall jira

   This ensures that Checkmk’s own packaged version can be applied cleanly during the upgrade.
   
   

3. Update Checkmk
   Once the manual package is removed, continue with your regular Checkmk update process.
   
   

4. Start the site

   OMD[mysite]:~$ omd start

Related articles