Update Linux / OS X installation documentation
This commit is contained in:
parent
21a7bd876c
commit
e142f7c987
|
@ -1,76 +1,101 @@
|
||||||
Package installation instructions
|
Package installation instructions
|
||||||
=================================
|
=================================
|
||||||
|
|
||||||
Supports [Ubuntu 14.04][Ubuntu14.04], [CentOS 7.1][CentOS7.1], and [OS X 10.11][OSX10.11].
|
Supports [Ubuntu 14.04][u14], [Ubuntu 16.04][u16],
|
||||||
|
[CentOS 7][cos], and [OS X 10.11][osx].
|
||||||
All packages are available on our GitHub [releases][] page.
|
All packages are available on our GitHub [releases][] page.
|
||||||
|
|
||||||
Once the package is installed, run `powershell` from a terminal.
|
Once the package is installed, run `powershell` from a terminal.
|
||||||
|
|
||||||
[Ubuntu14.04]:./linux.md#ubuntu-1404
|
[u14]: #ubuntu-1404
|
||||||
[CentOS7.1]:./linux.md#centos-7
|
[u16]: #ubuntu-1604
|
||||||
[OSX10.11]:./linux.md#os-x-1011
|
[cos]: #centos-7
|
||||||
|
[osx]: #os-x-1011
|
||||||
|
|
||||||
Ubuntu 14.04
|
Ubuntu 14.04
|
||||||
============
|
============
|
||||||
|
|
||||||
Using [Ubuntu 14.04][], download the Debian package `powershell_6.0.0-alpha.7-1_amd64.deb` from the [releases][] page onto the Ubuntu machine.
|
Using [Ubuntu 14.04][], download the Debian package
|
||||||
|
`powershell_6.0.0-alpha.8-1_amd64-ubuntu.14.04-x64.deb`
|
||||||
|
from the [releases][] page onto the Ubuntu machine.
|
||||||
|
|
||||||
Then execute the following in the terminal:
|
Then execute the following in the terminal:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
sudo apt-get install libunwind8 libicu52
|
sudo apt-get install libunwind8 libicu52
|
||||||
sudo dpkg -i powershell_6.0.0-alpha.7-1_amd64.deb
|
sudo dpkg -i powershell_6.0.0-alpha.8-1_amd64-ubuntu.14.04-x64.deb
|
||||||
```
|
```
|
||||||
|
|
||||||
> Please note that Ubuntu 16.04 is not yet supported, but coming soon!
|
|
||||||
|
|
||||||
[Ubuntu 14.04]: http://releases.ubuntu.com/14.04/
|
[Ubuntu 14.04]: http://releases.ubuntu.com/14.04/
|
||||||
|
|
||||||
|
Ubuntu 16.04
|
||||||
|
============
|
||||||
|
|
||||||
|
Using [Ubuntu 16.04][], download the Debian package
|
||||||
|
`powershell_6.0.0-alpha.8-1_amd64-ubuntu.16.04-x64.deb`
|
||||||
|
from the [releases][] page onto the Ubuntu machine.
|
||||||
|
|
||||||
|
Then execute the following in the terminal:
|
||||||
|
|
||||||
|
> Please note the different libicu package dependency!
|
||||||
|
|
||||||
|
```sh
|
||||||
|
sudo apt-get install libunwind8 libicu55
|
||||||
|
sudo dpkg -i powershell_6.0.0-alpha.8-1_amd64-ubuntu.16.04-x64.deb
|
||||||
|
```
|
||||||
|
|
||||||
|
[Ubuntu 16.04]: http://releases.ubuntu.com/16.04/
|
||||||
|
|
||||||
|
|
||||||
CentOS 7
|
CentOS 7
|
||||||
========
|
========
|
||||||
|
|
||||||
Using [CentOS 7][], download the RPM package `powershell-6.0.0_alpha.7-1.x86_64.rpm` from the [releases][] page onto the CentOS machine.
|
Using [CentOS 7][], download the RPM package
|
||||||
|
`powershell-6.0.0_alpha.8-1.x86_64-centos.7-x64.rpm`
|
||||||
|
from the [releases][] page onto the CentOS machine.
|
||||||
|
|
||||||
Then execute the following in the terminal:
|
Then execute the following in the terminal:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
sudo yum install powershell-6.0.0_alpha.7-1.x86_64.rpm
|
sudo yum install powershell-6.0.0_alpha.8-1.x86_64-centos.7-x64.rpm
|
||||||
```
|
```
|
||||||
|
|
||||||
> Please note that we have not tested this package on Red Hat Enterprise Linux.
|
> This package should work on Red Hat Enterprise Linux 7 too.
|
||||||
|
|
||||||
[CentOS 7]: https://www.centos.org/download/
|
[CentOS 7]: https://www.centos.org/download/
|
||||||
|
|
||||||
OS X 10.11
|
OS X 10.11
|
||||||
==========
|
==========
|
||||||
|
|
||||||
Using OS X 10.11, download the PKG package `powershell-6.0.0-alpha.7.pkg` from the [releases][] page onto the OS X machine.
|
Using OS X 10.11, download the PKG package `powershell-6.0.0-alpha.8-osx.10.11-x64.pkg` from the [releases][] page onto the OS X machine.
|
||||||
|
|
||||||
Either double-click the file and follow the prompts, or install it from the terminal:
|
Either double-click the file and follow the prompts,
|
||||||
|
or install it from the terminal:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
sudo installer -pkg powershell-6.0.0-alpha.7.pkg -target /
|
sudo installer -pkg powershell-6.0.0-alpha.8-osx.10.11-x64.pkg -target /
|
||||||
```
|
```
|
||||||
|
|
||||||
> Note that because OS X is a derivation of BSD, instead of `/opt`, the prefix used is `/usr/local`.
|
|
||||||
> Thus, `powershell` lives at `/usr/local/microsoft/powershell`, and the symlink is placed at `/usr/local/bin/powershell`.
|
|
||||||
> This affects the system modules and profiles as well.
|
|
||||||
|
|
||||||
Paths
|
Paths
|
||||||
=====
|
=====
|
||||||
|
|
||||||
* User profiles will be read from `~/.config/powershell/profile.ps1`.
|
* User profiles will be read from `~/.config/powershell/profile.ps1`.
|
||||||
* User modules will be read from `~/.local/share/powershell/Modules`
|
* User modules will be read from `~/.local/share/powershell/Modules`
|
||||||
* PSReadLine history will be recorded to `~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt`
|
* PSReadLine history will be recorded to `~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt`
|
||||||
* System profiles will be read from `/opt/microsoft/powershell/profile.ps1`.
|
* `$PSHOME` is `/opt/microsoft/powershell/6.0.0-alpha.8/`
|
||||||
* System modules will be read from `/opt/microsoft/powershell/Modules`
|
* Default profiles will be read from `$PSHOME/profile.ps1`.
|
||||||
|
* Default modules will be read from `$PSHOME/Modules`
|
||||||
|
|
||||||
The profiles respect PowerShell's per-host configuration, so the default host-specific profiles exists at `Microsoft.PowerShell_profile.ps1` in the same locations.
|
The profiles respect PowerShell's per-host configuration,
|
||||||
|
so the default host-specific profiles exists at `Microsoft.PowerShell_profile.ps1` in the same locations.
|
||||||
|
|
||||||
On Linux and OS X, the [XDG Base Directory Specification][xdg-bds] is respected.
|
On Linux and OS X, the [XDG Base Directory Specification][xdg-bds] is respected.
|
||||||
|
|
||||||
> There is a symlink created from `/usr/bin/powershell` to `/opt/microsoft/powershell/powershell` to ensure `powershell` is in your path.
|
|
||||||
|
|
||||||
|
Note that because OS X is a derivation of BSD,
|
||||||
|
instead of `/opt`, the prefix used is `/usr/local`.
|
||||||
|
Thus, `$PSHOME` is `/usr/local/microsoft/powershell/6.0.0-alpha.8/`,
|
||||||
|
and the symlink is placed at `/usr/local/bin/powershell`.
|
||||||
|
|
||||||
[releases]: https://github.com/PowerShell/PowerShell/releases/latest
|
[releases]: https://github.com/PowerShell/PowerShell/releases/latest
|
||||||
[xdg-bds]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
|
[xdg-bds]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
|
||||||
|
|
Loading…
Reference in a new issue