Preparing the Workstation (Single-User Configuration)

Note: This section contains the instructions for preparing the workstation when installing McIDAS-X on Windows in the single-user configuration. For the multi-user configuration instructions or information about the two configuration options, return to the Configuration Options and Instructions and follow those instructions.

Complete the instructions below to update and install WSL 2, Ubuntu, and the Linux packages required to build McIDAS-X.

Open a PowerShell window as Administrator. Install and update WSL and Ubuntu to the correct versions by completing the instructions in Prerequisites and Install WSL Command at Microsoft's How to install Linux on Windows with WSL. Administrator access is required, and a restart may be required after Linux is installed.

Type: wsl --install

This command only works if WSL is not installed at all. If you run wsl --install and see the WSL help text, proceed to the next command.

Type: wsl --install -d Ubuntu-22.04

If this is the first installation of Ubuntu, after the Ubuntu install is complete, you will be prompted to create a user account. The account, which will have sudo privileges, is the main user account and should NOT be named root or mcidas or mcadde. Instead, choose a name suitable for a McIDAS-X user; we suggest either your Windows login or mcuser.

The PowerShell or Windows Command Prompt Window may convert to an Ubuntu window. This window can be used for the next steps.

In an Ubuntu shell while logged in as the user you created in the previous step (e.g., mcuser), run the three sudo commands below (the last is all one line) to update the Linux package repositories and to install the packages required to build McIDAS-X.

Type:  sudo apt update
Type:  sudo apt upgrade
Type:  sudo apt install autoconf automake bison build-essential cmake csh flex gfortran g++ libncurses5 libncurses5-dev libx11-dev libxext-dev libxpm-dev libxt-dev texinfo xfonts-base