SCO UnixWare® 7.1.4+ for VMware®
Getting Started Guide

SCO UnixWare 7.1.4+ also includes all maintenance posted to the web since Maintenance Pack 4 plus additional maintenance as documented in Section 9.5 of the Update Guide available in in the /info directory on the Virtual Appliance CD and at the download site listed below.

SCO UnixWare 7.1.4+ Virtualization Extensions

SCO UnixWare 7.1.4+ is the first release of SCO UnixWare 7.1.4 optimized to run in a VMware Virtual Machine environment. It ships with a package of Virtualization Extensions that facilitate the delivery of the product as a Virtual Appliance. This package provides support for:

VMware Tools

SCO UnixWare 7.1.4+ ships with the April 2011 release of the Open Virtual Machines Tools (open-vm-tools) package. This package adds tools to improve integration between SCO UnixWare 7.1.4+ and the host VMware system.

SCO UnixWare 7.1.4+ Downloads

SCO UnixWare 7.1.4+ is made available as a set of images to download from the Xinuos Support Download Web Site at:

http://www.xinuos.com/support/update/download/product.php?pfid=18&prid=27

• An ISO image of the SCO UnixWare 7.1.4+ Version 1.0.0 Virtual Appliance for VMware
• Getting Started Guide in HTML format for the above
• An ISO image for Updating existing SCO UnixWare 7.1.4 systems of all types
• SCO UnixWare 7.1.4+ Update Guide in HTML format for the above

This Getting Started Guide is for the SCO UnixWare 7.1.4+ Version 1.0.0 Virtual Appliance for VMware.

SCO UnixWare 7.1.4+ for VMware Documentation

The SCO UnixWare 7.1.4+ for VMware documentation includes:

• The SCO UnixWare 7.1.4+ for VMware Getting Started Guide (this document)

This document is available to view at:

http://www.xinuos.com/support/update/download/release.php?rid=439

For additional documentation please see:

• The generic SCO UnixWare 7.1.4 system documentation at:

  http://www.xinuos.com/support/docs/unixware

• The Xinuos Technical Article Knowledge Center at:

  http://www.xinuos.com/ta

Note that the SCO UnixWare 7.1.4+ Virtual Appliance also comes with a pre-built DocView search index for conveniently viewing the system documentation on the installed appliance. If you install either the French or German Language Supplements then you will need to rebuild the search index. For instructions on how to do this please see:

http://uw714doc.xinuos.com/en/Docviewdoc/index.html#d0e215

SCO UnixWare 7.1.4+ Hardware Support

SCO UnixWare 7.1.4+ for VMware runs as a Virtual Machine on top of a supported VMware platform and does not impose any dependencies on the server platform. Please consult VMware for specific hardware requirements and for a list of hardware that is compatible with your VMware product please see:

http://www.vmware.com/resources/compatibility/search.php

SCO UnixWare 7.1.4+ Licenses

SCO UnixWare 7.1.4+ licenses are Subscription Licenses. This means that they are only valid for, and will expire at the end of, the License period. At the end of the License period you will need to renew your license and reregister it if you want to continue to use the product.

Typically, you obtain SCO UnixWare product licenses from your SCO UnixWare software provider. You can locate an SCO UnixWare software provider using the Xinuos Distributor Locator at:

http://www.xinuos.com/partners/dist/

If you need help locating a Xinuos Partner or have any questions relating to the purchasing of licenses you can contact Xinuos directly by choosing the "Sales" category on the feedback form at:

http://www.xinuos.com/company/feedback/index.html

The end user license agreement (EULA) of SCO UnixWare 7.1.4+ for VMware is displayed when importing the Virtual Appliance and is also available to view:

• on the downloadable ISO images in the directory /info/license
• on an already installed system in the directory /etc/license

Before Importing SCO UnixWare 7.1.4+ for VMware

Before you can import SCO UnixWare 7.1.4+ for VMware you will need to ensure that you have:

• Installed and configured a version of VMware on which SCO UnixWare 7.1.4+ is supported
• The SCO UnixWare 7.1.4+ Virtual Appliance Media as an iso image
• A Windows PC installed with either:
  • VMware Infrastructure Client or
  • VMware vSphere Client

Please note that this guide does not cover how to install, configure or use your VMware products. This guide assumes you have a good working knowledge of the VMware product you are importing SCO UnixWare 7.1.4+ into.

VMware System Requirements

SCO UnixWare 7.1.4+ for VMware is an Appliance designed to be imported into specific supported versions of VMware product. Xinuos cannot support customers who attempt to import SCO UnixWare 7.1.4+ into versions of VMware that are not listed as supported.

