unix v5 on SIMH

docs/1970s/1970/dos-11/simh/index.md

@@ -11,7 +11,6 @@ sidebar_label: "! DOS-11 on SIMH"
 ![SIMH PDP-11 emulator with ! DOS-11](./dos-11-simh-23.webp)
 
 We can run [! DOS-11](/1970s/1970/dos-11) on the SIMH PDP-11 emulator. First, we need to download the ! DOS-11 tapes.
-dos-11-simh-23.webp
 
 ## Downloads
 

docs/1970s/1973/unix-v4/simh/index.md

@@ -1,5 +1,5 @@
 ---
-keywords: ["Unix v1", "Unix", "PDP-11", "SIMH", 1970s, 1973]
+keywords: ["Unix v4", "Unix", "PDP-11", "SIMH", 1970s, 1973]
 image: ./unix-v4-SIMH-5.webp
 description: "Sadly, we do not have a complete copy of Unix v4, but we do have a copy of a kernel that is from between v3 and v4. We can use that kernel with v5 userland."
 sidebar_position: 1
@@ -20,7 +20,7 @@ First, we need to prepare an image of Unix v5 with the `nsys` kernel. We have pr
 
 If you want to prepare the image yourself, refer to [our guide on how to do so](/blog/how-to-put-the-nsys-kernel-on-a-disk-image-of-unix-v5/).
 
-## Using ! Unix-v5
+## Using ! Unix-v4
 
 :::tip
 

docs/1970s/1974/unix-v5/index.md

@@ -1,16 +1,20 @@
 ---
-keywords: ["nsys", "Unix v5", "Unix", "PDP-11", 1970s, 1974]
+keywords: ["Unix v5", "Unix", "PDP-11", "1970s", "1974"]
 image: ./unix-v5.webp
 description: "! Unix v5 was an operating system for the DEC PDP-11 computer. It was developed by Bell Labs."
-sidebar_position: 2
+sidebar_position: 1
 ---
 
+import DocCardList from '@theme/DocCardList';
+
 # ! Unix v5
 
 ![! Unix v5](./unix-v5.webp)
 
 ! Unix v5 was an operating system for the DEC PDP-11 computer. It was developed by Bell Labs. It can be used on SIMH PDP-11 emulator.
 
+<DocCardList />
+
 ## Manuals
 
 Here is the manual for ! Unix v5:

docs/1970s/1974/unix-v5/simh/index.md

@@ -0,0 +1,97 @@
+---
+keywords: ["Unix v5", "Unix", "PDP-11", "SIMH", "1970s", "1974"]
+image: ./unix-v5-SIMH-5.webp
+description: 'We can run ! Unix v5 on the SIMH PDP-11 emulator. First, we need to download the ! Unix v5 kit. You can download the kit needed to run it on the SIMH PDP-11 emulator from the "SIMH Legacy" website.'
+sidebar_position: 1
+sidebar_label: "! Unix v5 on SIMH"
+---
+
+# How to install ! Unix v5 on SIMH?
+
+![SIMH PDP-11 emulator with ! Unix v5](./unix-v5-SIMH-5.webp)
+
+We can run ! Unix v5 on the SIMH PDP-11 emulator. First, we need to download the ! Unix v5 kit.
+
+## Downloads
+
+You can download the kit needed to run ! Unix v5 on the SIMH PDP-11 emulator from the [“SIMH Legacy” website](http://simh.trailing-edge.com/):
+
+- [! Unix-v5 kit](http://simh.trailing-edge.com/kits/uv5swre.zip)
+
+## Using ! Unix-v5
+
+:::tip
+
+If you have not already installed SIMH PDP-11 emulator, see [the VirtualHub Setup tutorial on how to do so](https://setup.virtualhub.eu.org/simh-pdp11/) on Linux and Windows.
+
+:::
+
+Extract the archive you downloaded. Inside you will find a file called several files. Create a folder somewhere to store the files for this VM and move the `unix_v5_rk.dsk` file into it.
+
+Now we will create a config file for our VM. Create a text file called `pdp11.ini` with the following content in the VM folder:
+
+```ini
+set cpu 11/45
+att rk0 unix_v5_rk.dsk
+boot rk0
+```
+
+![pdp11.ini](./unix-v5-SIMH-1.webp)
+
+Now open a terminal and move to the VM folder. Run the following command to start the emulator:
+
+```bash
+pdp11
+```
+
+![pdp11](unix-v5-SIMH-2.webp)
+
+After the emulator starts, you will get a `@` prompt. Type `unix` and press enter to run the `unix` kernel.
+
+![boot](./unix-v5-SIMH-3.webp)
+
+You will be asked to log in. Type `root` and press enter to log in. There is no password.
+
+![! Unix-v5 login](./unix-v5-SIMH-4.webp)
+
+You can now run `ls` to see the list of files. To change directory, you need to use the `chdir` command, `cd` is not available.
+
+![! Unix-v5 list of files in root](./unix-v5-SIMH-5.webp)
+
+That's it! We used ! Unix-v5. We can create a shell script to make it easy to launch the VM. Create a file called `unix-v5.sh` with the following content:
+
+```bash
+#!/bin/bash
+pdp11
+```
+
+Now make the file executable:
+
+```bash
+chmod +x unix-v5.sh
+```
+
+Now you can start the VM using the shell script. For example, on KDE you can right-click the file and choose `Run in Konsole` or on GNOME, where you can right-click the file and choose `Run as executable`. The VM will start.
+
+See the [manuals section](/1970s/1974/unix-v5/#manuals) on the [main ! Unix-v5 page](/1970s/1974/unix-v5) to learn how to use it.
+
+### Windows
+
+:::tip
+
+You should use Linux. If you don’t know how to install a Linux distro, see [our tutorials on how to install Kubuntu](https://setup.virtualhub.eu.org/tag/os/), a beginner-friendly distro.
+
+:::
+
+On Windows, you need to place the `PDP11.exe` file you downloaded in [this tutorial](https://setup.virtualhub.eu.org/simh-pdp11#windows) in the VM folder. Then you can follow the above tutorial as usual. The shell script will not work on Windows. You need to rename it to `unix-v5.bat`. Then you can double-click the file to launch the VM, no need to make it executable.
+
+## Credits
+
+- The disk image and other files used above are from a kit available on [SimH “Classic” website](http://simh.trailing-edge.com/).
+- This tutorial is based on [Computer History Wiki tutorial on running ! Unix v5 on SIMH](https://gunkies.org/wiki/Running_Unix_v5_in_SIMH).
+
+## Video tutorial
+
+Do you want to follow the tutorial by watching a video? We will post a video on our [YouTube channel](https://www.youtube.com/@virtua1hub) soon.
+
+Archives of this tutorial are available on [Wayback Machine](https://web.archive.org/web/*/https://virtualhub.eu.org/1970s/1974/unix-v5/simh/).