Emulator

! How to install SIMH Eclipse emulator?

Legacy Installer

Aug 8, 2024 • 4 min read

In this tutorial, we will install the SIMH Eclipseemulator. The Eclipsewas a computer made by a company called Data General.

Installing

Linux

💡

If you have not already installed a Linux distribution, see our tutorials on how to install Kubuntu, a beginner-friendly distro.

Installing from source code

Like other emulators of SIMH family, the recommended way to install it is to compile it from source code. First, we need to install some tools and dependencies to build it. On Ubuntu/Debian based distros, run the following command:

sudo apt install git make gcc libpcre3-dev libedit-dev libpng-dev

On Fedora and related distros, run:

sudo dnf install git which make gcc pcre-devel libedit-devel libpng-devel

On openSUSE and related distros, run:

sudo zypper in git gawk which make gcc pcre-devel libedit-devel libpng16-devel

On Arch based distros, run:

sudo pacman -S git which make gcc pcre libedit libpng

Now, move to the Downloads folder and clone the SIMH repository:

cd ~/Downloads

git clone https://github.com/simh/simh.git

💡

The simh/simh repository uses a non-free license. You may want to use open-simh/simh repository instead. To know the difference between the two, see here.

git clone https://github.com/simh/simh.git

Move to the simh folder:

cd simh

Run the following command to start compiling emulator:

make eclipse

It will take some time to compile, depending on your hardware. When it is done, move to the BIN folder:

cd BIN

We will install the executable in /usr/local/bin so that we can call it without specifying its path:

sudo install eclipse /usr/local/bin/

Enter your password when asked to do so.

We have installed the SIMH Eclipse emulator. Now you can start it. Just run this command:

eclipse

Install from distribution repository

💡

The last stable release of SIMH was very long time ago. Most distributions continue to package it. It may or may not work with the VirtualHub tutorials. The best way to install SIMH emulators is from source, as explained above.

Some old versions of SIMH don't read eclipse.ini file directly. If you are facing that problem, use eclipse eclipse.ini instead of simply eclipse when following VirtualHub tutorials.

Eclipse emulator is available in Ubuntu repositories in simh package. You can install it on Ubuntu and any Ubuntu/Debian based system using the following command:

sudo apt install simh

This will prompt you for your password. Enter it. The simh package will install. Now you can run Eclipse emulator:

eclipse

Many other distributions also package simh. On Fedora based distros, you can run sudo dnf install simh. On openSUSE based distros, it is sudo zypper in simh. For Arch and related distros, you can use sudo pacman -S simh.

These distributions rename the executable in their packages. So you would need to run simh-eclipse to start the emulator instead of eclipse. Modify the VirtualHub tutorials accordingly if you install it via this method.

💡

On Arch based distros, you can install simh-git from the AUR. This will install SIMH from the latest git snapshot and is much recommended instead of the regular simh package.

Conclusion

That's it. We installed the SIMH Eclipse emulator. Now you can follow the tutorials on VirtualHub which uses this emulator.

To exit the emulator, type exit and press enter.

Windows

You can download a set of all SIMH emulators from this repository. Extract the archive. Inside, you will find another archive. Extract it. Inside, you will find several executable. Move the file named ECLIPSE.exe to somewhere (if you have added some folder to the PATH environment variable previously, you can move the ECLIPSE.exe file to that folder).

Now add the folder where you moved the ECLIPSE.exe file to the PATH environment variable. To do so, open the Start menu and search for the Edit the system environment variables entry, which opens up a System Properties window. In the Advanced tab, click on the button Environment Variables. There you’ll see User and System variables, which you’ll be able to edit.

In the section entitled User Variables, double-click on the entry that says Path. Another window will pop up showing a list of paths. Click the New button and paste the path to your ECLIPSE.exe executable there. Once that’s inserted, select your newly added path and click the Move Up button until it’s at the top.

That’s it! You may need to reboot your computer for the changes to take effect, but you should now be able to call eclipse from the command line:

To exit the emulator, type exit and press enter.

Documentation

💡

These PDFs may be outdated. You will find the latest version of the documentation (in .doc format) in the doc folder of the git repo you cloned.

Credits

Video tutorial

Do you want to follow the tutorial by watching a video? We will post a video on our youtube channel soon.

Archives of this tutorial are available on Wayback Machine.

Tell us about your experience of this page on Discord. Or, just come and chat with us about old software. Join and say “Hi!”: