Upgrading crul
- Mac OS 🍎
- Docker 🐳
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.
NOTE: The docker variant of crul is stateless, meaning that credentials, frozen results, and other stateful content will not persist once a container has been shut down. This also impacts upgrades.
A resolution to this issue (using docker volumes) is currently being tested and documented, and will be available soon.
Follow the installation instructions to load the upgraded image and run. As per the above note, state (credentials, frozen results, etc.) will not be maintained and must be reconfigured.