====== MVS Turnkey in Docker ======

Assumes that you already have Docker installed and running. If you don’t, you can find instructions [[:docker_linux|here]].

:!: Depending on your configuration, you may have to sudo your docker commands.
===== Pull Ubuntu Image =====

Pull the latest Ubuntu image:

<code bash>
docker pull ubuntu
</code>

Verify image:

<code bash>
docker image list
</code>

Results should look something like this:

<code>
REPOSITORY   TAG       IMAGE ID       CREATED      SIZE
ubuntu       latest    597ce1600cf4   6 days ago   72.8MB
</code>

===== Create Container / Start a Shell =====

Create a container in the ubuntu image, and start a shell:

<code bash>
docker run --interactive --tty --name mvs_container ubuntu /bin/bash
</code>

(You can use any name you like. mvs_container is just an example.)

===== Get IP Address =====

Update your package list, install net-tools, run ifconfig, and note your IP address (you’ll need it later):

<code bash>
apt update

apt install net-tools

ifconfig
</code>

===== Retrieve the MVS Turnkey Archive =====

Change to /root, create a downloads directory, install wget, and retrieve the turnkey archive:

<code bash>
cd /root
 
mkdir downloads
 
cd downloads
 
apt install wget
 
wget https://wotho.ethz.ch/tk4-/tk4-_v1.00_current.zip
</code>

===== Install and Run MVS =====

Change to the /opt directory, create a mvs directory, install unzip, and then extract the turnkey archive into the mvs directory:

<code bash>
cd /opt
 
mkdir mvs
 
cd mvs
 
apt install unzip
 
unzip /root/downloads/tk4-_v1.00_current.zip
</code>

Turn on console mode:

<code bash>
cd unattended
 
./set_console_mode
 
cd ..
</code>

Start MVS:

<code>
./mvs
</code>

When the startup is complete:

{{ :mainframe:tk4-startup-complete.png |}}

You can open an instance of the x3270 terminal emulator, and connect to the running instance using the IP address you noted earlier. Detailed MVS operations instructions can be found [[mainframe_emulation_raspberry_pi_zero|here]]. (Just note that these instructions are for running on the Raspberry Pi, so adapt accordingly.)

After you complete your session and exit the container, you can return to it later:

<code bash>
docker start --interactive mvs_container
</code>

{{tag>docker mainframe retro}}