2017-09-21 22:51:26 +00:00
|
|
|
Updating Fleet
|
|
|
|
==============
|
2017-02-24 19:11:46 +00:00
|
|
|
|
2017-09-21 22:51:26 +00:00
|
|
|
This guide explains how to update and run new versions of Fleet. For initial installation instructions, see [Installing Fleet](./installing-fleet.md).
|
2017-02-24 19:11:46 +00:00
|
|
|
|
2017-09-21 22:51:26 +00:00
|
|
|
There are two steps to perform a typical Fleet update. If any other steps are required, they will be noted in the release notes.
|
2017-02-24 19:11:46 +00:00
|
|
|
|
2017-09-21 22:51:26 +00:00
|
|
|
1. [Update the Fleet binary](#updating-the-fleet-binary)
|
2017-02-24 19:11:46 +00:00
|
|
|
2. [Run database migrations](#running-database-migrations)
|
|
|
|
|
2017-09-21 22:51:26 +00:00
|
|
|
As with any enterprise software update, it's a good idea to back up your MySQL data before updating Fleet.
|
2017-02-24 19:11:46 +00:00
|
|
|
|
2017-09-21 22:51:26 +00:00
|
|
|
## Updating the Fleet binary
|
2017-02-24 19:11:46 +00:00
|
|
|
|
2017-09-21 22:51:26 +00:00
|
|
|
Follow the binary update instructions corresponding to the original installation method used to install Fleet.
|
2017-02-24 19:11:46 +00:00
|
|
|
|
|
|
|
#### Kolide quickstart script
|
|
|
|
|
2017-09-21 22:51:26 +00:00
|
|
|
The quickstart script will automatically update and migrate Fleet when run. In the `kolide-quickstart` directory:
|
2017-02-24 19:11:46 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
./demo.sh up
|
|
|
|
```
|
|
|
|
|
|
|
|
Step 2 is performed automatically, so no further action is necessary.
|
|
|
|
|
|
|
|
#### Docker container
|
|
|
|
|
2017-09-21 22:51:26 +00:00
|
|
|
Pull the latest Fleet docker image:
|
2017-02-24 19:11:46 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
docker pull kolide/kolide
|
|
|
|
```
|
|
|
|
|
|
|
|
#### Debian Packages (Ubuntu, Debian)
|
|
|
|
|
2017-09-21 22:51:26 +00:00
|
|
|
Update Fleet through the Apt repository (the repository should have been added during initial install):
|
2017-02-24 19:11:46 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
sudo apt-get update && sudo apt-get install kolide
|
|
|
|
```
|
|
|
|
|
|
|
|
#### Yum Packages (CentOS, RHEL, Amazon Linux)
|
|
|
|
|
2017-09-21 22:51:26 +00:00
|
|
|
Update Fleet through the Yum respository (the repository should have been added during initial install):
|
2017-02-24 19:11:46 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
sudo yum update kolide
|
|
|
|
```
|
|
|
|
|
|
|
|
#### Raw binaries
|
|
|
|
|
2017-09-21 22:51:26 +00:00
|
|
|
Download the latest raw Fleet binaries:
|
2017-02-24 19:11:46 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
curl -O https://dl.kolide.co/bin/kolide_latest.zip
|
|
|
|
```
|
|
|
|
|
|
|
|
Unzip the binaries for your platform:
|
|
|
|
|
|
|
|
```
|
|
|
|
# For a Darwin compatible binary
|
|
|
|
unzip kolide_latest.zip 'darwin/*' -d kolide
|
|
|
|
./kolide/darwin/kolide_darwin_amd64 --help
|
|
|
|
|
|
|
|
# For a Linux compatible binary
|
|
|
|
unzip kolide_latest.zip 'linux/*' -d kolide
|
|
|
|
./kolide/linux/kolide_linux_amd64 --help
|
|
|
|
```
|
|
|
|
|
2017-09-21 22:51:26 +00:00
|
|
|
Replace the existing Fleet binary with the newly unzipped binary.
|
2017-02-24 19:11:46 +00:00
|
|
|
|
|
|
|
## Running database migrations
|
|
|
|
|
|
|
|
Before running the updated server, perform necessary database migrations:
|
|
|
|
|
|
|
|
```
|
|
|
|
kolide prepare db
|
|
|
|
```
|
|
|
|
|
2017-03-09 18:40:52 +00:00
|
|
|
Note, if you would like to run this in a script, you can use the `--no-prompt` option to disable prompting before the migrations.
|
|
|
|
|
2017-09-21 22:51:26 +00:00
|
|
|
The updated Fleet server should now be ready to run:
|
2017-02-24 19:11:46 +00:00
|
|
|
|
|
|
|
```
|
|
|
|
kolide serve
|
|
|
|
```
|