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.