Update setup documentation to cover issue #1117

In issue #1117, the packer binary can sometimes conflict with the packer binary supplied with cracklib. This documentation update covers this and provides workarounds for affected users.
This commit is contained in:
Xiol 2015-07-22 10:13:04 +01:00
parent 2010a0c966
commit 985c3c576b
1 changed files with 28 additions and 0 deletions

View File

@ -58,6 +58,34 @@ If you get an error that `packer` could not be found, then your PATH
environment variable was not setup properly. Please go back and ensure environment variable was not setup properly. Please go back and ensure
that your PATH variable contains the directory which has Packer installed. that your PATH variable contains the directory which has Packer installed.
The `packer` binary may conflict with the cracklib-supplied packer binary
on RPM-based systems like Fedora, RHEL or CentOS. If this happens, running
`packer` will result in no output or something like this:
```text
$ packer
/usr/share/cracklib/pw_dict.pwd: Permission denied
/usr/share/cracklib/pw_dict: Permission denied
```
In this case you may wish to symlink the `packer` binary to `packer.io`
and use that instead. e.g.
```text
ln -s /usr/local/bin/packer /usr/local/bin/packer.io
```
Then replace `packer` with `packer.io` when following the rest of the
documentation.
Alternatively you could change your `$PATH` so that the right packer
binary is selected first, however this may cause issues when attempting
to change passwords in the future.
```text
export PATH="/path/to/packer/directory:$PATH"
```
Otherwise, Packer is installed and you're ready to go! Otherwise, Packer is installed and you're ready to go!
## Alternative Installation Methods ## Alternative Installation Methods