Skip to main content

Upgrading crul

IMPORTANT!

In order to maintain your configuration (credentials, etc.) it is necessary that you follow the upgrade instructions below. Otherwise, you will need to reconfigure your crul installation after upgrading.

Step 1: Download latest crul version

Download the crul-vx.x.x.tar.gz of the crul version you wish to install onto the same machine as current crul. The latest version of crul can be downloaded from the Account page.

Step 2: Backup crul

Optional but highly recommended

Make a copy of the current crul installation.

Step 3: Expand TGZ into existing crul

In a CLI, navigate the directory containing the crul-vlatest.tar.gz file.

Run the following command to expand the crul-vlatest.tar.gz file and upgrade crul. State (scheduled queries, secrets, etc.) will be maintained.

mv crul-vlatest.tar.gz /Applications && osascript -e 'quit app "crul"' && cd /Applications && tar -xzf crul-vlatest.tar.gz -C /Applications && rm -rf ~/Desktop/crul.app && mv crul.app/ ~/Desktop/ && open ~/Desktop/crul.app

Troubleshooting

Advanced

If you have a more complex directory structure, the above CLI command is described below

osascript -e 'quit app "crul"'

Close any running instance of crul.

cd /Applications

Move to the directory containing the crul application.

tar -xzf crul-vlatest.tar.gz -C /Applications

Untar the latest crul version into the existing app, this will overwrite files that have changed, while leaving configurations untouched.

rm -rf ~/Desktop/crul.app

Remove any stale copies of crul from the Desktop directory.

mv crul.app/ ~/Desktop

Move the crul application to Desktop. Due to Mac OS security requirements, a downloaded application must move itself into Applications to run, so this will move crul out so we can move it back into Applications.

open ~/Desktop/crul.app

Open crul from the Desktop directory. It will prompt itself to move.