2.103.1 release docs

POFerro · Jul 19, 2016 · 33c7432 · 33c7432
1 parent 252f4d8
commit 33c7432
Show file tree

Hide file tree

Showing 9 changed files with 149 additions and 48 deletions.
diff --git a/README.md b/README.md
@@ -8,7 +8,7 @@ Supported on Windows, OSX, Ubuntu and Red Hat.  Written for the .NET Core CLR as
 
 ## Current Release
 
-[v2.103.0](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.0)  
+[v2.103.1](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.1)  
 
 
 ## Status

diff --git a/docs/preview/latebreaking.md b/docs/preview/latebreaking.md
@@ -1,4 +1,4 @@
-# VSTS Agent Preview - Late breaking instructions
+# VSTS Agent System Pre-Requisites
 
 ## Windows
 
@@ -8,46 +8,12 @@ Even though the agent has no pre-requisites, many of the tasks we run require Vi
 
 ## ![osx](../res/apple_med.png) OSX
 
-Tested on 10.10 (Yosemite) and 10.11 (El Capitan)
-
-Update OpenSSL - [issue 110](https://github.com/Microsoft/vsts-agent/issues/110) 
-
-```bash
-$ openssl version
-OpenSSL 1.0.2f  28 Jan 2016
-```
-
-Instructions [located here](http://apple.stackexchange.com/questions/126830/how-to-upgrade-openssl-in-os-x)
-On last check 1.0.2g was the version so ensure you use correct mv, sn commands.  
-Restart new terminal after updating.
-
-If you are using TfsVc, install Oracle Java 1.6+.
-
-## ![ubuntu](../res/ubuntu_med.png) Ubuntu 14.04
-
-Before running the agent, you need to:
-
-```bash
-sudo apt-get install -y libunwind8 libcurl3 libicu52
-```
-If you are using TfsVc, install Oracle Java 1.6+.
+[OSX System Pre-Requisties](../start/envosx.md)
 
 ## ![ubuntu](../res/ubuntu_med.png) Ubuntu 16.04
 
-Before running the agent, you need to:
-
-```bash
-sudo apt-get install -y libunwind8 libcurl3
-
-wget http://security.ubuntu.com/ubuntu/pool/main/i/icu/libicu52_52.1-8ubuntu0.2_amd64.deb
-sudo dpkg -i libicu52_52.1-8ubuntu0.2_amd64.deb
-```
-If you are using TfsVc, install Oracle Java 1.6+.
+[Ubuntu System Pre-Requisties](../start/envubuntu.md)
 
 ## ![redhat](../res/redhat_med.png) RedHat and CentOS
 
-Install dependencies  
-```bash
-sudo yum -y install libunwind.x86_64 icu
-```
-If you are using TfsVc, install Oracle Java 1.6+.
+[Redhat/CentOS System Pre-Requisties](../start/envredhat.md)
diff --git a/docs/start/envosx.md b/docs/start/envosx.md
@@ -0,0 +1,49 @@
+
+
+# ![osx](../res/apple_med.png) OSX System Pre-requisites
+
+## OSX Version
+
+Tested on 10.10 (Yosemite) and 10.11 (El Capitan).  Not domain joined.
+
+## OSX
+
+Net core requires update OpenSSL - [issue 110](https://github.com/Microsoft/vsts-agent/issues/110) 
+
+```bash
+$ brew update
+$ brew install openssl
+$ brew link --force openssl
+$ openssl version
+OpenSSL 1.0.2f  28 Jan 2016
+```
+
+[Discussion here](http://apple.stackexchange.com/questions/126830/how-to-upgrade-openssl-in-os-x)
+
+
+## Git
+
+If you use git, git >= 2.9.0 is a pre-requisite for OSX agents.
+
+We recommend using [home brew](http://brew.sh) to install
+
+```bash
+$ brew update
+$ brew install git
+==> Downloading https://homebrew.bintray.com/bottles/git-2.9.0.el_capitan.bottle.tar.gz
+...
+(restart terminal)
+$ git --version
+git version 2.9.0
+$ which git
+/usr/local/bin/git
+$ ls -la /usr/local/bin/git
+... /usr/local/bin/git -> ../Cellar/git/2.9.0/bin/git
+```
+
+## Optionally Java if TfsVc
+
+The agent distributes team explorer everywhere.
+
+But, if you are using TfsVc, install Oracle Java 1.6+ as TEE uses Java.
+
diff --git a/docs/start/envredhat.md b/docs/start/envredhat.md
@@ -0,0 +1,38 @@
+
+
+# ![redhat](../res/redhat_med.png) Redhat/CentOS System Pre-requisites
+
+## Versions
+
+Tested on Redhat 7.1.  Not domain joined.
+
+## Git
+
+If you use git, git >= 2.9.0 is a pre-requisite for Redhat/CentOS agents.
+
+[Based on Install Latest Git on Redhat/Centos](http://tecadmin.net/install-git-2-x-on-centos-rhel-and-fedora/#)
+
+```bash
+$ yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel
+$ yum install gcc perl-ExtUtils-MakeMaker
+
+$ cd /usr/src
+$ wget https://www.kernel.org/pub/software/scm/git/git-2.9.2.tar.gz
+$ tar xzf git-2.9.2.tar.gz
+
+$ cd git-2.9.2
+$ make prefix=/usr/local/git all
+$ make prefix=/usr/local/git install
+```
+
+In /etc/bash.rs
+```bash
+export PATH=$PATH:/usr/local/git/bin
+```
+
+## Optionally Java if TfsVc
+
+The agent distributes team explorer everywhere.
+
+But, if you are using TfsVc, install Oracle Java 1.6+ as TEE uses Java.
+
diff --git a/docs/start/envubuntu.md b/docs/start/envubuntu.md
@@ -0,0 +1,36 @@
+
+
+# ![Ubuntu](../res/ubuntu_med.png) Ubuntu System Pre-requisites
+
+## Versions
+
+Tested on 16.04 LTS (Yosemite) and 14.04 LTS (El Capitan).  Not domain joined.  
+
+16.04 is recommended since latest and supports SystemD for runnings as a service.
+
+## Git
+
+If you use git, git >= 2.9.0 is a pre-requisite for Ubuntu agents.
+
+[Install Latest Git on Ubuntu](http://askubuntu.com/questions/568591/how-do-i-install-the-latest-version-of-git-with-apt/568596)
+
+```bash
+$ sudo apt-add-repository ppa:git-core/ppa
+$ sudo apt-get update
+$ sudo apt-get install git
+```
+
+## Optionally Java if TfsVc
+
+The agent distributes team explorer everywhere.
+
+But, if you are using TfsVc, install Oracle Java 1.6+ as TEE uses Java.
+
+## Etc
+
+There was an assertion that on Ubuntu 16 this was needed.  We didn't need.  Adding in case it helps someone.  We will verify on clean build and dev boxes.
+
+```bash
+apt-get install libcurl4-openssl-dev
+```
+
diff --git a/docs/start/startosx.md b/docs/start/startosx.md
@@ -6,13 +6,13 @@
 
 ## Step 2: Download from Releases
 
-Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.0)
+Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.1)
 
 ## Step 3: Create the agent
 
 ```bash
 ~/$ mkdir myagent && cd myagent
-~/myagent$ tar xzf ~/Downloads/vsts-agent-osx.10.11-x64-2.103.0.tar.gz
+~/myagent$ tar xzf ~/Downloads/vsts-agent-osx.10.11-x64-2.103.1.tar.gz
 ```
 ## Step 4: Configure
 

diff --git a/docs/start/startredhat.md b/docs/start/startredhat.md
@@ -6,13 +6,13 @@
 
 ## Step 2: Download from Releases
 
-Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.0)
+Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.1)
 
 ## Step 3: Create the agent
 
 ```bash
 ~/$ mkdir myagent && cd myagent
-~/myagent$ tar xzf ~/Downloads/vsts-agent-rhel.7.2-x64-2.103.0.tar.gz
+~/myagent$ tar xzf ~/Downloads/vsts-agent-rhel.7.2-x64-2.103.1.tar.gz
 ```
 ## Step 4: Configure
 

diff --git a/docs/start/startubuntu.md b/docs/start/startubuntu.md
@@ -8,14 +8,24 @@
 
 ## Step 2: Download from Releases
 
-Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.0)
+Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.1)
 
 ## Step 3: Create the agent
 
+**16.04**
+
 ```bash
 ~/$ mkdir myagent && cd myagent
-~/myagent$ tar xzf ~/Downloads/vsts-agent-ubuntu.14.04-x64-2.103.0.tar.gz
+~/myagent$ tar xzf ~/Downloads/vsts-agent-ubuntu.16.04-x64-2.103.1.tar.gz
 ```
+
+**14.04**
+
+```bash
+~/$ mkdir myagent && cd myagent
+~/myagent$ tar xzf ~/Downloads/vsts-agent-ubuntu.14.04-x64-2.103.1.tar.gz
+```
+
 ## Step 4: Configure
 
 ```bash

diff --git a/docs/start/startwin.md b/docs/start/startwin.md
@@ -2,18 +2,20 @@
 
 ## Step 1: System Requirements
 
-[Read here](../preview/latebreaking.md) to ensure system packages are installed
+The minimum supported version is Windows 7.
+
+Even though the agent has no pre-requisites, many of the tasks we run require Visual Studio.
 
 ## Step 2: Download from Releases
 
-Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.0)
+Download the agent from [github releases](https://github.com/Microsoft/vsts-agent/releases/tag/v2.103.1)
 
 ## Step 3: Create the agent
 
 Create a directory for the agent and unzip.  Use explorer or from cmd:  
 ```bash
 c:\ mkdir myagent && cd myagent
-C:\myagent> Add-Type -AssemblyName System.IO.Compression.FileSystem ; [System.IO.Compression.ZipFile]::ExtractToDirectory("$HOME\Downloads\vsts-agent-win7-x64-2.103.0.zip", "$PWD")
+C:\myagent> Add-Type -AssemblyName System.IO.Compression.FileSystem ; [System.IO.Compression.ZipFile]::ExtractToDirectory("$HOME\Downloads\vsts-agent-win7-x64-2.103.1.zip", "$PWD")
 ```
 ## Step 4: Configure