The SCO Group provides this program and licenses its use to you, the licensee, pursuant to the following terms.
LICENSE
You, the LICENSEE, have the non-exclusive right to use the software and its documentation. You may only use the software on Versions of UnixWare 7 and SCO OpenServer 6 for which you have purchased a license for its use. This software is subject to all the terms and conditions of the SOFTWARE LICENSE AGREEMENT for the SCO Operating System on which this software is installed. EXCEPT AS PERMITTED BY YOUR SOFTWARE AGREEMENT; YOU MAY NOT DUPLICATE THE PROGRAM OR DISCLOSE IT TO ANY OTHER PARTY.
Use of Microsoft® Windows®: SCO does not supply a license for the use of Microsoft Windows. You are required to have a Microsoft Windows license and access to Microsoft Windows installation media to use the MergePRO Software.
After installing MergePRO and a supported version of Microsoft Windows, you are ready to install your favorite Windows applications. You can then run SCO UNIX and Windows applications at the same time - no need to dual boot or create separate disk partitions.
MergePRO provides a fast and stable way to run the Windows operating system and Windows applications in your SCO UNIX environment. With MergePRO you can avoid many Windows corruption problems and recover quickly from Windows errors. The result is a system that is easy to use, with low overhead and good performance.
Maintenance Packs include MergePRO-related fixes, so be sure to install the latest available pack.
NOTE: At least 10GB of free disk space is strongly recommended.
The term Guest refers to the guest operating system, or Windows. The term Host refers to the host operating system, or SCO UNIX.
fsadm -o largefiles /Next, you must increase the values for several kernel parameters:
/etc/conf/bin/idtune -f SFSZLIM 0x7FFFFFFFFinally, you must relink the kernel and reboot:
/etc/conf/bin/idtune -f HFSZLIM 0x7FFFFFFF
/etc/conf/bin/idtune -f HDATLIM 0x7FFFFFFF
/etc/conf/bin/idtune -f SDATLIM 0x7FFFFFFF
/etc/conf/bin/idtune -f SVMMLIM 0x7FFFFFFF
/etc/conf/bin/idtune -f HVMMLIM 0x7FFFFFFF
/etc/conf/bin/idbuild -B && init 6
NOTE: Disk images larger than 4GB use the NTFS filesystem (instead of FAT32), which can affect MergePRO performance. Guest images as large as 8GB have been tested without noticable performance degradation, but depending on your configuration, your results may vary.
To install MergePRO, log in as the root user, and use the following command:
cat MergePro-*.stream | pkgadd -d -
To remove MergePRO from your system, log in as root, and use the following command:
pkgrm MergeProNOTE: Ensure there are no MergePRO sessions currently running before removing the MergePRO package.
NOTE: Removing the MergePRO package does not remove any installed guest Windows session(s) on your system, nor any loaded Windows media in /usr/mergepro/cdroms. It only removes the actual MergePRO program components from /usr/lib/mergepro.
To update to a new version of MergePRO, first remove the existing MergePRO package, then install the new version as explained above. For best results, it is recommended that you first backup any existing guest Windows sessions you may have installed on your system before performing a MergePRO software update. Please see Backing up a Guest Session for information on how to do this.
There is no need to reboot your system after installing, removing, or updating the MergePRO package.
Only one MergePRO session is recommended and supported;
concurrent sessions are not supported.
MergePro requires a license key for permanent
installation. If licensing is deferred, MergePRO will use a
temporary 60 day evaluation license.
To load the guest media, login as root, insert the media in the CDROM driver, and use the following command:
loadwinproCD [-r] [<device>] The -r is optional, and tells loadwinproCD to reload the media if it is already loaded on the system. The device is also optional, and tells loadwinproCD to use either a specified physical device or ISO 9660 image file (with full pathname) instead of the default CDROM device.
To install a guest session, login as a non-root user and use the following command:
installwinpro [-d <configuration>] [-w <windows-version>] [-g <guest-image-size>] [-m <guest-install-mode>]
configuration defaults to winpro if it is not specified. installwinpro will place all installation files and guest images in the directory ${HOME}/configuration.
If you have only one version of Windows loaded on the system, you do not need to specify -w. If you have more than one version and you do not specify -w, installwinpro will pick the first one for you automatically, but will give you time to cancel. Windows versions are currently specified as follows:
win2kpro (for Windows 2000 Professional)
winxppro (for Windows XP Professional)
winxphome (for Windows XP Home Edition)
guest-image-size defaults to "2038M", or just under 2 gigabytes. You may specify a size up to 64 gigabytes, which will be used to hold the Windows session's system and program files (C: drive). User Documents and Settings are stored directly on the UNIX filesystem and the storage size is limited only by the available disk space in your user home directory. When specifying guest-image-size values, you may use a number followed either by K for kilobytes, M for megabytes, or G for gigabytes. For example, to specify the maximum size of 64 gigabytes, use the value 64G for the -g parameter of installwinpro
guest-install-mode specifies how the guest Windows installation will be configured and where files will be placed. The following modes are supported:
NOTE: It is strongly recommended that you backup your guest session installation once the installwinpro command completes. Please see Backing up a Guest Session for information on how to do this. You should also practice frequent backups to avoid having to reinstall Windows in order to fix Windows corruption later. Note that Windows sessions may degrade or corrupt over long periods of time from normal everyday use, or from viruses/"malware"/"spyware", etc. Also note that performance degradation and/or corruption is not unique to MergePRO - it happens normally on native Windows installations as well.
guest-install-mode Description image the most basic mode; all Windows files, including user documents and settings, are placed in the guest image file, GUEST.IMG. In image mode, you can still access your SCO UNIX home directory via the "HOME on Host" desktop link, or via the directory path \\HOST\\HOME from Windows.
shared this mode places all Windows files, except user My Documents folders, in the guest image file, GUEST.IMG. This mode provides the best combination of performance and usability, and is ideal for Windows XP. Important documents are placed on the UNIX filesystem, but Windows keeps all its other files organized the way it is designed to. In this mode you can share your documents with other SCO UNIX applications, but run Windows applications and system functions with maximum fidelity. NOTE: shared mode is the default for new Windows XP installations on MergePRO.
integrated this mode makes the Administrator/Owner user account on Windows live as a "roaming profile", so that user settings (as well as documents) are stored on the UNIX filesystem instead of inside the GUEST.IMG image file. This is the default mode for new Windows 2000 installations. NOTE: To ensure the best possible user experience, do not select integrated mode for Windows XP.
For more information on how MergePRO guest session installations are organized on the UNIX filesystem, please see Location of Files and Documents.
winpro [<options>] [<configuration>]options:
-h, -help Displays help on all currently available options -cdrom <path> Specifies a CDROM device or image file to attach to the session's 2nd virtual CDROM device; in this mode, the CDROM device/image is locked for the entire session. none disables CDROM access completely. -snapshot Enables "snapshot" mode, which prevents changes to the guest session's "C:" drive from being committed to the disk image file; this is useful to prevent unwanted changes to your Windows installation (i.e. viruses, "malware", "spyware", etc.) once you have configured your applications as desired. Note that in this mode, anything saved to the guest session's "C:" drive will be lost once you exit the session. Unless you specified image mode when you installed the session (using installwinpro), your documents will be automatically saved to your UNIX filesystem. Additionally, in integrated mode, your user settings will also be preserved even if you use the -snapshot argument. For more information on installation modes, please see the section Guest Session Installation. For more information on where files are stored, please see the section Location of Files and Documents -mute Runs the session with audio muted configuration defaults to winpro if not specified.
NOTE: <options> must precede <configuration> on the winpro command line.
To exit a Guest Session, always use the Start->Shutdown function from within Windows. DO NOT use the kill command from the shell or you will lose and/or corrupt data in your guest session. If the session is not responding, DO NOT use kill -9 unless there is no other option. Expect to lose recent settings and data in your guest session if you stop the session in any other way than with Start->Shutdown from within Windows. The name of the main MergePRO process which runs a Guest Session is mergepro-core.
cd $HOME/winpro
cp GUEST.IMG GUEST.IMG.backup
To restore a guest session from backup:
cd $HOME/winpro
cp GUEST.IMG.backup GUEST.IMG
Additionally on Windows XP, there will appear to be a delay of several seconds where a blank screen is shown just after the status dialog "Windows is starting up..." is shown. During this time, Windows will continue to boot, but will not show any additional status for several seconds. This is by design on MergePRO, and is necessary so that Windows can integrate with the host components before attempting to log in users. Typically this delay will last several seconds.
NOTE: It is especially important that you log off or restart after the initial login of Administrator, if you plan on installing Windows updates right away. Otherwise installing the updates may take much longer than usual.
The default value for KHZ is 1000, better results are often obtained with a value of 500. The full range is 100, 200, 500, 1000 or 2000. Changing this value will require a reboot.
Add the following to /stand/boot:
KHZ=500You can also interrupt the boot at the splash screen by pressing any key and typing in the same thing.
To avoid this problem, either ensure a CD is always in the drive or start the Guest session with the -cdrom none option.
$ ls $HOME/winproIn addition to the operating system image (GUEST.IMG), there is a directory called Documents and Settings, as well as a settings file called settings.local. The Documents and Settings directory and its use from within the guest session will be explained shortly. The settings.local file contains important settings specific to your session, such as the version of Windows it is based on, etc. Please see Settings up MergePRO for information on local settings, as well as the product Release Notes for the most up to date information.
Documents and Settings GUEST.IMG settings.local
$ ls "$HOME/winpro/Documents and Settings"Note that the files in these directories may appear to have strange permissions on the UNIX filesystem. This is by design, since Windows file permissions do not relate to UNIX file permissions in a very clear way. Therefore it is advised that users do not modify files in these directories from UNIX unless absolutely necessary. If files in these directories are modified, it is very important that their exact permissions are preserved.
Administrator All Users Default User
This directory will only store relevant information if you select (or use as default) the integrated installation mode when running installwinpro. Otherwise, the Windows user "profiles" are stored inside the GUEST.IMG file.
IMPORTANT NOTE!!!! If deleting users on Windows XP, it is very important that this be done with the Computer Management console under Administrative Tools in the Control Panel. Do not use the Users and Groups functionality in the Control Panel to delete user accounts, as this has the potential to erase your UNIX documents as well.
This directory is not used if you select the image install mode when running installwinpro.
$ ln -s /tmp $HOME/tmpWindows will now be able to access the UNIX /tmp directory as \\HOST\HOME\tmp. Note that normal UNIX file permissions apply to Windows as well, so in order for Windows to store files in such directories, the SCO UNIX user it is running as must have access to write to these directories.
NOTE: The drive letters F:, G:, and H: should not be mapped as they will be used by future versions of MergePRO.
In order to ensure proper operation under Windows, it is very important that the network settings ARE NOT modified. Modifications made to the network settings may cause complete failure to access the Internet, and even failure to login to Windows or access user files. Please do not modify these settings.
There are currently several restrictions to networking from MergePRO guest Windows sessions:
Multimedia playback can be affected by SCO UNIX and Windows system load. For optimal performance, do not run multimedia applications on an otherwise busy system.
MRGPRO_AUDIO_PLAY_DEVThese variables can be set just like other UNIX environment variables, for example:
MRGPRO_AUDIO_REC_DEV
MRGPRO_AUDIO_PLAY_DEV=/dev/dsp0
export MRGPRO_AUDIO_PLAY_DEV
NOTE: The volume controls on Windows Media Player should control audio functions without problems.
MRGPRO_DISABLE_AUDIO="yes"; export MRGPRO_DISABLE_AUDIOThe above example will start the default guest Windows configuration with audio disabled. Note that disabling audio also shortens the time it takes Windows to boot by up to several seconds.
winpro
This variable may also be added to /etc/default/mergepro to apply to all sessions, or to the settings.local file in the directory of each configuration. The default configuration's directory is $HOME/winpro.
MRGPRO_WINDOWS_RAMSIZE=64; export MRGPRO_WINDOWS_RAMSIZEThis variable may also be added to /etc/default/mergepro to apply to all sessions, or to the settings.local file in the directory of each configuration. The default configuration's directory is $HOME/winpro.
winpro
NOTE: Making more physical RAM available to Windows does not necessarily increase performance for Windows applications. In fact, it can sometimes degrade performance if SCO UNIX does not have enough memory left for running other processes and caching disk I/O. Set this value based on the amount of memory required by the applications you intend to run on Windows, not necessarily the absolute maximum. The minimum recommended amount of physical RAM assigned to Windows is 128 megabytes for Windows XP, and 64 megabytes for Windows 2000. The amount of memory assigned to MergePRO should never exceed 1/3 of the physical RAM installed in the system.
NOTES:
| MRGPRO_WINDOW_POS Setting | Description |
| "center" | Keeps the guest window centered on the screen at all times |
| "full" | Sets "full screen" mode, pinning the window to the top-left corner of the screen and using all available screen size for the window. NOTE: DO NOT use this mode if you are using a desktop environment or window manager; see the MRGPRO_WINDOW_SIZE "maximized" setting below if you want to run on top of a desktop environment or window manager with the highest supported guest window size. |
| "<x-coordinate>x<y-coordinate>" | Pins the window at the fixed position <x-coordinate>,
<y-coordinate> on the screen. The origin,
or top-left corner of the screen is the position "0x0". For example, to
pin the window to Special |
| MRGPRO_WINDOW_SIZE Setting | Description |
| "maximized" | Sets the size of the window to the highest supported guest resolution, while still leaving room for your desktop environment. For example, if your desktop resolution is 1280x1024, the window size will be set to 1024x768, which is the highest supported guest resolution lower than 1280x1024. |
| "<width>x<height>" | Sets the fixed size of the window to the specified <width> pixels wide, by <height> pixels high. For example, to set the window to 1024 pixels wide by 768 pixels high, use the value "1024x768" |
IMPORTANT NOTE: values for MRGPRO_WINDOW_POS and MRGPRO_WINDOW_SIZE are case sensitive.
SCO offers a wide array of technical support services ranging from business critical, 24x7 after-hours offerings to traditional support services covering all products and customer types from partners to end users. In addition, SCO support services are available to partners for their own use and resale.
SCO TEAM Support is designed for corporate customers requiring immediate, high-level, technical support. Included with TEAM, your company is assigned a senior technical account manager, who is responsible for assuring successful solution implementation and ongoing support for your SCO systems.
SCO SoftTech Plus includes support for unlimited licenses and installations covering all SCO products, with a guaranteed one-hour response time. This service is targeted at SCO partners and customers who need coverage for all SCO products. With SoftTech Plus, you also have an assigned administrative account manager as your primary contact for administrative issues.
SCO SoftTech includes support for unlimited licenses and installations with a guaranteed up to one-hour response time. SoftTech is available per operating system/product, allowing you the flexibility to add on additional products and services when you need them. Your administrative account manager provides a single point of contact for your administrative issues.
If you have purchased a product that contains bundled support, refer to your Certificate of License and Authenticity (COLA) for verification. The COLA includes instructions for product and support registration. For additional details, go to: http://www.sco.com/support/programs
SCO's Professional Services offer a full suite of consulting services ranging from server deployment and management, migration and web services to customized solutions. For more information on Professional Services, call your SCO sales representative, or:
· in the Americas, phone 800-366-8649
· in the rest of the world, phone +44 8700 994 992
· visit http://www.sco.com/consulting
SCO also provides extensive 24x7 self-help technical support services on SCO products, including installation and configuration support through an easy-to-use, single Web view. The self-help Web site is located at: www.sco.com/support/self_help.html.