Simulator Client Installation: Linux

These instructions are for version 420 or later of the simulator client, which will be available within a few days of this post.

Here are detailed installation instructions for our simulator client on most modern Linux distributions. Please use this thread to ask any questions or discuss any issues you may encounter.

Right now we only support 64-bit architectures, no 32-bit or ARM support yet.

#Basic Instructions
Visit the client download page and follow the instructions.

You may need to give execute permission to the amr application in order to run it:

> chmod +x amr
> ./amr

#Why do I need to install the .NET Core SDK?
You technically don’t need to install the entire SDK, but that is the easiest way to get all of the proper prerequisites installed. Having the .NET Core SDK on your computer won’t hurt anything, so we recommend saving yourself a lot of trouble and just install the SDK provided by Microsoft.

#I really just want to install the prerequisites.
If you really don’t want to install the full .NET Core SDK, you can give this article a read and try installing just the prerequisites that your system needs, but we won’t be able to help you much if something goes wrong. Our client download includes the full version of .NET Core that we developed against, so if you can get it to run with just the prerequisites, go for it!

###Example Script
If you want to automate setting up a Linux machine, here is an example script that will set up a fresh ubuntu 16.04 machine to run .NET Core applications. This installs the full .NET Core SDK.

#!/bin/sh

#Register the Microsoft Product key as trusted.
curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg

#Set up the desired version host package feed.
sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-xenial-prod xenial main" > /etc/apt/sources.list.d/dotnetdev.list'
sudo apt-get update

#Install unzip.
sudo apt-get -y install unzip

#Install .NET Core.
sudo apt-get -y install dotnet-sdk-2.0.0

For Fedora 28:

#!/bin/bash

echo Importing Microsoft Key…
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
wget -q https://packages.microsoft.com/config/fedora/27/prod.repo
sudo mv prod.repo /etc/yum.repos.d/microsoft-prod.repo
sudo chown root:root /etc/yum.repos.d/microsoft-prod.repo

echo Updating Yum…
dnf update

echo Installing Required Applications…
dnf install -y libunwind dotnet-sdk-2.1 aspnetcore-runtime-2.1

echo Success!