The VMware System you are importing to will also need to meet certain resource requirements in order to support the installation of SCO UnixWare 7.1.4+. These requirements are discussed below.

VMware System Software Requirements

SCO UnixWare 7.1.4+ Version 1.0.0 for VMware is supported on the following VMware platforms:

• VMware vSphere 5.x
• VMware ESXi 5.x
• VMware vSphere 4.x
• VMware ESXi 4.x
• VMware ESX 4

We recommend that you have the latest VMware Updates applied to your VMware system before importing SCO UnixWare 7.1.4+.

SCO UnixWare 7.1.4+ for VMware is also compatible with the following VMware VirtualCenter services:

• VMotion
• Storage VMotion
• DRS - Dynamic Resource Scheduler
• HA - High Availability

VMware System Resource Requirements

The VMware System you are importing into will need the following in order to successfully run SCO UnixWare 7.1.4+:

• A datastore with at least 12 Gbytes of free disk space to hold the SCO UnixWare 7.1.4+ for VMware virtual machine. Note that additional disk space can be configured for your virtual machine after the import is complete.

• A Virtual Switch that can be used as a virtual Network Card by SCO UnixWare 7.1.4+ for VMware.

• At least 1 Gbytes of free memory. Note that the amount of memory used by your virtual machine can be increased after the import is complete.

Importing an SCO UnixWare 7.1.4+ Appliance into VMware

This section covers how to import SCO UnixWare 7.1.4+ for VMware into a supported VMware platform.

Importing Overview

SCO UnixWare 7.1.4+ for VMware is delivered in the form of a Virtual Appliance that you "import" into your VMware Platform. This documentation assumes that:

• The target VMware system is installed and configured correctly.
• There is enough free disk space (at least 12 Gbytes) on the target VMware system to install the SCO UnixWare 7.1.4+ Virtual Appliance.
• The target VMware system has enough resources (memory and CPU) to run the SCO UnixWare 7.1.4+ Virtual Machine.
• The person importing the SCO UnixWare 7.1.4+ Virtual Appliance has a good working knowledge of VMware products.
• You have already obtained a copy of the SCO UnixWare 7.1.4+ Virtual Appliance for VMware ISO image

Importation of SCO UnixWare 7.1.4+ for VMware will create a Virtual Machine with the following specifications:

	CPUs	1
	Floppy Drives	1
	CD/DVD Drives	1 IDE ATAPI
	Memory	1 Gbyte
	Network Adapter	1 Adapter using the VMware e1000 virtual NIC = e1008g - Intel Pro 1000
	HBA Controller	1 SCSI Controller using the LSI Serial Attached SCSI (SAS)
	Hard Disk	1 Virtual Disk of 11 Gbytes (includes 3 Gbytes of swap)
	Video	SVGA 1024x768x64k colors VMware VESA - VBE 2.0

Additional Memory, CPUs, Floppy and CD/DVD Drives, Network Adapters, a USB controller, and Hard Disks can be added to your Virtual Machine after importation is complete.

Importing Instructions

To import SCO UnixWare 7.1.4+ for VMware into VMware vSphere 5, ESXi 5, vSphere 4.x, ESXi 4.x, or ESX 4:

1. After you have downloaded the Virtual Appliance iso image then either:
1. Burn the iso image onto CD/DVD Media and place in the CD/DVD drive of your Windows PC or
2. Mount the iso image on your Windows PC using a tool like Microsoft Virtual CD-ROM Control Panel
2. Launch the VMware vSphere Client on the Windows PC and login to either:
1. the VMware Server you want to install on or
2. the VMware VirtualCenter/vCenter you are using to manage your VMware server
3. Select File -> Deploy OVF Template

4. On the Source screen
   1. check the Deploy from file: option [4.0 only]
   2. use Browse to locate the SCO UnixWare 7.1.4+ ovf file in the .\VMware\uw714_VA directory of the Install Media
   3. click Next

5. On the OVF Template Details screen
   1. click Next

6. On the End User License Agreement screen
   Read the End User License Agreement
   1. Check the Accept box
   2. click Next

7. On the Name and Location screen
   1. Specify a unique Name for your Virtual Machine
   2. If prompted to, also specify the Inventory Location (VirtualCenter only)
   3. click Next

8. On the Host or Cluster screen (VirtualCenter only)
   1. Select the host or cluster you want to install onto
   2. click Next

