Munich University of Applied Sciences MS/SD Laboratories

W. Tasin, M.Sc.
Dept. Electrical Engineering and
Information Technology Version 1.40
Sect. Technical IT Seite 1/11

http://lsw.ee.hm.edu/wiki/en_OS9_x86_Install
http://lsw.ee.hm.edu/wiki/en_OS9_x86_Install

Summary
1. OS 9/x86 Running on QEmu
1. Download the package
2. Installation and first start
3. Testing w/o Hawk
4. Installation of the TAP device
1. Rename the connection
2. Setup the IP address
5. Check the installation
2. Uninstall
1. Remove the TAP devices
2. Delete the directory 'OS9000 on QEmu-with-XiBase9 (en)'
3. Guest OS
4. Resources

1. OS 9/x86 Running on QEmu

Klicken Sie hier fr die deutsche Anleitung.

This document describes how to install a virtual machine with OS 9/x86 operating
system on a PC.
The prerequisite is a installation package which creation is described here (German).

Download the package

An already created installation package can be obtained here:

OS9000_v49_on_QEmu-
OS9000_v49_on_QEmu-with-
with-XiBase9_en.zip
http://lsw.ee.hm.edu/%7Etasin/qemu-
http://lsw.ee.hm.edu/%7Etasin/qemu-and-
and-os9000/OS9000_on_QEmu-
os9000/OS9000_on_QEmu-with-
with-XiBase9_en.zip
You also find a usable virtual hard disc image (60 MB) with OS 9/x86 in this package.

Installation
Installation and first start
Munich University of Applied Sciences MS/SD Laboratories
W. Tasin, M.Sc.
Dept. Electrical Engineering and
Information Technology Version 1.40
Sect. Technical IT Seite 2/11

Unzip the package to your local hard disc. So the primary installation is already done.
Starting the batch file OS9000.bat inside the created directory can be already used to
start the virtual OS 9/x86 machine in mode For Testing w/o Hawk (choice no. 2).
Munich University of Applied Sciences MS/SD Laboratories
W. Tasin, M.Sc.
Dept. Electrical Engineering and
Information Technology Version 1.40
Sect. Technical IT Seite 3/11

HINT: It is possible that the firewall of your host system shows up a dialog.
It would ask you if the network access by qemu.exe still had to be blocked. In this
case please select the option to never block the network traffic from qemu.exe.
qemu.exe
The virtual machine should appear in an extra windows:

HINT: Clicking inside the OS9/x86 window, will capture the mouse pointer ... It can
be released by pressing the key combination Ctrl-
Ctrl-Alt.
Alt
HINT: There is no command to reboot or shutdown the system! Simply close the
window of the guest system (OS9/x86 system).

Testing w/o Hawk

In this mode the OS9/x86 virtual machine is hidden behind a QEmu-build-in firewall.
But this means a big disadvantage. The virtual machine has the possibility to initiate
connections to the internet, but the host system (= development system) can't access
the virtual machine.
To resolve this problem, you have to continue the installation with the next chapter.

Installation of the TAP device

Munich University of Applied Sciences MS/SD Laboratories
W. Tasin, M.Sc.
Dept. Electrical Engineering and
Information Technology Version 1.40
Sect. Technical IT Seite 4/11

The TAP device is necessary to make it possible that the host system (=
development system) can access the guest system (= target system).
This is necessary to upload a developed module with the Hawk-IDE to the virtual OS
9/x86 machine.
HINT: The following part of the installation has to be done with administrator
privileges, because a pseudo network device has to be added to the host system.
Open the subdirectory OpenVPN-
OpenVPN-TAP-
TAP-Device in your package folder:

Start the batch file addtap.bat.

addtap.bat
Now the pseudo network device will be installed. You only have to select Continue
Anyway in the following dialog:
Munich University of Applied Sciences MS/SD Laboratories
W. Tasin, M.Sc.
Dept. Electrical Engineering and
Information Technology Version 1.40
Sect. Technical IT Seite 5/11

