RSTS-11 v4B Ersatz-11

docs/1970s/1973/unix-v4/ersatz-11/index.md

@@ -0,0 +1,97 @@
+---
+keywords: ["Unix v4", "Unix", "PDP-11", "Ersatz-11", 1970s, 1973]
+image: ./unix-v4-Ersatz-11-3.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: 2
+sidebar_label: "! Unix v4 on Ersatz-11"
+---
+
+# How to install ! Unix v4 on Ersatz-11?
+
+![Ersatz-11 PDP-11 emulator with ! Unix v4](./unix-v4-Ersatz-11-3.webp)
+
+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. It can be used on Ersatz-11 emulator.
+
+## Downloads
+
+First, we need to prepare an image of Unix v5 with the `nsys` kernel. We have prepared such an image for you to download:
+
+- [! Unix-v4 image (v5 root with nsys kernel)](https://github.com/InstallerLegacy/nsys-image/releases/latest/download/nsysroot.zip)
+
+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-v4
+
+:::tip
+
+If you have not already installed Ersatz-11 emulator, see [the VirtualHub Setup tutorial on how to do so](https://setup.virtualhub.eu.org/ersatz-11/) on Linux and Windows.
+
+:::
+
+Extract the archive you downloaded. Inside you will find a file called `nsysroot`. Create a folder somewhere to store the files for this VM and move that file into it.
+
+Now we will create a config file for our VM. Create a text file called `e11.ini` with the following content in the VM folder:
+
+```ini
+set cpu 45
+mount dk0: nsysroot. /rk05
+boot dk0:
+```
+
+![e11.ini](./unix-v4-Ersatz-11-1.webp)
+
+Now open a terminal and move to the VM folder. Run the following command to start the emulator:
+
+```bash
+e11
+```
+
+![e11](unix-v4-Ersatz-11-2.webp)
+
+After the emulator starts, you will get a `@` prompt. Type `nsys` and press enter to run the `nsys` kernel. You will be asked to log in. Type `root` and press enter to log in. There is no password.
+
+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-v4 list of files in root](./unix-v4-Ersatz-11-3.webp)
+
+That's it! We used ! Unix-v4. To exit the emulator, press `Shift` + `Enter` and then type `exit` and press enter. We can create a shell script to make it easy to launch the VM.
+
+### Linux
+
+Create a file called `unix-v4.sh` with the following content:
+
+```bash
+#!/bin/bash
+e11
+```
+
+Now make the file executable:
+
+```bash
+chmod +x unix-v4.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/1973/unix-v4/#manuals) on the [main ! Unix-v4 page](/1970s/1973/unix-v4) to learn how to use it.
+
+### Windows
+
+Create a file called `unix-v4.bat` with the following content:
+
+```bash
+e11
+```
+
+Now you can start the VM by double-clicking the shell script. See the [manuals section](/1970s/1973/unix-v4/#manuals) on the [main ! Unix-v4 page](/1970s/1973/unix-v4) to learn how to use it.
+
+
+## Credits
+
+- The Unix v5 image, the `nsys` kernel and other files used above are from [TUHS](https://www.tuhs.org).
+
+## 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/1973/unix-v4/ersatz-11/).

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

@@ -11,7 +11,7 @@ import DocCardList from '@theme/DocCardList';
 
 ![! Unix v4](./nsys.webp)
 
-! Unix v4 was an operating system for the DEC PDP-11 computer. It was developed by Bell Labs. Sadly, we do not have a complete copy of Unix v4, but we do have a copy of a [kernel](<https://en.wikipedia.org/wiki/Kernel_(operating_system)>) that is from between v3 and v4. We can use that kernel with v5 [userland](https://en.wikipedia.org/wiki/User_space). It can be used on SIMH PDP-11 emulator.
+! Unix v4 was an operating system for the DEC PDP-11 computer. It was developed by Bell Labs. Sadly, we do not have a complete copy of Unix v4, but we do have a copy of a [kernel](<https://en.wikipedia.org/wiki/Kernel_(operating_system)>) that is from between v3 and v4. We can use that kernel with v5 [userland](https://en.wikipedia.org/wiki/User_space). It can be used on SIMH PDP-11 emulator and the Ersatz-11 emulator.
 
 <DocCardList />
 

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

@@ -0,0 +1,95 @@
+---
+keywords: ["Unix v5", "Unix", "PDP-11", "Ersatz-11", 1970s, 1974]
+image: ./unix-v5-Ersatz-11-3.webp
+description: 'We can run ! Unix v5 on the Ersatz-11 emulator. First, we need to download the ! Unix v5 kit. You can download the kit needed to run it from the "SIMH Legacy" website.'
+sidebar_position: 2
+sidebar_label: "! Unix v5 on Ersatz-11"
+---
+
+# How to install ! Unix v5 on Ersatz-11?
+
+![Ersatz-11 PDP-11 emulator with ! Unix v5](./unix-v5-Ersatz-11-3.webp)
+
+We can run ! Unix v5 on the Ersatz-11 emulator. First, we need to download the ! Unix v5 kit.
+
+## Downloads
+
+You can download the kit needed to run ! Unix v5 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 Ersatz-11 emulator, see [the VirtualHub Setup tutorial on how to do so](https://setup.virtualhub.eu.org/ersatz-11/) 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 `e11.ini` with the following content in the VM folder:
+
+```ini
+set cpu 45
+mount dk0: unix_v5_rk.dsk /rk05
+boot dk0:
+```
+
+![e11.ini](./unix-v5-Ersatz-11-1.webp)
+
+Now open a terminal and move to the VM folder. Run the following command to start the emulator:
+
+```bash
+e11
+```
+
+![e11](unix-v5-Ersatz-11-2.webp)
+
+After the emulator starts, you will get a `@` prompt. Type `unix` and press enter to run the `unix` kernel. You will be asked to log in. Type `root` and press enter to log in. There is no password.
+
+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-Ersatz-11-3.webp)
+
+That's it! We used ! Unix-v5. To exit the emulator, press `Shift` + `Enter` and then type `exit` and press enter. We can create a shell script to make it easy to launch the VM.
+
+### Linux
+
+Create a file called `unix-v5.sh` with the following content:
+
+```bash
+#!/bin/bash
+e11
+```
+
+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
+
+Create a file called `unix-v5.bat` with the following content:
+
+```bash
+e11
+```
+
+Now you can start the VM by double-clicking the shell script. 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.
+
+
+## Credits
+
+- The disk image and other files used above are from a kit available on [SimH “Classic” website](http://simh.trailing-edge.com/).
+
+## 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/ersatz-11/).

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

@@ -11,7 +11,7 @@ import DocCardList from '@theme/DocCardList';
 
 ![! 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.
+! 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 as well as the Ersatz-11 emulator.
 
 <DocCardList />
 

docs/1970s/1975/rsts-11-v4b/ersatz-11/index.md

@@ -0,0 +1,103 @@
+---
+keywords: ["RSTS-11 v4B", "PDP-11", "Ersatz-11", 1970s, 1975]
+image: ./rsts-11-v4b-Ersatz-11-3.webp
+description: 'We can run ! RSTS-11 v4B on the Ersatz-11 emulator. First, we need to download the ! RSTS-11 image. You can download the image needed to run it from here.'
+sidebar_position: 2
+sidebar_label: "! RSTS-11 v4B on Ersatz-11"
+---
+
+# How to install ! RSTS-11 v4B on Ersatz-11?
+
+![Ersatz-11 emulator with ! RSTS-11 v4B](./rsts-11-v4b-Ersatz-11-3.webp)
+
+We can run [! RSTS-11 v4B](/1970s/1975/rsts-11-v4b) on the Ersatz-11 emulator. First, we need to download the ! RSTS-11 v4B image.
+
+## Downloads
+
+:::tip
+
+This tutorial covers how to use ! RSTS-11 v4B on Ersatz-11 emulator using a pre-installed image. If you want to manually install RSTS-11 v4B from its tape image, visit [this page](https://iamvirtual.ca/PDP-11/RSTS-11/Install.htm). That page covers installing it on SIMH, and not Ersatz-11, though.
+
+:::
+
+You can download the image needed to run ! RSTS-11 v4B from here:
+
+- [! RSTS-11 v4B image](https://iamvirtual.ca/PDP-11/RSTS-11/RSTS11v4B.DSK)
+
+## Using ! RSTS-11 v4B
+
+:::tip
+
+If you have not already installed Ersatz-11 emulator, see [the VirtualHub Setup tutorial on how to do so](https://setup.virtualhub.eu.org/ersatz-11/) on Linux and Windows.
+
+:::
+
+Create a folder somewhere to store the files for this VM, and move the file named `RSTS11v4B.DSK` into it.
+
+Now we will create a config file for our VM. Create a text file called `e11.ini` with the following content in the VM folder:
+
+```ini
+set cpu 05
+set memory 64
+mount dk0: RSTS11v4B.DSK /rk05
+boot dk0:
+```
+
+![e11.ini](./rsts-11-v4b-Ersatz-11-1.webp)
+
+Now open a terminal and move to the VM folder. Run the following command to start the emulator:
+
+```bash
+e11
+```
+
+![e11](./rsts-11-v4b-Ersatz-11-2.webp)
+
+After the emulator starts, you will get a `OPTION?` prompt. Type `START` and press enter. Next, you will be asked for date. Provide the date in `DD-MMM-YY` format. For example, `05-JUN-74`. Try entering a date before the year 2000, to avoid problems related to [Y2K](https://en.wikipedia.org/wiki/Year_2000_problem).
+
+After that, you will be asked for time. Enter the time in `HH:MM` format. For example, `19:23`. You will be asked if you want to enable crash dump. Type `Y` and press enter.
+
+Now start PIP by executing `RUN PIP`. After PIP starts, you will get a `#` prompt. You can now type `/DI` followed by enter. It will list all the files available on the disk.
+
+![! RSTS-11 v4B](./rsts-11-v4b-Ersatz-11-3.webp)
+
+That's it! We used ! RSTS-11 v4B. We can create a shell script to make it easy to launch the VM.
+
+### Linux
+
+Create a file called `rsts-11-v4b.sh` with the following content:
+
+```bash
+#!/bin/bash
+e11
+```
+
+Now make the file executable:
+
+```bash
+chmod +x rsts-11-v4b.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/1975/rsts-11-v4b/#manuals) on the [main ! RSTS-11 v4B page](/1970s/1975/rsts-11-v4b) to learn how to use it.
+
+### Windows
+
+Create a file called `rsts-11-v4b.bat` with the following content:
+
+```bash
+e11
+```
+
+Now you can start the VM by double-clicking the shell script. See the [manuals section](/1970s/1975/rsts-11-v4b/#manuals) on the [main ! RSTS-11 v4B page](/1970s/1975/rsts-11-v4b) to learn how to use it.
+
+## Credits
+
+- The disk image and other files used above are from [https://iamvirtual.ca/PDP-11/RSTS-11/Install.htm](https://iamvirtual.ca/PDP-11/RSTS-11/Install.htm).
+
+## 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/1975/rsts-11-v4b/ersatz-11/).

docs/1970s/1975/rsts-11-v4b/index.md

@@ -1,7 +1,7 @@
 ---
 keywords: ["RSTS-11 v4B", "PDP-11", 1970s, 1975]
 image: ./rsts-11-v4b.webp
-description: "! RSTS-11 v4B was an operating system for the DEC PDP-11 computer. We can run it on SIMH PDP-11 emulator."
+description: "! RSTS-11 v4B was an operating system for the DEC PDP-11 computer. We can run it on SIMH PDP-11 emulator as well as the Ersatz-11 emulator."
 sidebar_position: 2
 ---
 
@@ -11,7 +11,7 @@ import DocCardList from '@theme/DocCardList';
 
 ![! RSTS-11 v4B](./rsts-11-v4b.webp)
 
-! RSTS-11 v4B was an operating system for the DEC PDP-11 computer. We can run it on SIMH PDP-11 emulator.
+! RSTS-11 v4B was an operating system for the DEC PDP-11 computer. We can run it on SIMH PDP-11 emulator as well as the Ersatz-11 emulator.
 
 <DocCardList />