9. On the Datastore screen [4.x only] or on the Storage screen [5.0 only]
   1. Select the Datastore to install the Virtual Machine on
   2. click Next

10. On the Disk Format screen [4.1 or 5.0 only]
    1. Select the desired disk provisioning format. Thick Provision Lazy Zeroed is recommended for best performance and is the default for this release.
    2. click Next

11. On the Ready to Complete screen
    1. click Finish

12. A % Deploying window will now be displayed giving you the import status. The time it takes to import the Appliance will depend on the performance of the Windows PC you are importing from and the performance and current workload on the VMware server you are importing to.

13. When the % Deploying window indicates "Deployment Completed Successfully"
    1. click Close

Configuring your Imported SCO UnixWare 7.1.4+ Virtual Machine

The first time you boot your SCO UnixWare 7.1.4+ Virtual Machine after import, you will be prompted for configuration details for your Virtual Machine. This section takes you through:

• Modifying your Virtual Machine configuration
• A configuration checklist that lists the information you will need to configure your system
• The valid license combinations you can use to license your system
• What happens when you boot SCO UnixWare 7.1.4+ for the first time
• Backing up your newly imported Virtual_Machine
• Registering your SCO UnixWare 7.1.4+ system
• Renewing the subscription license of your SCO UnixWare 7.1.4+ system

Modifying your Virtual Machine Configuration

• Add or remove memory
• Add additional CPU(s)
• Configure additional Storage
• Configure additional Network Adapters or select a different Virtual Network Connection
• Enable USB connections if desired or if required by your chosen system backup solution.

Configuration Checklist

Note that this guide assumes you know the IP address, Netmask (Subnet Mask), Gateway IP address and Primary/Secondary Nameserver IP addresses that will be used by your SCO UnixWare 7.1.4+ Virtual Machine. For more information on these parameters please consult your VMware documentation or contact the System Administrator of your VMware Server.

When booting your SCO UnixWare 7.1.4+ Virtual Machine on VMware for the first time you will be asked for the following information:

Keyboard type (e.g. US English)	________________
The Fully Qualified Domain Name (e.g. uw714plus.xinuos.com)	________________
The IP Address your SCO UnixWare 7.1.4+ System will use or DHCP if your system will obtain its IP via DHCP	____.____.____.____
The Netmask or DHCP if your system will obtain its Netmask via DHCP (If you have chosen DHCP for your IP address then DHCP will be automatically entered here)	____.____.____.____
The Gateway IP address or DHCP if your system will obtain its gateway IP via DHCP (If you have chosen DHCP for your IP address then DHCP will be automatically entered here)	____.____.____.____
The Primary Nameserver IP address or DHCP if your system will obtain its Primary Nameserver IP via DHCP (If you have chosen DHCP for your IP address then DHCP will be automatically entered here)	____.____.____.____
The Secondary Nameserver IP address, DHCP if your System will obtain its Secondary Nameserver IP via DHCP or "none" if you do not use a Secondary Nameserver (If you have chosen DHCP for your IP address then DHCP will be automatically entered here)	____.____.____.____
System Locale	_________________
Language Supplement to install (e.g. none, French, German, Spanish, Japanese)	_________________
Owner login, UID, Comment, and password	_________________	******************
Root password	******************
Security Level (low/traditional/improved/high): Choose Low for systems not widely or publicly accessed;Traditional to maintain compatibility with existing UNIX systems; or Improved if you require C2 security. Use High only on highly confidential systems which do not allow remote access (including telnet, rlogin, and ftp).	_________________
Enable/Disable the Graphical Desktop (scologin)	_________________
Timezone (e.g. EST)	_________________

Valid SCO UnixWare 7.1.4+ License Combinations

You will be required to provide one or more licenses when you first boot your SCO UnixWare 7.1.4+ for VMware system.

The following license combinations can be entered during initial configuration:

1. An SCO UnixWare 7.1.4+ Enterprise Edition license

2. An SCO UnixWare 7.1.4+ Base Edition license

3. An SCO UnixWare 7.1.4 Business, Departmental, Enterprise, or Data Center Edition license

   and

   The matching SCO UnixWare 7.1.4+ Business, Departmental, Enterprise, or Data Center Cross-grade license

4. An SCO UnixWare 7.1.4 Base or Small Business Edition license

   and

   An SCO UnixWare 7.1.4+ Base Cross-grade license

5. A fourteen day temporary license for SCO UnixWare 7.1.4+ that is provided with the product.

