ArcaOS 5.0.x as a VirtualBox 6.x Guest: Difference between revisions

From OS2World.Com Wiki
Jump to navigation Jump to search
 
(16 intermediate revisions by 2 users not shown)
Line 5: Line 5:


==Running ArcaOS as a guest==
==Running ArcaOS as a guest==
You don't require any special driver outside of the ones included on ArcaOS 5.0.x
It will install and run with the drivers ones included on ArcaOS 5.0.x. You can improve some performance of the guest machine installing some different drivers or tuning some of them.


==Drivers under VBox/2==
==Drivers under VBox/2==
{| class="wikitable"
{| class="wikitable"
!Component !! Name !! Driver
!Component !! Name !! Driver
|-
|-
|Audio ||Audio Intel HD<br> ICH AC97<br> SoundBlaster 16 ||Supported with [http://svn.netlabs.org/uniaud/ UNIAUD] driver.<br> SoundBlaster Driver
|Audio ||Intel HD Audio <br> ICH AC97||Included [http://svn.netlabs.org/uniaud/ Uniaud] driver.
|-
|-
|Video ||VESA VBE 2.0 ||VBXGRADD, GENGRADD, Panorama or [http://hobbes.nmsu.edu/h-viewer.php?dir=/pub/os2/system/drivers/video&file=snap-os2-3.1.8.zip SNAP]
|Audio ||SoundBlaster 16||Included SoundBlaster Driver.
|-
|-
|USB ||N/A ||Working. Included ArcaOS USB driver and [[USB Drivers|Lar's USB Drivers]]
|Video ||VESA VBE 2.0 / VBoxVGA||VBXGRADD, GENGRADD, [[Panorama]] or [[SNAP Graphics]]
|-
|-
|Parallel Port ||N/A ||Not Tested
|USB 2.x || ||Working. Included ArcaOS USB driver and [[Netlabs' USB Drivers]]
|-
|-
|Serial Port ||N/A ||Not Tested
|Parallel Port || ||Not Tested
|-
|-
|Networks ||PCNET FASTIII (Am79C973).<br>PCNET PCI II<br>Intel PRO1000MT. ||PCnet-FAST III on ArcaOS Installer<br> [http://hobbes.nmsu.edu/download/pub/os2/system/drivers/network/NICPAK_2007-02-07.zip NICPAK - AMD]
|Serial Port|| ||Not Tested
|-
|-
|Tools and additions pack for OS/2 client ||ISO Additions ||Yes - mouse integration, video and NIC drivers.
|Networks||Intel PRO/1000 MT Desktop (82540EM) <br> Intel PRO/1000 T Server (82543GC) <br> Intel PRO/1000 MT Server (82545EM) ||Included Multimac Network Driver. (MMLEM.OS2)
|-
|Networks||PCNET FASTIII (Am79C973).<br>PCNET PCI II ||Included PCnet-FAST III on ArcaOS Installer<br> [http://hobbes.nmsu.edu/download/pub/os2/system/drivers/network/NICPAK_2007-02-07.zip NICPAK - AMD] (pcntnd.os2)
|-
|Mouse Integration||ISO Additions||Available. VBOXMOUSE.SYS
|-
|Clipboard Integration||ISO Additions||Available.
|-
|Shared Folders || ISO Additions ||Available.
|-
|-
|Shared Folders ||N/A ||Not Supported. [http://www.virtualbox.org/manual/ch14.html]
|}
|}


Line 31: Line 38:
If you select "ICH AC97" as device of the Virtual Machine, it will work with the UNIAUD driver.
If you select "ICH AC97" as device of the Virtual Machine, it will work with the UNIAUD driver.


Using UNIAUD (UNIAUD32.sys - 2.02.04 / 12 Jan 2018 15:44:36) (UNIAUD16.SYS - 1.09.7 / 25 Jun 2017 17:11:40) included on ArcaOS 5.0.3 on you config.sys will look like:
Using UNIAUD (UNIAUD32.sys - 2.02.05 / 16 Nov 2018 22:20:21) (UNIAUD16.SYS - 1.09.7 / 25 Jun 2017 17:11:40) included in ArcaOS on you config.sys will look like:
  DEVICE=C:\MMOS2\UNIAUD32.SYS
  DEVICE=C:\MMOS2\UNIAUD32.SYS
  DEVICE=C:\MMOS2\UNIAUD16.SYS /C
  DEVICE=C:\MMOS2\UNIAUD16.SYS /C
Line 43: Line 50:


==Intel==
==Intel==
For Intel Adapters ArcaOS will select the Multimac driver. (MMLEM.OS2 / 1.01.4 / 26 Nov 2018)
DEVICE=C:\IBMCOM\MACS\MMLEM.OS2
The MMLEM.OS2 (Multimac) will work fine with the three virtual Intel network adapters.
Alternative the E1000.OS2 driver may work too, but it is an older driver.
  DEVICE=C:\IBMCOM\MACS\E1000.OS2
  DEVICE=C:\IBMCOM\MACS\E1000.OS2


Line 49: Line 64:


===VBXGRADD===
===VBXGRADD===
This driver is available on Valery Sedletski OS/2's guest additions files. [ftp://osfree.org/upload/vbox/additions/VBoxAdditions-os2-x86-5.0.51.r179.zip]
This driver is available on Valery Sedletski OS/2's guest additions files. [ftp://osfree.org/upload/vbox/additions/VBoxAdditions-os2-x86-5.0.51.r218.zip]


====Installation====
Copy the vbxgradd.dll file to the C:\OS2\DLL folder.  
Copy the vbxgradd.dll file to the C:\OS2\DLL folder.  


Line 60: Line 76:


Now you can reboot and test the video.
Now you can reboot and test the video.
====Getting Higher/Custom Resolutions====
Sometimes you need to configure the guest machine (from the host OS) to get a custom resolution. You can do that from the command prompt of the host.
This is a Windows 10 host example, with the VM turned off execute:
"C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" setextradata "ArcaOS 5.0.3" "CustomVideoMode1" "1920x1080x32"
After that boot the guest ArcaOS machine and you can see the resolution on the "System Setup - Screen"
[[image:VBoxScreen.png|400px]]


===Panorama===
===Panorama===
Line 114: Line 140:
  REM DEVICE=C:\OS2\BOOT\AMOUSE.SYS
  REM DEVICE=C:\OS2\BOOT\AMOUSE.SYS
  DEVICE=C:\PROGRAMS\VBOX\VBOXMOUSE.SYS
  DEVICE=C:\PROGRAMS\VBOX\VBOXMOUSE.SYS
==Shared Folders==
Some testing with shared folders had been documented at [[VirtualBox IFS - Sharing Folders]].


==Documentation==
==Documentation==
Line 155: Line 184:
==Links==
==Links==
* [http://www.os2world.com/oldforum/index.php?topic=5066.msg24134#msg24134 Discussion about eComStation as Guest and Screen Resolutions]
* [http://www.os2world.com/oldforum/index.php?topic=5066.msg24134#msg24134 Discussion about eComStation as Guest and Screen Resolutions]
* [https://www.arcanoae.com/wiki/arcaos/installation-planning/virtual-machine-configuration/oracle-vm-virtualbox/ Arca Noae: Oracle VM VirtualBox]


[[Category:Virtual Machines]]
[[Category:Virtual Machines]]

Latest revision as of 14:39, 11 April 2021

What is VirtualBox

VirtualBox is an x86 virtualization software package, originally created by German software company InnoTek, now developed by Oracle as part of its xVM virtualization platform. It is installed on an existing host operating system as an application. Within this application, additional operating systems, each known as a Guest OS, can be loaded and run, each with its own virtual environment.

Homepage Link: http://www.virtualbox.org/

Running ArcaOS as a guest

It will install and run with the drivers ones included on ArcaOS 5.0.x. You can improve some performance of the guest machine installing some different drivers or tuning some of them.

Drivers under VBox/2

Component Name Driver
Audio Intel HD Audio
ICH AC97
Included Uniaud driver.
Audio SoundBlaster 16 Included SoundBlaster Driver.
Video VESA VBE 2.0 / VBoxVGA VBXGRADD, GENGRADD, Panorama or SNAP Graphics
USB 2.x Working. Included ArcaOS USB driver and Netlabs' USB Drivers
Parallel Port Not Tested
Serial Port Not Tested
Networks Intel PRO/1000 MT Desktop (82540EM)
Intel PRO/1000 T Server (82543GC)
Intel PRO/1000 MT Server (82545EM)
Included Multimac Network Driver. (MMLEM.OS2)
Networks PCNET FASTIII (Am79C973).
PCNET PCI II
Included PCnet-FAST III on ArcaOS Installer
NICPAK - AMD (pcntnd.os2)
Mouse Integration ISO Additions Available. VBOXMOUSE.SYS
Clipboard Integration ISO Additions Available.
Shared Folders ISO Additions Available.

Audio

If you select "ICH AC97" as device of the Virtual Machine, it will work with the UNIAUD driver.

Using UNIAUD (UNIAUD32.sys - 2.02.05 / 16 Nov 2018 22:20:21) (UNIAUD16.SYS - 1.09.7 / 25 Jun 2017 17:11:40) included in ArcaOS on you config.sys will look like:

DEVICE=C:\MMOS2\UNIAUD32.SYS
DEVICE=C:\MMOS2\UNIAUD16.SYS /C

Network Adapter

PCnet-FAST III

For the PCnet-FAST III you need to install the "AMD PCNet Ethernet Family Adapter" that is included on ArcaOS.

Your config.sys will include this:

DEVICE=C:\IBMCOM\MACS\PCNTND.OS2

Intel

For Intel Adapters ArcaOS will select the Multimac driver. (MMLEM.OS2 / 1.01.4 / 26 Nov 2018)

DEVICE=C:\IBMCOM\MACS\MMLEM.OS2

The MMLEM.OS2 (Multimac) will work fine with the three virtual Intel network adapters.

Alternative the E1000.OS2 driver may work too, but it is an older driver.

DEVICE=C:\IBMCOM\MACS\E1000.OS2

Video

It had been reported that GENGRADD, VBOXGRADD, SNAP and Panorama drivers may work on the guest virtual machine. But SNAP and Panorama are not really necessary and may be generating some little overhead according to some opinions. So it may be recommended to use GENGRADD or VBOXGRADD.

VBXGRADD

This driver is available on Valery Sedletski OS/2's guest additions files. [1]

Installation

Copy the vbxgradd.dll file to the C:\OS2\DLL folder.

Add the following on the config.sys

set gradd_chains=c1
set c1=vbxgradd

Check that you have REM out any other "set c1=" or "set greext=sddgrext" from the config.sys.

Now you can reboot and test the video.

Getting Higher/Custom Resolutions

Sometimes you need to configure the guest machine (from the host OS) to get a custom resolution. You can do that from the command prompt of the host.

This is a Windows 10 host example, with the VM turned off execute:

"C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" setextradata "ArcaOS 5.0.3" "CustomVideoMode1" "1920x1080x32"

After that boot the guest ArcaOS machine and you can see the resolution on the "System Setup - Screen"

Panorama

Pending: Finding out to set HD resolution.

SNAP

Using the SNAP drivers you can get a custom resolution.

From the host machine you can add a custom resolution support to the guest OS with the following command:

VBoxManage setextradata "<name of the VM>" "CustomVideoMode1" "1366x768x32"

Example:

vboxmanage setextradata "ArcaOS 5.0" "CustomVideoMode1" "1366x768x32"

You will get no confirmation from this command code.

Turn on the guest OS/2 or ArcaOS and on the /SNAP/ directory run:

gamode add 1366 768 32

This will add the new resolution on the ArcaOS Screen Resolution options. Access the settings page for resolution and select the new one.

USB

USB virtual ports are working on the platform.

Here it is some sample on the parameters on config.sys for USB:

BASEDEV=USBOHCD.SYS
BASEDEV=USBEHCD.SYS

Diskette

The diskette integration is very easy too:

On the settings of the Virtual Machine on "Storage" you can add the diskette drive.

Now you can select the Diskette image. The IMA format is supported.

You can use a Windows program called "WinImage" to generate your own IMA Diskettes imaged.

Shared Clipboard

The shared clipboard integration is working. It has been tested with Windows 10 as host and ArcaOS 5.0.3 as guest. You can copy+paste text from Windows or ArcaOS without problems after installing the OS/2 Guest Add-ons.

Be sure to enable the shared clipboard (bidirectional) on the virtual machine.

Mouse Integration

Mouse integration also works. It had been tested with Windows 10 as host and ArcaOS 5.0.3 as guest using OS/2 Guest Add-ons.

If you are running ArcaOS guest on a window, you don't have to disconnect the mouse with "Ctrl Right" to control the host OS.

VBOXMOUSE.SYS will replace AMOUSE.SYS and your config.sys will look like this:

REM DEVICE=C:\OS2\BOOT\AMOUSE.SYS
DEVICE=C:\PROGRAMS\VBOX\VBOXMOUSE.SYS

Shared Folders

Some testing with shared folders had been documented at VirtualBox IFS - Sharing Folders.

Documentation

Documentation is available on the VirtualBox site to install several Guest OS's: http://www.virtualbox.org/wiki/Guest_OSes

According to the VirtualBox Documentation, OS/2 MCP2 was reported to be stable but it requires VT-x hardware virtualization support. That means that your computer has to be modern enough to have that feature.

FAQ / Troubleshooting

A: Check that your computer has the VT-X mode enabled. Or check that VT-x hardware virtualization is turned on in your computer's BIOS.

Q:What "network adapter" to use in VirtualBox OS/2 Guest?

Reply by Lars Erdmann:

I am running under a Windows host but I would hope the answer will be the same:

1) Use "Intel PRO/1000 MT Server". The equivalent driver in OS/2 is E1000.OS2 ("Intel(R) PRO/1000 Network Connection").

If you use DHCP in your OS/2 guest and have problems with it (you do not get assigned an IP address), then modify your \IBMCOM\PROTOCOL.INI file and add the following to the [E1000_nif] section:

TRANSMITBUFFERS = 20
RECEIVEBUFFERS = 20

Note that you'll have to do this manually as these parameters are undocumented and not offered though the E1000.NIF file. You'll also have to redo this every time you let the network config tool change your PROTOCOL.INI.

2) If that still fails, then use "PCnet-FAST III (Am79C973)".

The equivalent driver in OS/2 should be PCNTND.OS2 ("AMD PCNet Ethernet Family Adapter"). Maybe you will have to pick "PCnet-PCI II (Am79C970A)" in VirtualBox instead. In any case, the OS/2 driver will be the same.

Recommended Commands on VirtualBox

Changing the UUID of Virtual HDD

Sometimes you want to duplicate your Virtual HDD and move them to other Virtual machines. You may get an error that the VHDD UUID is already used and it can not be assigned to other VM.

I recommends this command to fix remove the UUID of the Virtual HDD image:

For example:

"C:\Program Files\Oracle\VirtualBox\VBoxManage.exe" internalcommands sethduuid "D:\VM\VirtualBox\ArcaOS 5.0.3\ArcaOS 5.0.3.vdi"

Links