diff --git a/Images/SolidFire PowerShell Tools WordCloud.png b/Images/SolidFire PowerShell Tools WordCloud.png deleted file mode 100644 index d896a04..0000000 Binary files a/Images/SolidFire PowerShell Tools WordCloud.png and /dev/null differ diff --git a/Images/SolidFire PowerShell Tools icon.png b/Images/SolidFire PowerShell Tools icon.png deleted file mode 100644 index 33772c8..0000000 Binary files a/Images/SolidFire PowerShell Tools icon.png and /dev/null differ diff --git a/Install/NetApp_SolidFire_PowerShell_Tools_v1.4_Release_Notes.pdf b/Install/Archive/v1.4/NetApp_SolidFire_PowerShell_Tools_v1.4_Release_Notes.pdf similarity index 100% rename from Install/NetApp_SolidFire_PowerShell_Tools_v1.4_Release_Notes.pdf rename to Install/Archive/v1.4/NetApp_SolidFire_PowerShell_Tools_v1.4_Release_Notes.pdf diff --git a/Install/NetApp_SolidFire_PowerShell_Tools_v1.4_User_Guide.pdf b/Install/Archive/v1.4/NetApp_SolidFire_PowerShell_Tools_v1.4_User_Guide.pdf similarity index 100% rename from Install/NetApp_SolidFire_PowerShell_Tools_v1.4_User_Guide.pdf rename to Install/Archive/v1.4/NetApp_SolidFire_PowerShell_Tools_v1.4_User_Guide.pdf diff --git a/Install/SolidFire_PowerShell_1_4_0_98-install.msi b/Install/Archive/v1.4/SolidFire_PowerShell_1_4_0_98-install.msi similarity index 100% rename from Install/SolidFire_PowerShell_1_4_0_98-install.msi rename to Install/Archive/v1.4/SolidFire_PowerShell_1_4_0_98-install.msi diff --git a/Install/SolidFire_PowerShell_1_4_0_98-install.msi.md5 b/Install/Archive/v1.4/SolidFire_PowerShell_1_4_0_98-install.msi.md5 similarity index 100% rename from Install/SolidFire_PowerShell_1_4_0_98-install.msi.md5 rename to Install/Archive/v1.4/SolidFire_PowerShell_1_4_0_98-install.msi.md5 diff --git a/Install/NetApp_SolidFire_PowerShell_Tools _v1.5_Release_Notes.pdf b/Install/NetApp_SolidFire_PowerShell_Tools _v1.5_Release_Notes.pdf new file mode 100644 index 0000000..5017691 Binary files /dev/null and b/Install/NetApp_SolidFire_PowerShell_Tools _v1.5_Release_Notes.pdf differ diff --git a/Install/NetApp_SolidFire_PowerShell_Tools_v1.5_User_Guide.pdf b/Install/NetApp_SolidFire_PowerShell_Tools_v1.5_User_Guide.pdf new file mode 100644 index 0000000..d7b72fa Binary files /dev/null and b/Install/NetApp_SolidFire_PowerShell_Tools_v1.5_User_Guide.pdf differ diff --git a/Install/SolidFire_PowerShell_1_5_0_119-install.msi b/Install/SolidFire_PowerShell_1_5_0_119-install.msi new file mode 100644 index 0000000..ae66ed4 Binary files /dev/null and b/Install/SolidFire_PowerShell_1_5_0_119-install.msi differ diff --git a/README.md b/README.md index 8fc550f..95ecc9e 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # SolidFire PowerShell Tools -### Version 1.4 (bitbucket) +### Version 1.5 ![logo](Install/product.png) @@ -12,7 +12,13 @@ Any user with a SolidFire storage system and Windows PowerShell can take advanta ## Installation -The SolidFire Powershell Module can be installed on the following systems: +The **preferred** way to install SolidFire PowerShell Tools is to download it from [PowerShell Gallery](powershellgallery.com) with the following command: + + PS> Install-Module -Name SolidFire + +**-- or --** + +The SolidFire Powershell Module can be installed directly on multiple systems by following these instructions: | System | Installation | |---------------------------|-------------------------------------------| @@ -21,14 +27,8 @@ The SolidFire Powershell Module can be installed on the following systems: | Linux (Ubuntu/Centos) | [Instructions](docs/linux/README.md) | | Docker | [Instructions](docs/docker/README.md) | -[Release Notes](https://github.com/solidfire/PowerShell/blob/master/Install/NetApp_SolidFire_PowerShell_Tools_v1.4_Release_Notes.pdf) +## Release Notes -## Release History +[Click here to download latest release notes](https://github.com/solidfire/PowerShell/blob/master/Install/NetApp_SolidFire_PowerShell_Tools_v1.5_Release_Notes.pdf) -| Version | Release Date | -|--------------|----------------| -| 1.4.0.98 | 13-JUN-2017 | -| 1.3.0.110 | 15-JAN-2017 | -| 1.2.1.1 | 26-MAY-2016 | -| 1.2.0.37 | 22-MAR-2016 | -| 1.1.0.37 | 17-DEC-2015 | \ No newline at end of file +User guides are available for each system in the installation instruction pages. diff --git a/docs/docker/README.md b/docs/docker/README.md index ff79f5a..deace7d 100644 --- a/docs/docker/README.md +++ b/docs/docker/README.md @@ -14,7 +14,7 @@ Using a terminal, pull and run the latest SolidFire PowerShell image from our pu 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. -**NOTE:** Any scripts in your host's pwd* will be available at `/scripts` once you are in the ?owerShell shell. +**NOTE:** Any scripts in your host's pwd* will be available at `/scripts` once you are in the PowerShell shell. *Present Working Directory diff --git a/docs/docker/create-posh-DEVELOP b/docs/docker/create-posh-DEVELOP new file mode 100644 index 0000000..4f88333 --- /dev/null +++ b/docs/docker/create-posh-DEVELOP @@ -0,0 +1,61 @@ +############################################################ +# Dockerfile to create SolidFire PowerShell Container +# From Jenkins DEVELOP branch +# Based on Ubuntu Image +############################################################ + +# Set the base image to use to Ubuntu +FROM ubuntu + +# Set the file maintainer (your name - the file's author) +MAINTAINER NetApp SolidFire Host Integrations + +# Add security to apt sources list +# RUN echo "deb http://security.ubuntu.com/ubuntu trusty-security main" >> /etc/apt/sources.list + +# Update the default application repository sources list +RUN apt-get update + +# Install sudo +RUN apt-get install sudo -y + +# Install WGET +RUN apt-get install wget -y + +# Install CURL +RUN apt-get install curl -y + +# Use a non-root account +# RUN useradd -ms /bin/bash posh +# USER posh +# WORKDIR /home/posh +# RUN whoami + +# Install Powershell dependencies +RUN sudo apt-get install libcurl3 libunwind8 libicu55 -y + +# Download Powershell for Ubuntu +RUN wget https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-alpha.13/powershell_6.0.0-alpha.13-1ubuntu1.16.04.1_amd64.deb + +# Install Powershell +RUN sudo dpkg -i powershell_6.0.0-alpha.13-1ubuntu1.16.04.1_amd64.deb +RUN sudo apt-get install -f + +# Install Powershell +# RUN curl -fsSL https://raw.githubusercontent.com/PowerShell/PowerShell/v6.0.0-alpha.13/tools/download.sh | bash -s + +# Setup Module Directory +RUN mkdir -p /usr/local/share/powershell/Modules/SolidFire + +# Download the SolidFire PowerShell module files +#RUN wget -P /usr/local/share/powershell/Modules/SolidFire/ http://hi-jenkins.eng.solidfire.net:8080/view/SDK/job/solidfire-sdk-dotnet-DEVELOP/lastSuccessfulBuild/artifact/src/DotNetSdk/bin/Debug/netstandard1.6/DotNetSdk.dll + +#RUN wget -P /usr/local/share/powershell/Modules/SolidFire/ http://hi-jenkins.eng.solidfire.net:8080/view/SDK/job/solidfire-sdk-dotnet-DEVELOP/lastSuccessfulBuild/artifact/src/DotNetSdk/bin/Debug/net46/Newtonsoft.Json.dll + +#RUN wget -P /usr/local/share/powershell/Modules/SolidFire/ http://hi-jenkins.eng.solidfire.net:8080/view/PowerShell/job/PowerShell%20Build%20Develop/lastSuccessfulBuild/artifact/src/PowerShellModule/bin/Debug/netstandard1.6/SolidFire.dll + +#RUN wget -P /usr/local/share/powershell/Modules/SolidFire/ http://hi-jenkins.eng.solidfire.net:8080/view/PowerShell/job/PowerShell%20Build%20Develop/lastSuccessfulBuild/artifact/src/PowerShellModule/SolidFire.psd1 + + +# Set the entrypoint to powershell command +ENTRYPOINT powershell diff --git a/docs/linux/README.md b/docs/linux/README.md index 9509666..a19be88 100644 --- a/docs/linux/README.md +++ b/docs/linux/README.md @@ -6,112 +6,25 @@ The commands should be run in a terminal session on the machine you want to inst ## First, Install PowerShell bits -#### Ubuntu 14.04 - -Using [Ubuntu 14.04][], download the Debian package -`powershell_6.0.0-beta.2-1ubuntu1.14.04.1_amd64.deb` -from the [releases][] page onto the Ubuntu machine. - -Then execute the following in the terminal: - -```sh -sudo dpkg -i powershell_6.0.0-beta.2-1ubuntu1.14.04.1_amd64.deb -sudo apt-get install -f -``` - -> Please note that `dpkg -i` will fail with unmet dependencies; -> the next command, `apt-get install -f` resolves these -> and then finishes configuring the PowerShell package. - -**Uninstallation** - -```sh -sudo apt-get remove powershell -``` - -[Ubuntu 14.04]: http://releases.ubuntu.com/14.04/ - -#### Ubuntu 16.04 - -Using [Ubuntu 16.04][], download the Debian package -`powershell_6.0.0-beta.2-1ubuntu1.16.04.1_amd64.deb` -from the [releases][] page onto the Ubuntu machine. - -Then execute the following in the terminal: - -```sh -sudo dpkg -i powershell_6.0.0-beta.2-1ubuntu1.16.04.1_amd64.deb -sudo apt-get install -f -``` - -> Please note that `dpkg -i` will fail with unmet dependencies; -> the next command, `apt-get install -f` resolves these -> and then finishes configuring the PowerShell package. - -**Uninstallation** - -```sh -sudo apt-get remove powershell -``` - -[Ubuntu 16.04]: http://releases.ubuntu.com/16.04/ - -This works for Debian Stretch as well. - -#### CentOS 7 - -Using [CentOS 7][], download the RPM package -`powershell-6.0.0_beta.2-1.el7.centos.x86_64.rpm` -from the [releases][] page onto the CentOS machine. - -Then execute the following in the terminal: - -```sh -sudo yum install ./powershell-6.0.0_beta.2-1.el7.centos.x86_64.rpm -``` - -You can also install the RPM without the intermediate step of downloading it: - -```sh -sudo yum install https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-beta.2/powershell-6.0.0_beta.2-1.el7.centos.x86_64.rpm -``` - -This package works on Oracle Linux 7. It should work on Red Hat Enterprise Linux 7 too. - -**Uninstallation** - -```sh -sudo yum remove powershell -``` - -[CentOS 7]: https://www.centos.org/download/ +Follow the detailed instructions on the [PowerShell for Linux installation page](https://github.com/PowerShell/PowerShell/blob/master/docs/installation/linux.md). -## Next, Install SolidFire Bits -1. Give yourself root acces: - - sudo su - -1. Create a directory for the SolidFire module: +## Next, Install SolidFire bits - mkdir -p /usr/local/share/powershell/Modules/SolidFire +1. Once inside the PowerShell shell, install SolidFire PowerShell Tools by downloading it from the [PowerShell Gallery](powershellgallery.com) with the following command: -1. Download the SolidFire Powershell Module dlls from GitHub: + PS> Install-Module -Name SolidFire - cd /usr/local/share/powershell/Modules/SolidFire && curl --remote-name-all https://raw.githubusercontent.com/solidfire/sdk-dotnet/master/package/SolidFire.SDK.dll https://raw.githubusercontent.com/solidfire/PowerShell/master/packages/Newtonsoft.Json.dll https://raw.githubusercontent.com/solidfire/PowerShell/master/packages/SolidFire.dll https://raw.githubusercontent.com/solidfire/PowerShell/master/packages/SolidFire.psd1 https://raw.githubusercontent.com/solidfire/PowerShell/master/packages/Initialize-SFEnvironment.ps1 https://raw.githubusercontent.com/solidfire/PowerShell/master/packages/SolidFire.dll-help.xml >/dev/null && cd - - -1. [OPTIONAL but recommended] Setup the SolidFire PowerShell initializer script: +1. Then, import the SolidFire module with the following command: - echo ". /usr/local/share/powershell/Modules/SolidFire/Initialize-SFEnvironment.ps1" > /opt/microsoft/powershell/6.0.0-beta.2/profile.ps1 - - This will ensure the SolidFire PowerShell module is imported and initialized when you start up the PowerShell shell + PS> Import-Module SolidFire -1. Launch PowerShell shell: +1. To see a list of available commands, use: - powershell + PS> Get-Command -Module SolidFire ## Paths -* `$PSHOME` is `/opt/microsoft/powershell/6.0.0-beta.2/` +* `$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` @@ -124,5 +37,4 @@ so the default host-specific profiles exists at `Microsoft.PowerShell_profile.ps On Linux and macOS, the [XDG Base Directory Specification][xdg-bds] is respected. -[releases]: https://github.com/PowerShell/PowerShell/releases/tag/v6.0.0-beta.2 [xdg-bds]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html diff --git a/docs/mac/README.md b/docs/mac/README.md index 1bb3a0c..c5d3979 100644 --- a/docs/mac/README.md +++ b/docs/mac/README.md @@ -8,44 +8,25 @@ The commands should be run in a terminal session on the machine you want to inst ### First, Install PowerShell bits -*WARNING* If you run into complications with these steps, there are more detailed instructions on the [PowerShell for Mac installation page](https://github.com/PowerShell/PowerShell/blob/master/docs/installation/linux.md#macos-1012). - -1. Install the dependencies with [Homebrew](http://brew.sh/): - - brew install openssl - brew install curl --with-openssl - -1. Download the PowerShell for Mac bits: - - wget https://github.com/PowerShell/PowerShell/releases/download/v6.0.0-beta.2/powershell-6.0.0-beta.2-osx.10.12-x64.pkg - -1. Install the package you just downloaded: - - sudo installer -pkg powershell-6.0.0-beta.2-osx.10.12-x64.pkg -target / +Follow the detailed instructions on the [PowerShell for Mac installation page](https://github.com/PowerShell/PowerShell/blob/master/docs/installation/linux.md#macos-1012). -### Next, Install SolidFire Bits - -1. Create a directory for the SolidFire module: +### Next, Install SolidFire bits - mkdir -p /usr/local/share/powershell/Modules/SolidFire +1. Once inside the PowerShell shell, install SolidFire PowerShell Tools by downloading it from the [PowerShell Gallery](powershellgallery.com) with the following command: -1. Download the SolidFire Powershell Module dlls from GitHub: + PS> Install-Module -Name SolidFire - cd /usr/local/share/powershell/Modules/SolidFire && curl --remote-name-all https://raw.githubusercontent.com/solidfire/sdk-dotnet/master/package/SolidFire.SDK.dll https://raw.githubusercontent.com/solidfire/PowerShell/master/packages/Newtonsoft.Json.dll https://raw.githubusercontent.com/solidfire/PowerShell/master/packages/SolidFire.dll https://raw.githubusercontent.com/solidfire/PowerShell/master/packages/SolidFire.psd1 https://raw.githubusercontent.com/solidfire/PowerShell/master/packages/Initialize-SFEnvironment.ps1 https://raw.githubusercontent.com/solidfire/PowerShell/master/packages/SolidFire.dll-help.xml >/dev/null && cd - - -1. [OPTIONAL] Setup the SolidFire PowerShell initializer script: +1. Then, import the SolidFire module with the following command: - echo ". /usr/local/share/powershell/Modules/SolidFire/Initialize-SFEnvironment.ps1" > /usr/local/microsoft/powershell/6.0.0-beta.2/profile.ps1 - - This will ensure the SolidFire PowerShell module is imported and initialized when you start up the PowerShell shell + PS> Import-Module SolidFire -1. Launch PowerShell shell: +1. To see a list of available commands, use: - powershell + PS> Get-Command -Module SolidFire ## Paths -* `$PSHOME` is `/opt/microsoft/powershell/6.0.0-beta.2/` +* `$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` @@ -56,5 +37,5 @@ The commands should be run in a terminal session on the machine you want to inst The profiles respect PowerShell's per-host configuration, so the default host-specific profiles exists at `Microsoft.PowerShell_profile.ps1` in the same locations. -`$PSHOME` is `/usr/local/microsoft/powershell/6.0.0-beta.2/`, +`$PSHOME` is `/usr/local/microsoft/powershell/[version]/`, and the symlink is placed at `/usr/local/bin/powershell`. diff --git a/docs/windows/README.md b/docs/windows/README.md index 4df76b5..7489a47 100644 --- a/docs/windows/README.md +++ b/docs/windows/README.md @@ -6,11 +6,11 @@ This page has instructions for installing the SolidFire PowerShell tools module ## Prerequisites -| Component | Version | -|----------------------|----------------| -| PowerShell | 4.0 or later | -| SolidFire Element OS | 7 through 9.1 | -| .NET Framework | 4.5.1 or later | +| Component | Version | +|----------------------|------------------| +| PowerShell | 4.0 or later | +| SolidFire Element OS | 7 through 10.0 | +| .NET Framework | 4.5.1 or later | ## Installation Instructions @@ -18,7 +18,7 @@ Download and launch the installer .msi file then follow the instructions in the [SolidFire PowerShell Installer](https://github.com/solidfire/PowerShell/raw/master/Install/SolidFire_PowerShell_1_4_0_98-install.msi) -** 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.4_User_Guide.pdf) +** 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) ## Supported Microsoft Operating Systems diff --git a/packages/SolidFire.dll b/packages/SolidFire.dll index 047fa3e..f6bf136 100644 Binary files a/packages/SolidFire.dll and b/packages/SolidFire.dll differ diff --git a/packages/SolidFire.psd1 b/packages/SolidFire.psd1 index 2ede9f5..e3b89fb 100644 Binary files a/packages/SolidFire.psd1 and b/packages/SolidFire.psd1 differ