If you select the fourteen day temporary license, you can license the system later via scoadmin license using one of the above listed license combinations (other than the fourteen day temporary license) or any valid upgrade to a UnixWare 7.1.4 Edition followed by the corresponding Cross-grade license.

Powering on your SCO UnixWare 7.1.4+ Virtual Machine

1. From a Windows PC, launch the VMware Infrastructure Client or VMware vSphere Client

2. Login to the Client

3. In the Inventory view
   1. To start the Virtual Machine
      1. Right click on your SCO UnixWare 7.1.4+ virtual machine
      2. Click on Power On
   2. To open the console of the Virtual Machine
      1. Right click on your SCO UnixWare 7.1.4+ virtual machine
      2. Click on Open Console

On the console you should press <Enter> to boot your Virtual Machine. You are now ready to configure your system.

Booting SCO UnixWare 7.1.4+ for the first time

The first time you boot SCO UnixWare 7.1.4+, the SCO UnixWare 7.1.4+ Configuration Utility (/usr/sbin/guest_conf) will run on the console to take you, step by step, through the process of configuring your system. In this section we will take you through the process describing the ways in which you can respond to the prompts of the Configuration Utility.

1. Click on your SCO UnixWare 7.1.4+ Console so it has keyboard focus

2. On the SCO UnixWare 7.1.4+ Configuration screen
   1. Press <Enter>

3. On the Select Keyboard screen
   1. Choose the keyboard mapping that matches the keyboard of your Windows PC

4. On the SCO UnixWare 7.1.4+ Software License Agreement screen
   1. Display the Agreement
   2. Accept the terms of the Agreement with option 6 to proceed with configuration

5. On the SCO UnixWare 7.1.4+ Subscription and SCO UnixWare 7.1.4 License Use Agreement screen
   1. Choose y to proceed with the configuration of SCO UnixWare 7.1.4+

6. On the SCO UnixWare 7.1.4+ Product Licensing screen
   1. Press <Enter>

7. On the Select your License Scenario screen
   1. Choose the option that matches the License(s) you have
   2. If you choose to enter one or more Licenses
      1. Enter the relevant License Number(s), License Code(s) and License Data
      2. Select License to add the license to the Virtual Machine
      3. Select OK to acknowledge the Message
      4. Press <Enter> to continue configuring your Virtual Machine
   3. If you choose to install the 14 day temporary license provided with the product
      1. Confirm that the license you have selected is correct by choosing y
      2. Press to continue configuring your Virtual Machine

8. On the Virtual Machine Network Info screen
   1. Enter your fully qualified domain name (e.g. uw714plus.xinuos.com)
   2. If you are using a static IP address for your server then
      1. Enter the IP address for your virtual machine
      2. Enter the Netmask for your virtual machine
      3. Enter the Gateway IP address (router) for your virtual machine
      4. Enter the Primary NameServer IP address
      5. Enter the Secondary NameServer IP address (optional)
      6. Confirm that your settings are correct using y
   3. If you want to allocate your server an IP address via DHCP then
      1. At the Please enter the IP address.. prompt type
         1. DHCP
      2. Press <Enter> to continue
      3. Confirm that your settings are correct using y

9. On the System Language (locale) Choice screen
   1. Choose a locale or accept the default

10. On the Optional Language Support screen
    1. Choose what language supplements, if any, to install
    2. If you install supplements press <Enter> to acknowledge the rundig notice

11. On the Owner Account screens
    1. Set a System Owner Account Login
    2. Set a System Owner User ID
    3. Set a System Owner Name
    4. Enter and confirm an Account password when prompted

12. On the Root Password screen
    1. Enter and confirm the root password when prompted

13. On the Security Level screen
    1. Choose the security level for your system

14. On the Graphical login: screen
    1. Choose to enable/disable scologin

15. On the Time zone initialization screen
    1. If your server is in North America respond with y
       1. Choose the number that represents your time zone
       2. Indicate if Daylight Saving Time applies in your location
    2. If your server is outside North America respond with n
       1. Choose y to set your time zone later (recommended) and <Enter> to continue
       2. Choose n to manually set your time zone (only choose this option if you have a good understanding of how to manually set your Timezone)

16. The Configuration Utility will now re-link the kernel and automatically reboot the system

Performing Additional Configuration Steps

After the system reboots, perform any additional configuration steps such as:

• Licensing your system if you chose a temporary license
• Setting the time zone if your server is outside of North America and you deferred time zone selection
• Running rundig to re-index documentation if you installed additional language supplements

Registering your SCO UnixWare 7.1.4+ Virtual Machine

