Skip to content

Commit fc9d0f0

Browse files
author
Adam Haid
committed
Merge branch 'release/1.5.1'
2 parents 9777b36 + 0a188b4 commit fc9d0f0

11 files changed

Lines changed: 129 additions & 29 deletions

Install/Archive/v1.5/.DS_Store

6 KB
Binary file not shown.

Install/NetApp_SolidFire_PowerShell_Tools _v1.5_Release_Notes.pdf renamed to Install/Archive/v1.5/NetApp_SolidFire_PowerShell_Tools _v1.5_Release_Notes.pdf

File renamed without changes.

Install/NetApp_SolidFire_PowerShell_Tools_v1.5_User_Guide.pdf renamed to Install/Archive/v1.5/NetApp_SolidFire_PowerShell_Tools_v1.5_User_Guide.pdf

File renamed without changes.
Binary file not shown.
388 KB
Binary file not shown.

README.md

Lines changed: 4 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# SolidFire PowerShell Tools
1+
# NetApp SolidFire PowerShell Tools
22

3-
### Version 1.5
3+
### Version 1.5.1
44

55
![logo](Install/product.png)
66

@@ -12,12 +12,6 @@ Any user with a SolidFire storage system and Windows PowerShell can take advanta
1212

1313
## Installation
1414

15-
The **preferred** way to install SolidFire PowerShell Tools is to download it from [PowerShell Gallery](powershellgallery.com) with the following command:
16-
17-
PS> Install-Module -Name SolidFire
18-
19-
**-- or --**
20-
2115
The SolidFire Powershell Module can be installed directly on multiple systems by following these instructions:
2216

2317
| System | Installation |
@@ -29,6 +23,6 @@ The SolidFire Powershell Module can be installed directly on multiple systems by
2923

3024
## Release Notes
3125

