dotnet-installer/Documentation/known-issues.md

Known issues & workarounds

OpenSSL dependency on OS X

OS X "El Capitan" (10.11) comes with 0.9.8 version of OpenSSL. .NET Core depends on versions >= 1.0.1 of OpenSSL. You can update the version by using Homebrew, MacPorts or manually. The important bit is that you need to have the required OpenSSL version on the path when you work with .NET Core.

With Homebrew, you can run the following commands to get this done:

brew update
brew install openssl
brew link --force openssl

Homebrew may also show the following warning:

Apple has deprecated use of OpenSSL in favor of its own TLS and crypto libraries

This warning is meant for the software that uses OpenSSL (in this case, .NET Core) and not for the end-user that is installing said software. Homebrew installation doesn't touch either the existing Apple crypto libraries or existing OpenSSL 0.9.8 version, so there is no impact on any software that uses either one of those crypto solutions and is already installed.

MacPorts doesn't have the concept of linking, so it is reccomended that you uninstall 0.9.8 version of OpenSSL using the following command:

sudo port upgrade openssl
sudo port -f uninstall openssl @0.9.8

You can verify whether you have the right version using the openssl version command from the Terminal.

Running .NET Core CLI on Nano Server

If you’re using Nano Server Technical Preview 5 with .NET Core CLI, you will need to copy all DLL files from c:\windows\system32\forwarders to c:\windows\system32, due to a bug that has since been fixed in later releases.

If you use “dotnet publish”, make sure to copy all DLL files from c:\windows\system32\forwarders to your publish directory as well.

If your Nano Server Technical Preview 5 build is updated or serviced, please make sure to repeat this process, in case any of the DLLs have been updated as well.

Apologies for any inconvenience. Again, this has been fixed in later releases.

Users of zsh (z shell) don't get dotnet on the path after install

There is a known issue in oh-my-zsh installer that interferes with how path_helper works on OS X systems. In short, the said installer creates a .zshrc file which contains the exploded path at the time of installation. This clobbers any dynamically generated path, such as the one generated by path_helper.

There is an outstanding PR on the oh-my-zsh repo for this.

Workaround 1: symlink the dotnet binary in the installation directory to a place in the global path, e.g. /usr/local/bin. The command you can use is:

ln -s /usr/local/share/dotnet/dotnet /usr/local/bin

Workaround 2: edit your .zshrc and/or .zshprofile files to add the /usr/local/share/dotnet to the $PATH.

On dev builds of the tools, restoring default project from dotnet new fails

When using non-release versions of the CLI, dotnet restore will fail to restore Microsoft.NETCore.App because for that particular version it exists on a NuGet feed that is not configured on the machine. This behavior is by design and does not happen with public releases (such as RC2).

Workaround: create a NuGet.config file in the project directory which contains the following:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <!--To inherit the global NuGet package sources remove the <clear/> line below -->
    <clear />
    <add key="dotnet-core" value="https://dotnet.myget.org/F/dotnet-core/api/v3/index.json" />
    <add key="api.nuget.org" value="https://api.nuget.org/v3/index.json" />
  </packageSources>
</configuration>

dotnet restore times out on Win7 x64

If you have any virtualization software (so far we've confirmed VMWare and Virtual Box) and you try to use the CLI on a Win7 SP1 x64 machine, dotnet restore will be really slow and will eventually time out without doing much restoring. The issue is in the virtual networking adapters that usually get installed with said software.

Issues tracking this:

• #1732

Affects: dotnet restore

Workaround: disable the virtual network interface and do the restore.

Resolving the Standard library packages

The StdLib package is on a MyGet feed. In order to restore it, a MyGet feed needs to be added to the NuGet feeds, either locally per application or in a central location.

Issues tracking this:

• #535

Affects: dotnet restore

Workaround: update to the latest bits and run dotnet new in an empty directory. This will now drop a nuget.config file that you can use in other applications.

If you cannot update, you can use the following nuget.config:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <!--To inherit the global NuGet package sources remove the <clear/> line below -->
    <clear />
    <add key="dotnet-core" value="https://dotnet.myget.org/F/dotnet-core/api/v3/index.json" />
    <add key="api.nuget.org" value="https://api.nuget.org/v3/index.json" />
  </packageSources>
</configuration>

Uninstalling/reinstalling the PKG on OS X

OS X doesn't really have an uninstall capacity for PKGs like Windows has for MSIs. There is, however, a way to remove the bits as well as the "recipe" for dotnet. More information can be found on this SuperUser question.

What is this document about?

This document outlines the known issues and workarounds for the current state of the CLI tools. Issues will also have a workaround and affects sections if necessary. You can use this page to get information and get unblocked.

What is a "known issue"?

A "known issue" is a major issue that block users in doing their everyday tasks and that affect all or most of the commands in the CLI tools. If you want to report or see minor issues, you can use the issues list.