After that you have to close the command prompt of addtap.bat by pressing a key.
Munich University of Applied Sciences MS/SD Laboratories
W. Tasin, M.Sc.
Dept. Electrical Engineering and
Information Technology Version 1.40
Sect. Technical IT Seite 6/11

Rename the connection

Now you have to rename the device, because this qemu installation expects the
name tap0.
tap0
Open the dialog Network Connections inside the Control Panel:
Panel

Click with the right button at the newly created network connection and select
Rename.
Rename
HINT: You should use the network connection, which is attached to the device TAP-
TAP-
Win32 Adapter V9
V9. Another way to select the correct connection is to use the
connection name with the actual highest number.
Munich University of Applied Sciences MS/SD Laboratories
W. Tasin, M.Sc.
Dept. Electrical Engineering and
Information Technology Version 1.40
Sect. Technical IT Seite 7/11

Enter the name tap0 for this connection.

Setup the IP address

Next you have to setup the IP address for this connection to 10.0.2.2.
10.0.2.2
Select Properties in the popup menu.

In this dialog double click at Internet Protocol (TCP/IP):

(TCP/IP)
Munich University of Applied Sciences MS/SD Laboratories
W. Tasin, M.Sc.
Dept. Electrical Engineering and
Information Technology Version 1.40
Sect. Technical IT Seite 8/11

now setup the property values like you can see in the following image.
Munich University of Applied Sciences MS/SD Laboratories
W. Tasin, M.Sc.
Dept. Electrical Engineering and
Information Technology Version 1.40
Sect. Technical IT Seite 9/11

Close all opened dialogs with OK or Close.

Close
At this point you have finished the installation of the necessary network connection
for the virtual machine.
This interface allows the host system (IP: 10.0.2.2) to connect to the virtual machine
(IP: 10.0.2.14).

Check the installation

installation

Start again the virtual OS-9 system with the batch file OS9000.bat.
OS9000.bat
Now select the choice 1 (HAWK-developing)
After the OS9/x86 system has started, please open a Command Prompt from your
host system and enter the following command:
Microsoft Windows XP [Version 5.1.2600]
(C) Copyright 1985-2001 Microsoft Corp.

C:\Documents and Settings\wt> telnet 10.0.2.14

The follow screen should appear:

You can log into the guest system with the already existing user super and the
password user.
user
HINT: Don't start more than one instance of the virtual system, because all of them
would use the same hard disc image.
Munich University of Applied Sciences MS/SD Laboratories
W. Tasin, M.Sc.
Dept. Electrical Engineering and
Information Technology Version 1.40
Sect. Technical IT Seite 10/11

2. Uninstall

To remove the OS9000 system completely from your PC, you have to follow only
these 2 steps:

Remove the TAP devices

Call the batch file deltapall.bat

deltapall.bat in the OpenVPN-
OpenVPN-TAP-
TAP-Device subdirectory.
HINT: With this batch file all of the installed TAP pseudo network devices will be
removed.

Delete the directory 'OS9000 on QEmu-

QEmu-with-
with-XiBase9 (en)'

To complete the uninstall process, you simply have to delete the OS9000 on QEmu-
QEmu-
with-
with-XiBase9 (en) folder from your local hard disc.

3. Guest OS

The version of OS/9 in this package is version 4.9.

Actually the following special settings are made:
Ticks per second: 1000
System-state environments variables:
o DBGLOG_OPS=tmp
o DBGLOG_RDY=80

4. Resources

Munich University of Applied Sciences - FK 04 (http://www.ee.hm.edu/)

RadiSys (http://www.radisys.com/)
QEmu on Windows (http://www.h7.dion.ne.jp/%7Eqemu-win/)
QEmu on Windows - Download (http://www1.interq.or.jp/%7Et-takeda/qemu/)
OpenVPN (http://openvpn.net/)
Munich University of Applied Sciences MS/SD Laboratories
W. Tasin, M.Sc.
Dept. Electrical Engineering and
Information Technology Version 1.40
Sect. Technical IT Seite 11/11

TUN/TAP with QEmu (http://kidsquid.com/cgi-bin/moin.cgi/QemuAndTuntap)