Update global tool versions in docs.
authorMike McLaughlin <mikem@microsoft.com>
Wed, 17 Apr 2019 16:39:54 +0000 (09:39 -0700)
committerMike McLaughlin <mikem@microsoft.com>
Wed, 17 Apr 2019 18:28:07 +0000 (11:28 -0700)
documentation/dotnet-dump-instructions.md
documentation/installing-sos-instructions.md
documentation/installing-sos-windows-instructions.md

index b3ecca49175421c3230c1fbad0870dab456e6937..a936851a1b024caa9825a343f7b4af38e97d6bc8 100644 (file)
@@ -5,11 +5,11 @@ The dotnet-dump CLI global tool is way to collect and analyze Windows and Linux
 
 ## Installing dotnet-dump
 
-The first step is to install the dotnet-dump CLI global tool. This requires the 2.1 .NET Core SDK to be installed. 
+The first step is to install the dotnet-dump CLI global tool. This requires the 2.1 .NET Core SDK to be installed. If you see the error message `Tool 'dotnet-dump' is already installed`, you will need to uninstall the global tool (see below). 
 
-    $ dotnet tool install -g dotnet-dump --version 1.0.2-preview3.19170.2 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json
+    $ dotnet tool install -g dotnet-dump --version 1.0.3-preview5.19217.3 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json
     You can invoke the tool using the following command: dotnet-dump
-    Tool 'dotnet-dump' (version '1.0.2-preview3.19170.2') was successfully installed.
+    Tool 'dotnet-dump' (version '1.0.3-preview5.19217.3') was successfully installed.
 
 ## Using dotnet-dump
 
@@ -104,3 +104,8 @@ To display the help:
       histroot <arguments>                 Displays information related to both promotions and relocations of the specified root.
       setsymbolserver <arguments>          Enables the symbol server support
       soshelp <arguments>                  Displays all available commands when no parameter is specified, or displays detailed help information about the specified command. soshelp <command>
+
+## Uninstalling dotnet-dump 
+
+    $ dotnet tool uninstall -g dotnet-dump
+    Tool 'dotnet-dump' (version '1.0.3-preview5.19217.3') was successfully uninstalled.
\ No newline at end of file
index 9e9f8ef97d600d1f0e10fa16c8a78f76dc4fabea..c6474860b1c95715cc503c0f3422316be684bb62 100644 (file)
@@ -1,16 +1,18 @@
 Installing SOS on Linux and MacOS
 =================================
 
-The first step is to install the dotnet-sos CLI global tool. This requires the 2.1 .NET Core SDK to be installed. 
+The first step is to install the dotnet-sos CLI global tool. This requires the 2.1 .NET Core SDK to be installed. If you see the error message `Tool 'dotnet-sos' is already installed`, you will need to uninstall the global tool (see below). 
 
-    $ dotnet tool install -g dotnet-sos --version 1.0.2-preview3.19170.2 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json
+    $ dotnet tool install -g dotnet-sos --version 1.0.3-preview5.19217.3 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json
     You can invoke the tool using the following command: dotnet-sos
-    Tool 'dotnet-sos' (version '1.0.2-preview3.19170.2') was successfully installed.
+    Tool 'dotnet-sos' (version '1.0.3-preview5.19217.3') was successfully installed.
+
+
 
 The next step is use this global tool to install SOS. 
 
     $ dotnet sos install
-    Installing SOS to /home/mikem/.dotnet/sos from /home/mikem/.dotnet/tools/.store/dotnet-sos/1.0.2-preview3.19170.2/dotnet-sos/1.0.2-preview3.19170.2/tools/netcoreapp2.1/any/linux-x64
+    Installing SOS to /home/mikem/.dotnet/sos from /home/mikem/.dotnet/tools/.store/dotnet-sos/1.0.3-preview5.19217.3/dotnet-sos/1.0.3-preview5.19217.3/tools/netcoreapp2.1/any/linux-x64
     Creating installation directory...
     Copying files...
     Updating existing /home/mikem/.lldbinit file - LLDB will load SOS automatically at startup
@@ -72,7 +74,7 @@ Now any time you run lldb, SOS will automatically be loaded and the symbol downl
 The installer needs to be run again:
 
     $ dotnet sos install
-    Installing SOS to /home/mikem/.dotnet/sos from /home/mikem/.dotnet/tools/.store/dotnet-sos/1.0.2-preview3.19170.2/dotnet-sos/1.0.2-preview3.19170.2/tools/netcoreapp2.1/any/linux-x64
+    Installing SOS to /home/mikem/.dotnet/sos from /home/mikem/.dotnet/tools/.store/dotnet-sos/1.0.3-preview5.19217.3/dotnet-sos/1.0.3-preview5.19217.3/tools/netcoreapp2.1/any/linux-x64
     Installing over existing installation...
     Creating installation directory...
     Copying files...
@@ -89,7 +91,7 @@ To uninstall and remove the lldb configuration run this command:
     Reverting /home/mikem/.lldbinit file - LLDB will no longer load SOS at startup
     SOS uninstall succeeded
 
-To remove the SOS installer global tool (optional):
+To remove the SOS installer global tool:
 
     $ dotnet tool uninstall -g dotnet-sos
-    Tool 'dotnet-sos' (version '1.0.2-preview3.19170.2') was successfully uninstalled.
+    Tool 'dotnet-sos' (version '1.0.3-preview5.19217.3') was successfully uninstalled.
index 67866433eb9fe6418a4430815540b4a86ad849a2..2576768d04f45f6063a5806c65947834b3d556eb 100644 (file)
@@ -47,14 +47,14 @@ SOS will automatically be loaded from the internal Microsoft extension gallery.
 
 It is recommended that you update to the newer versions of the Windows debugger, but you can still use the latest SOS with older Windows debuggers by using the dotnet-sos CLI global tool to install. It is not as convenient. You may have to ".unload" the SOS that is loaded from the "runtime" directory.
 
-    C:\Users\mikem>dotnet tool install -g dotnet-sos --version 1.0.2-preview3.19170.2 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json
+    C:\Users\mikem>dotnet tool install -g dotnet-sos --version 1.0.3-preview5.19217.3 --add-source https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json
     You can invoke the tool using the following command: dotnet-sos
-    Tool 'dotnet-sos' (version '1.0.2-preview3.19170.2') was successfully installed.
+    Tool 'dotnet-sos' (version '1.0.3-preview5.19217.3') was successfully installed.
 
 Run the installer:
 
     C:\Users\mikem>dotnet sos install
-    Installing SOS to C:\Users\mikem\.dotnet\sos from C:\Users\mikem\.dotnet\tools\.store\dotnet-sos\1.0.2-preview3.19170.2\dotnet-sos\1.0.2-preview3.19170.2\tools\netcoreapp2.1\any\win-x64
+    Installing SOS to C:\Users\mikem\.dotnet\sos from C:\Users\mikem\.dotnet\tools\.store\dotnet-sos\1.0.3-preview5.19217.3\dotnet-sos\1.0.3-preview5.19217.3\tools\netcoreapp2.1\any\win-x64
     Creating installation directory...
     Copying files...
     Execute '.load C:\Users\mikem\.dotnet\sos\sos.dll' to load SOS in your Windows debugger.