32-
[Click here to download latest release notes](https://github.com/solidfire/PowerShell/blob/master/Install/NetApp_SolidFire_PowerShell_Tools%20_v1.5_Release_Notes.pdf)
26+
[Click here to download latest release notes](Install/NetApp_SolidFire_PowerShell_Tools_v1.5.1_Release_Notes.pdf)
3327

34-
User guides are available for each system in the installation instruction pages.
28+
[Click here to download User Guide Doc](Install/NetApp_SolidFire_PowerShell_Tools_v1.5.1_User_Guide.pdf)

docs/docker/README.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,26 @@
1-
# To install SolidFire Powershell as Docker container:
1+
# To install NetApp SolidFire Powershell as Docker container:
22

33
![solidfire-powershell-logo](../../Install/product.png) ![docker-logo](docker-logo-small.png)
44

5-
### Prerequisite:
5+
##### Prerequisite:
66

77
You must have Docker engine installed and running on your host machine. [Install the latest docker engine](https://www.docker.com/products/overview)
88

99
### Run the SolidFire Powershell Container:
1010

1111
Using a terminal, pull and run the latest SolidFire PowerShell image from our public Docker repo with this command:
1212

13-
docker run -it -v $(pwd):/scripts --rm netapp/solidfire-powershell
13+
docker run -it netapp/solidfire-powershell
1414

15-
This will download that SolidFire Docker image, start a new container, and enter it in a bash shell from your terminal. Once there, run the command:
15+
Or, run it with a mounted volume so you can access local scripts.
1616

17-
powershell
17+
docker run -it -v $(pwd):/scripts netapp/solidfire-powershell
1818

19-
Then you will be in a PowerShell shell with the SolidFire module loaded and ready.
19+
This will download that SolidFire Docker image, start a new container, and open a PowerShell shell from your terminal with the SolidFire module loaded and ready.
2020

2121
**NOTE:** Any scripts in your host's pwd* will be available at `/scripts` once you are in the PowerShell shell.
2222

23-
*Present Working Directory
23+
*`Present Working Directory`
2424

2525
**ProTip:**
2626
You can change the mounted directory for `/scripts` by modifying the left side of the ':'. Use " " when a space exists in the path.

docs/linux/README.md

Lines changed: 42 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,42 @@
1-
# Install SolidFire PowerShell on Linux![solidfire-powershell-logo](../../Install/product.png) ![linux-logo](linux-logo-small.png)The commands should be run in a terminal session on the machine you want to install on. You don't have to be in a specific directory to execute any of these commands. You will need sudo access. ## Uninstall Old Version of SolidFireIf you previously installed SolidFire 1.4, you should uninstall it before installing SolidFire 1.5.1. Remove the old SolidFire module files: $ sudo rm -rf /usr/local/share/powershell/Modules/SolidFire1. If you created a PowerShell profile file to initialize the SolidFire module on PowerShell startup, remove that file : $ sudo rm /opt/microsoft/powershell/6.0.0-beta.2/profile.ps11. If you will be upgrading to the latest PowerShell, you can also remove the directory where that profile file was located: $ sudo rm -rf /opt/microsoft/powershell/6.0.0-beta.2## Install or Upgrade PowerShell bitsFollow the detailed instructions on the [PowerShell for Linux installation page](https://github.com/PowerShell/PowerShell/blob/master/docs/installation/linux.md). ## Install SolidFire bits1. Start a PowerShell shell: $ pwsh1. Inside the PowerShell shell, install SolidFire PowerShell Tools by downloading it from the [PowerShell Gallery](powershellgallery.com) with the following command: PS> Install-Module -Name SolidFire.Linux1. Then, import the SolidFire module with the following command: PS> Import-Module SolidFire.Linux1. To see a list of available commands, use: PS> Get-Command -Module SolidFire.Linux## Paths* `$PSHOME` is `/opt/microsoft/powershell/[version]/`* User profiles will be read from `~/.config/powershell/profile.ps1`* Default profiles will be read from `$PSHOME/profile.ps1`* User modules will be read from `~/.local/share/powershell/Modules`* Shared modules will be read from `/usr/local/share/powershell/Modules`* Default modules will be read from `$PSHOME/Modules`* PSReadLine history will be recorded to `~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt`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 macOS, the [XDG Base Directory Specification][xdg-bds] is respected.[xdg-bds]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
1+
# Install NetApp SolidFire PowerShell Tools on Linux
2+
3+
![solidfire-powershell-logo](../../Install/product.png) ![linux-logo](linux-logo-small.png)
4+
5+
The commands should be run in a terminal session on the machine you want to install on. You don't have to be in a specific directory to execute any of these commands. You will need sudo access.
6+
7+
## First, Install PowerShell bits
8+
9+
Follow the detailed instructions on the [PowerShell for Linux installation page](https://github.com/PowerShell/PowerShell/blob/master/docs/installation/linux.md).
10+
11+
## Next, Install SolidFire bits
12+
13+
1. Once inside the PowerShell shell, install SolidFire PowerShell Tools for dotnet core by downloading it from the [PowerShell Gallery](powershellgallery.com) with the following command:
14+
15+
PS> Install-Module -Name SolidFire.Core
16+
17+
1. Then, import the SolidFire module with the following command:
18+
19+
PS> Import-Module SolidFire.Core
20+
21+
1. To see a list of available commands, use:
22+
23+
PS> Get-Command -Module SolidFire.Core
24+
25+
**NOTE:** This module used to be called `SolidFire.Linux`. That name has been deprecated and it is now `SolidFire.Core`
26+
27+
## Paths
28+
29+
* `$PSHOME` is `/opt/microsoft/powershell/[version]/`
30+
* User profiles will be read from `~/.config/powershell/profile.ps1`
31+
* Default profiles will be read from `$PSHOME/profile.ps1`
32+
* User modules will be read from `~/.local/share/powershell/Modules`
33+
* Shared modules will be read from `/usr/local/share/powershell/Modules`
34+
* Default modules will be read from `$PSHOME/Modules`
35+
* PSReadLine history will be recorded to `~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt`
36+
37+
The profiles respect PowerShell's per-host configuration,
38+
so the default host-specific profiles exists at `Microsoft.PowerShell_profile.ps1` in the same locations.
39+
40+
On Linux and macOS, the [XDG Base Directory Specification][xdg-bds] is respected.
41+
42+
[xdg-bds]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html

docs/mac/README.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Install SolidFire PowerShell on Mac OS 10.11
1+
# Install NetApp SolidFire PowerShell Tools on Mac OS
22

33
![solidfire-powershell-logo](../../Install/product.png) ![apple-logo](apple-logo-small.png)
44

@@ -12,17 +12,17 @@ Follow the detailed instructions on the [PowerShell for Mac installation page](h
1212

1313
### Next, Install SolidFire bits
1414

15-
1. Once inside the PowerShell shell, install SolidFire PowerShell Tools by downloading it from the [PowerShell Gallery](https://powershellgallery.com) with the following command:
15+
1. Once inside the PowerShell shell, install SolidFire PowerShell Tools by downloading it from the [PowerShell Gallery](powershellgallery.com) with the following command:
1616

17-
PS> Install-Module -Name SolidFire
17+
PS> Install-Module -Name SolidFire.Core
1818

1919
1. Then, import the SolidFire module with the following command:
2020

21-
PS> Import-Module SolidFire
21+
PS> Import-Module SolidFire.Core
2222

2323
1. To see a list of available commands, use:
2424

25-
PS> Get-Command -Module SolidFire
25+
PS> Get-Command -Module SolidFire.Core
2626

2727
## Paths
2828

@@ -39,3 +39,7 @@ so the default host-specific profiles exists at `Microsoft.PowerShell_profile.ps
3939

4040
`$PSHOME` is `/usr/local/microsoft/powershell/[version]/`,
4141
and the symlink is placed at `/usr/local/bin/powershell`.
42+
43+
On Linux and macOS, the [XDG Base Directory Specification][xdg-bds] is respected.
44+
45+
[xdg-bds]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html

docs/windows/README.md

Lines changed: 67 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,87 @@
1-
# To install SolidFire Powershell on Windows:
1+
# To install NetApp SolidFire Powershell on Windows:
22

3-
![solidfire-powershell-logo](../../Install/product.png) ![windows-logo](windows-logo-small.png)
3+
![solidfire-powershell-logo](../../Install/product.png) ![windows-logo](windows10-logo-small.png)
44

5-
This page has instructions for installing the SolidFire PowerShell tools module on a Windows client.
5+
This page has instructions for installing the SolidFire PowerShell tools module on a Windows client.
66

7-
## Prerequisites
7+
There are two different versions. One for PowerShell 5.1, and one for PowerShell 6. With it being able to run on many types of systems with very few dependencies, we recommend you choose the PowerShell 6 version if possible.
8+
9+
## Powershell 6.0
10+
11+
##### Prerequisites
12+
13+
| Component | Version |
14+
|----------------------|------------------|
15+
| PowerShell | 6.0 or later |
16+
| SolidFire Element OS | 7 through 10.0 |
17+
18+
### Installation Instructions
19+
20+
1. Once inside the PowerShell shell, install SolidFire PowerShell Tools by downloading it from the [PowerShell Gallery](powershellgallery.com) with the following command:
21+
22+
PS> Install-Module -Name SolidFire.Core
23+
24+
1. Then, import the SolidFire module with the following command:
25+
26+
PS> Import-Module SolidFire.Core
27+
28+
1. To see a list of available commands, use:
29+
30+
PS> Get-Command -Module SolidFire.Core
31+
32+
##### Supported Microsoft Operating Systems
33+
34+
The following versions of Microsoft operating systems are supported, and have had the module tested on them.
35+
36+
| Version |
37+
|------------------------|
38+
| Windows Server 2016 |
39+
| Mac 10.13 |
40+
| CentOS 7.3 |
41+
| Ubuntu 16.04 |
42+
43+
PowerShell 6 supports many more platforms, but extensive module testing has not been done. More than likely they work fine, but no guarantees are given.
44+
45+
You can find that list here at [PowerShell Core 6.0](https://blogs.msdn.microsoft.com/powershell/2018/01/10/powershell-core-6-0-generally-available-ga-and-supported/).
46+
47+
48+
49+
## PowerShell 5.1 and below
50+
51+
##### Prerequisites
852

953
| Component | Version |
1054
|----------------------|------------------|
1155
| PowerShell | 4.0 or later |
1256
| SolidFire Element OS | 7 through 10.0 |
1357
| .NET Framework | 4.5.1 or later |
1458

15-
## Installation Instructions
59+
### Installation Instructions - Two methods are available
60+
61+
#### PowerShell Gallery (Preferred Method)
62+
63+
1. Once inside the PowerShell shell, install SolidFire PowerShell Tools by downloading it from the [PowerShell Gallery](powershellgallery.com) with the following command:
64+
65+
PS> Install-Module -Name SolidFire
66+
67+
1. Then, import the SolidFire module with the following command:
68+
69+
PS> Import-Module SolidFire
70+
71+
1. To see a list of available commands, use:
72+
73+
PS> Get-Command -Module SolidFire
74+
75+
76+
#### MSI Installer
1677

1778
Download and launch the installer .msi file then follow the instructions in the install wizard.
1879

1980
[SolidFire PowerShell Installer](https://github.com/solidfire/PowerShell/raw/master/Install/SolidFire_PowerShell_1_5_0_119-install.msi)
2081

2182
** Additional installation details can be found in the SolidFire PowerShell [User Guide Doc](https://github.com/solidfire/PowerShell/blob/master/Install/NetApp_SolidFire_PowerShell_Tools_v1.5_User_Guide.pdf)
2283

23-
## Supported Microsoft Operating Systems
84+
##### Supported Microsoft Operating Systems
2485

2586
The following versions of Microsoft operating systems are supported and can run the SolidFire PowerShell tools.
2687

0 commit comments

Comments
 (0)