Update Linux installation guides

[Chielus]

I don't know where to post this really, so my best bet would be here. If not, please move this topic to the correct location.

The installation guides for Linux machines is somewhat outdated and has wrong syntax at some points. This counts for all supported distro's. In this post are a few suggestions to fix errors that will break the installation.

All distro's

In step 2 of all installation guides there is wrong syntax, which can result in the command not executing on RHEL en Arch based systems, as it expects an array to be echo'd instead of a single value and the $ is in the wrong location for this.

Old:

export WINEPREFIX="/home/${USER}/.config/projectascension/WoW"

Suggestion:

export WINEPREFIX="/home/$USER/.config/projectascension/WoW"

In step 3 there is a error with the command to extract the .msi file. The extraction fails because there is no folder called /home/$user/.config/projectascension/WoW made yet. This has to be done in order to install the file properly. Some distro's won't display an error and will install it as a general wine-prefix, instead of the one defined in step 2. This breaks the installation later on.

Old:

wget https://dl.winehq.org/wine/wine-mono/6.3.0/wine-mono-6.3.0-x86.msi
wine msiexec /i wine-mono-6.3.0-x86.msi
winetricks win10 ie8 corefonts dotnet45 vcrun2015

Suggestion:

mkdir -p /home/$USER/.config/projectascension/WoW && cd /home/$USER/.config/projectascension
wget https://dl.winehq.org/wine/wine-mono/6.3.0/wine-mono-6.3.0-x86.msi
wine msiexec /i wine-mono-6.3.0-x86.msi
winetricks win10 ie8 corefonts dotnet45 vcrun2015

Note: the suggestion would make more sense to be added before making the wineprefix in step 2.

Step 4 is obsolete for all distro's other then Debian/Ubuntu, as modern kernels / package managers do this by default and / or is set in settings. They can also be downloaded via the package manager in the Terminal if needed. Graphical installers like Manjaro will give the option to install with these kind of drivers from the start of the installation.

Step 5 is actually incomplete. Since it's an .appimage it needs to actually be made executable or else it fails to even start. Some distro's won't give a warning, just simply do nothing after a double-click.

To make it work the user either has to right-click the file, go to properties and "allow to execute as a program" should be checked. Or use a command such as the following in the download location:

chmod +x ascension-launcher-XX.AppImage

Arch / Manjaro specific:

In step 1 it directs to a package which is no longer in the pacman repository. It has combined with the default mono package and that one should be used instead. Using the old command gives an error, when searching online many pages redirect to the AUR version of mono-complete, which is not compatible with the Ascension Launcher.

Also a minor gripe of mine, using the --no-confirm flag can actually break a machine. If they have manually setup some specific version of mono to compete with old or 32bit software, this command will force a new version on the system and remove the old one, without allowing the user to press 'no' when the system warns about this.

Old (Manjaro / Arch):

sudo pacman -Syu
sudo pacman -Sy wine winetricks mono-complete --noconfirm

Suggestion (Manjaro / Arch):

sudo pacman -Syu
sudo pacman -S wine winetricks mono

I haven't tested the parts of CentOS fully yet, but will run it in a VM and see what I can find. If correct, it should be a nearly 1-1 implementation for Fedora Linux, which I have used before to connect to the server. If I find anything useful there, I will update this post.

[Chielus]

Considering these changes have been implemented on the main Linux download page, this thread can be removed/archived.

@Excl