\documentclass{ictlab}

% Copyright (c) 2003 by Nick Urbanik <nicku(at)nicku.org>.
% This material may be distributed only subject to the terms and
% conditions set forth in the Open Publication License, v1.0 or later
% (the latest version is presently available at
% http://www.opencontent.org/openpub/).

\RCS $Revision: 1.2 $

\usepackage{verbatim,alltt}
\ifx\pdftexversion\undefined \else
  \usepackage[pdfpagemode=None,pdfauthor={Nick Urbanik}]{hyperref}
\fi

\newcommand*{\labTitle}{Installing Windows in VMware on Linux}

\begin{document}


\subsection*{Background:}

VMware is commercial software from VMware Inc\@.  You can download the
software from \url{http://www.VMware.com/}.  You can apply for an
evaluation licence that lasts 30 days, or buy a student licence for
US\,\$99. Our department has purchased licences for use in twenty-one
computers, for version 2.0.x, with Linux as the host operating system.

\subsection*{Procedure:}

\paragraph{Install the licence:}

\begin{enumerate}
\item Obtain a VMware licence, which is a small text file

\item Create a directory \texttt{.vmware} in your home directory:
\begin{verbatim}
$ cd
$ mkdir .vmware
\end{verbatim}

\item Put your licence file in that directory, with a file name that begins
  with \texttt{license}
\end{enumerate}

\paragraph{Install the RPM package:}

\begin{enumerate}
\item Obtain a VMware licence, which is a small text file
\item Mount \texttt{ictlab\allowbreak.tyict\allowbreak
    .vtc\allowbreak.edu\allowbreak.hk\allowbreak:/var\allowbreak
    /ftp\allowbreak/pub} on some directory on your computer (say
  \texttt{/mnt/ftp}):
\begin{verbatim}
$ sudo mount nicku.org:/var/ftp/pub /mnt/ftp
\end{verbatim}%$

\item Change to the \texttt{vmware} directory:
\begin{verbatim}
$ cd /mnt/ftp/vmware
\end{verbatim}%$

\item Install the VMware RPM package:
\begin{verbatim}
$ sudo rpm -Uhv VMware-2.0.4-1142.i386.rpm
\end{verbatim}%$
\end{enumerate}

\paragraph{Build and install the kernel modules to support VMware:}

\begin{enumerate}
\item Change to the directory where I have unpacked
  \texttt{vmware-ws-1142-for-2.4.7\allowbreak.tar.gz}:
\begin{verbatim}
$ cd vmware-ws-1142-for-2.4.7
\end{verbatim}%$

\item Run the \texttt{runme.pl} Perl script:
\begin{verbatim}
$ sudo ./runme.pl
\end{verbatim}%$
  
\item Accept all default choices.  I may elaborate this point later; I
  need to install VMware again to confirm that all defaults are
  appropriate.
\end{enumerate}

\paragraph{Install the guest operating system (Windows):}

\begin{enumerate}
\item Start VMware:
\begin{verbatim}
$ vmware &
\end{verbatim}%$

\item Choose ``\textsf{Run the Configuration Wizard}''

\item Make a directory \texttt{/var/vmware} and make it owned by you:
\begin{verbatim}
$ sudo mkdir /var/vmware
$ sudo chown nicku.nicku /var/vmware
\end{verbatim}
Please use \emph{your} \acro{LDAP} account user name, not mine!

\item Make sure that you select this directory as the location to
  install the virtual machine.  \emph{\textbf{Do not select the
      default, a directory in your home directory.}  If you install it
    on a network drive, performance will be very bad, and the load on
    the network would be great.}

\item For the size of the virtual hard disk, choose 1.5\,GB\@.
  Specify that the guest operating system is Windows 2000.
  
\item After configuration is complete, click the power-on button.  You
  will see the virtual machine boot, go through its power-on self-test
  (\acro{POST}).

\item Insert the Windows \CDROM, and install Windows as you would on a
  normal non-virtual computer
\end{enumerate}

\paragraph{Install the VMware Tools:}

The VMware tools are essential to allow better than $640 \times 480$
\acro{VGA} resolution.

\begin{enumerate}
\item Boot Windows in the virtual machine, and from the VMware menu,
  select \textsf{Settings} $\rightarrow$ \textsf{VMware Tools install}

\item In Windows Explorer, open the A: drive.

\item Double-click on the VMware Tools icon, and follow instructions.

\item After installation is complete, reboot the virtual computer when
  requested.

\item When the virtual computer reboots, let it detect your new
  virtual hardware.

\item Adjust the display properties to your liking.
\end{enumerate}
Let Nick Urbanik know if this is unclear, or I have left out any
important steps.
\end{document}
