Foster Moore provides a one step installer for Magellan Builder and Verne – Catalyst Cloud Server for Microsoft Windows, Apple macOS and GNU/Linux. Please note that this is a licensed product and you need to have a license to use the product.
Windows
Obtain the latest version from https://docker.io.fostermoore.com/artifactory/list/magellan/
Make sure you select the correct installer for your operating system and the correct version for Verne (pick one without Catalyst in the filename)
Double click the Magellan Windows Setup file downloaded from the link above and follow the instructions.
The installer will detect any missing dependencies and prompt you to install them where they cannot be found.
These dependencies include Java 11 JDK, Git for Windows and Docker Desktop
Docker Desktop
When installing Docker desktop you may see the following dialog:
If you do not see this option then skip the rest of this section and continue to Setting up your Docker Resources below.
If you are given this choice ensure that ‘Install required Windows components for WSL 2‘ is checked and follow the instructions in the rest of this section.
Once Docker Desktop has installed you will see the following restart dialog
It is safe to click ‘Close and restart‘, then your system will automatically reboot and Windows will reconfigure itself to use WSL 2.
Once Windows reboots there will be some further setup that you need to do in order to get Docker Desktop running correctly. You should wait until Windows displays the following dialog then follow the on-screen instructions (NOTE: you will need to move this dialog to one side and keep it open while you follow the instructions)
Once you have installed the WSL2 Linux kernel update package click ‘Restart’ in the Docker Desktop WSL2 dialog that you left open.
The Docker Desktop service will now restart. Once it has startup up Magellan is ready to use. You may now skip the rest of this page and go to Project Setup here https://partner.fostermoore.com/products/register-tools/project-setup/
macOS
Prerequisites
Obtain the correct installer for your operating system from https://docker.io.fostermoore.com/artifactory/list/magellan/
Configuring Verne – Catalyst Cloud applications require Docker Desktop to be installed and configured.
Docker Desktop installation packages for macOS may be downloaded directly from https://download.docker.com/mac/stable/Docker.dmg
After you have installed Docker for Mac please make sure you configure Docker Resources correctly before starting the Verne server.
Setting up your Docker Resources
Docker requires access to more CPUs than the default of two. Please change your Docker Resources as below.
Change Resources – CPU and Memory
- Set CPUs to your max -1
- Set Memory to at least 10GB
Setup Access to Resources
Access to resources is already enabled by default for macOS so extra setup is required.
If a Java JDK and Git have not previously been installed the OS will prompt to install them on launching Magellan.
It is recommended however to install these before installing Magellan as the OS prompt is not always reliable.
OpenJDK installation packages for macOS may be found at https://adoptopenjdk.net
Git installation packages for macOS may be found at https://git-scm.com/download/mac
Installation
When you have met all the prerequisites double-click the macOS package installer file downloaded from the link above and follow the on-screen instructions.
The installer will install Magellan Builder into the system Applications folder and also place a link there to start the Verne Server. Verne Server (Start Clean) will remove all data from your database.
GNU / Linux
Debian (deb) Based Distributions – Debian / Ubuntu and derivatives
Obtain the .deb package from https://docker.io.fostermoore.com/artifactory/list/magellan/
Open a terminal and type:
sudo apt-get install -y ./Magellan-*_Linux_x64.debThe package manager will take care of installing the necessary dependencies.
Arch (pacman) Based Distributions – Arch, Manjaro, etc
Obtain the .tar.xz package from https://docker.io.fostermoore.com/artifactory/list/magellan/
Open a terminal and type:
sudo pacman -U ./Magellan-*_ArchLinux_x64.tar.xzThe package manager will take care of installing the necessary dependencies.
Amazon Linux Workspaces.
There is a setup script designed specifically for Amazon Workspace installations. Please contact Foster Moore support for access.
Other RedHat (rpm) Based Distributions – RHEL, CentOS, Fedora, SuSE, etc
The RPM version of Magellan is stored in an rpm repository in Foster Moore’s artifactory server.
To setup this repository perform the following steps:
Repository Installation
Copy and paste the following code into a terminal (as root):
sh -c "echo '[catalyst-magellan]
name=catalyst-magellan
baseurl=https://docker.io.fostermoore.com/artifactory/catalyst-rpm/
enabled=1
gpgcheck = 1
retries = 7
skip_if_unavailable = 1
keepcache = 0
timeout = 5.0
username=
password=' > /etc/yum.repos.d/catalyst-magellan.repo"Copy the Foster Moore RPM GPG public key into the /etc/pki/rpm-gpg directory by copy-pasting the following code in a terminal (as root), making sure to replace <user> and <pass> with your artifactory username and password.
wget -O- https://<user>:<pass>@docker.io.fostermoore.com/artifactory/magellan/RPM-GPG-KEY-FosterMoore | sudo tee -a /etc/pki/rpm-gpg/RPM-GPG-KEY-FosterMoore && sudo rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-FosterMooreNext open the /etc/yum.repos.d/catalyst-magellan.repo file and enter your artifactory username and password into the username= and password= sections at the bottom of the file.
Then type sudo yum update -y && sudo yum install Magellan
For all RPM based distributions please refer to the relevant docker documentation to ensure you install the correct docker version.
Please also refer to these instructions for installing docker-compose as this is required for Magellan to work.
Alternative Manual Install
Obtain the .rpm package from https://docker.io.fostermoore.com/artifactory/list/catalyst-rpm/
Open a terminal and type:
sudo yum localinstall -y Magellan-*_Linux_x64.rpmIf the above commands produce an error message similar to:
Problem: package Magellan-2.18.0-1.x86_64 requires docker, but none of the providers can be installed
then you will need to manually install Magellan (and dependencies) by performing these extra steps (as root)
yum install -y yum-utils
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yum install -y docker-ce --nobest
yum install java-11-openjdk-devel git
rpm -Uvh --nodeps Magellan-*_Linux_x64.rpmPlease ensure you refer to the relevant docker documentation to install the correct docker version for your distibutiuon.
Please also refer to these instructions for installing docker-compose as this is required for Magellan to work.
Additional GNU / Linux Configuration
Before starting Magellan you may need to ensure that you have the correct permissions for connecting to and controlling the docker daemon. If your user is not already a member of the docker groups (in a terminal type groups and check the output for the word docker) then you will need to add yourself to the docker group. You can do this by opening
a terminal and typing the following command:
sudo usermod -aG docker $USER Depending on your desktop you may also need to remap a keyboard shortcut to prevent the Alt-click combination from moving windows. Since Magellan makes use of an Alt-click combination for some functions these functions will not work if Alt-Click is mapped to a window movement function.
Gnome 3
Gnome 3 users can skip this step as they will already by default have Super-clickmapped to move windows instead.
MATE Desktop
Go to the System Menu at the bottom left and open Preferences > Windows (or Control Panel > Windows).
Switch to the Behavior tab and under Movement Key select Super (or "Windows logo")
Alternatively open a terminal and type the following:
gsettings set org.mate.Marco.general mouse-button-modifier '<Super>'MATE users may also need to disable Ctrl-Alt-Left/Right workspace mappings
gsettings set org.mate.Marco.global-keybindings switch-to-workspace-left disabled
gsettings set org.mate.Marco.global-keybindings switch-to-workspace-right disabledPlasma (KDE 5) Desktop
Go to System Settings > Window Behaviour > Window Actions and under the Inner Window, Titlebar and Frame Actions section change the modifier key from Alt to Meta