Registration of your SCO UnixWare 7.1.4+ for VMware product is mandatory. If you do not register your product license(s) within 14 days of licensing it then system services will be restricted.

Registering your product provides the following benefits:

• it allows Xinuos to automatically notify you when your license needs to be renewed
• it protects your investment in case of loss of license.

Registering a product is a three-step process:

1. Use the License Manager to obtain the Registration Lock.

2. Visit the SCO UnixWare Registration web page at http://www.xinuos.com/registration to obtain a Registration Key after entering the Registration Lock.

3. Use the License Manager again to enter the Registration Key onto your system.

Installing additional software

If you install the Development System on your Virtual Machine, it is highly recommended that you update your system using the Update CD as described in the Update Guide in order to get the most current versions of the Development System packages.

Backing up your Virtual Machine

Xinuos recommends that you:

• clone or take a snapshot of your Virtual Machine once it has been configured and registered
  • Note that snapshots may affect disk performance.

• make regular backups of your complete system for disaster recovery purposes

Consult your VMware documentation for instructions on cloning or taking a snapshot of your Virtual Machine.

Renewing your SCO UnixWare 7.1.4+ License

You will be notified by email and by warning messages on the Console and in the System Log (/var/adm/syslog) when your SCO UnixWare 7.1.4+ license is about to expire. This notice will also appear when logging in within 14 days or less prior to the expiration date. If you wish to continue to use the product you will need to purchase a renewal license and apply it to the system (ideally before your existing license expires).

To apply the new license to your system:

1. Log into the system as the root user

2. Launch the License Manager using the command:
   scoadmin license

3. Select
   License -> Add a Product or Service License...

4. Enter the License Number, Code and Data of your Renewal License

5. Select License to apply the license to your system

Note that you will also need to register this license within 14 days.

Additional Information, Limitations and Known Problems

Additional Information

For additional information on how to install, configure and manage SCO UnixWare 7.1.4+ for VMware please see:

• Section 4 of the Update Guide in the /info directory on the SCO UnixWare 7.1.4+ Virtual Appliance ISO or at the download site: http://www.xinuos.com/support/update/download/release.php?rid=439

• The Xinuos Virtualization Videos at:

  http://www.xinuos.com/products/unix/virtualization/videos.html

• The Xinuos Knowledge Base of Technical Articles at:

  http://www.xinuos.com/ta

Limitations and Known Problems

SCO UnixWare 7.1.4+ has the following known problems:

1. If you will be using samba on your system it is recommended that you pkgrm netbios, and if not then pkgrm samba.

2. For additional information including:

   • limitations imposed on SCO UnixWare 7.1.4+ when running in Virtual Environment
   • known problems and workarounds relating to SCO UnixWare 7.1.4+
   please see the Xinuos Knowledge Base of Technical Articles for SCO UnixWare 7.1.4+ at:
   http://www.xinuos.com/ta

Xinuos Global Services

• Professional Services and Custom Engineering
• Technical Support
• Self-Help options

Xinuos Global Services offer a variety of support services to complement Xinuos's channel and direct sales efforts. Included among these are partner-specific services and end-user options designed for those end users and corporate accounts requiring direct support from the vendor. With over 25 years of experience and strategically located Support Centers, Xinuos's award-winning Services team possesses knowledge, expertise, and skills enabling it to deliver high quality support to the entire spectrum of our customer base, world-wide.

Xinuos offers a broad choice of Operating Systems and value-added Software Technologies. Xinuos Global Services complement these product deliverables with unrivaled services ensuring successful development, integration, roll out, and on-going maintenance of Xinuos-based solutions. Together, Xinuos and its partners service over 2 million installed systems.

For more information on Xinuos Global Service offerings, contact your Xinuos Sales Account Representative, or:

• in the Americas, phone +1 800-726-6561
• in the rest of the world, phone +44 8700 994 992
• visit http://www.xinuos.com/support/programs

Professional Services and Custom Engineering

Xinuos'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 Xinuos Sales Representative, or:

• in the Americas, phone +1 800-726-6561
• in the rest of the world, phone +44 8700 994 992
• visit http://www.xinuos.com/consulting

Technical Support

Xinuos 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, Xinuos support services are available to partners for their own use and resale.

To find out more about these services, call your Xinuos Sales Account Representative, or:

• in the Americas, phone +1 800-726-6561
• in the rest of the world, phone +44 8700 994 992
• visit http://www.xinuos.com/support/programs

Online Services -- Self-Help Support

http://www.xinuos.com/support/self_help.html