Skip to content

Commit

Permalink
docs: add an UPDATE.md file for additional steps
Browse files Browse the repository at this point in the history
Former-commit-id: 1e9bbcfda11a9bd3bc47523396a4663b03ba33a7
  • Loading branch information
thibaultcha committed Jun 9, 2015
1 parent 1d62e58 commit 87a55af
Showing 1 changed file with 29 additions and 0 deletions.
29 changes: 29 additions & 0 deletions UPDATE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
This document describes eventual additional steps that might be required to update between two versions of Kong. If nothing is described here for a particular version and platform, then assume the update will go smoothly.

## Update to Kong `0.3.x`

Kong now requires a patch on OpenResty for SSL support. On Homebrew you will need to reinstall OpenResty.

#### Homebrew

```shell
$ brew update
$ brew reinstall mashape/kong/ngx_openresty
$ brew upgrade kong
```

#### Troubleshoot

If you are seeing a similar error on `kong start`:

```
nginx: [error] [lua] init_by_lua:5: Startup error: Cassandra error: Failed to prepare statement: "SELECT id FROM apis WHERE path = ?;". Cassandra returned error (Invalid): "Undefined name path in where clause ('path = ?')"
```

You can run the following command to update your schema:

```
$ kong migrations up
```

Please consider updating to `0.3.1` or greater which automatically handles the schema migration.

0 comments on commit 87a55af

Please sign in to comment.