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.

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

Step 4: Open the crul application​

Open the crul application located in the ~/Desktop/ directory. It will prompt itself to move to the /Applications, once confirmed, crul will restart with the update applied.

Troubleshooting​

If crul becomes stuck during initialization or exits suddenly, try restarting crul.

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.

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 /Applications/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.