maverick/docbrown
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

expand common errors on macOS install (#3337)

Browse source 
* expand common errors on macOS install

* edit postgresql restart to easiser command
This commit is contained in:
Ryan Wang 2019-07-01 08:17:09 -04:00 • committed by Ben Halpern
parent 6797567de9
commit a1580b4bbf
1 changed files with 37 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

37
docs/installation/mac.md
View file

@ -51,6 +51,8 @@ For additional configuration options, check our [PostgreSQL setup guide](/instal
**_Solution:_** Run the command `rbenv install <version number>`
---
**Error:** `ruby-build: definition not found: <version number>` when `rbenv` was installed via `brew`.
```shell
@ -63,6 +65,8 @@ If the version you need is missing, try upgrading ruby-build:
**_Solution:_**
Run the following to update `ruby-build`, `brew update && brew upgrade ruby-build`. After that, rerun `rbenv install <version number>` and that version will get installed.
---
**Error:**
```shell
@ -76,4 +80,37 @@ LoadError: dlopen(/Users/<username>/.rbenv/versions/2.6.3/lib/ruby/2.6.0/x86_64-
**_Solution:_** Run `ln -s /usr/local/opt/readline/lib/libreadline.dylib /usr/local/opt/readline/lib/libreadline.<some version number>.dylib` from the command line then run `bin/setup` again. You may have a different version or libreadline, so replace `<some version number>` with the version that errored.
---
**Error:**
```shell
PG::Error: ERROR: invalid value for parameter "TimeZone": "UTC"
: SET time zone 'UTC'
```
**_Solution:_** Restart your Postgres.app, or, if you installed PostgreSQL with Homebrew, restart with:
```shell
brew services restart postgresql
```
If that doesn't work, reboot your Mac.
---
**Error:**
```shell
ERROR: Error installing pg:
ERROR: Failed to build gem native extension.
[...]
Can't find the 'libpq-fe.h header
*** extconf.rb failed ***
```
**_Solution:_** You may encounter this when installing PostgreSQL with the Postgres.app. Try restarting the app and reinitializing the database. If that doesn't work, install PostgreSQL with Homebrew instead: `brew install postgresql`
---
> If you encountered any errors that you subsequently resolved, **please consider updating this section** with your errors and their solutions.