Java Desktop System Release 3 Installation Guide

Chapter 2 Installing the Java Desktop System on Linux Systems

This chapter describes the installation procedure for installing the Java Desktop System Release 3 on Linux systems.

Installing From CD

This section describes how to install the Java Desktop System using the CDs included with your Java Desktop System installation package.

Perform the following steps:

Insert CD 1 into the CD drive.

The system starts to boot and displays the following list of options:
- Boot from Hard Disk
- Installation
- Installation — ACPI Disabled
- Installation — Safe Settings
- Manual Installation
- Rescue System
- Memory Test
To perform a new installation of the Java Desktop System, use the arrow keys to highlight the Installation option, then press Enter.
The Configurator presents a Software License Agreement dialog. Click on I Agree to continue with the installation. You cannot continue with the installation if you do not click on I Agree.
From the Select your language dialog, use the arrow keys to highlight the language that you want, then click on Accept.
The Configurator analyzes your system. If Linux is not installed on your system, the Configurator displays the installation settings of your hardware, as shown in the example in Step 7.

However, if the Configurator detects that Linux is installed on your system, you are presented with the following options:
- New installation
  
  Select this option if Linux is not installed on your system or if you want to replace an installed version of Linux.
- Update an existing system
  
  Select this option if you want to upgrade an installed version of Linux. This option preserves configuration settings from your existing system whenever possible. However, your panel configuaration is not preserved. You must manually configure the default panel configuration if you want to revert to your previous panel configuration.
  
  Note –
  Java Desktop System Release 3 on Linux systems supports Install Update for previous releases of the Java Desktop System. If you are installing Java Desktop System Release 3 on Linux systems from previous releases of Java Desktop System, you must use the Java Desktop System Release 3 installer to update your system. Java Desktop System Release 3 contains the 2.6 Linux kernel. Any additional kernel modules that you installed on previous releases of Java Desktop System are lost during the update. You must re-install the additional kernel modules after updating to Java Desktop System Release 3.
- Repair installed system
  
  Select this option if you have an installed version of Linux that you want to repair.
- Boot installed system
  
  Select this option if you have an installed version of Linux that you cannot reboot. You can use this option to try to fix the reboot problem manually.
- Abort Installation
  
  Select this option if you want to abort the installation.
Select New installation and click OK.
Next, you are presented with the Installation settings for your system.

For example:
- System — Processor: Pentium 111 (Katmai)
- Mode — New Installation
- Keyboard Layout — English US
- Mouse — PS/2 Mouse (Aux-port)
- Partitioning — Format partition /dev/hda6 9.3 GB with reiser and Format partition /dev/hda5 196 MB for swap
  
  If you click on Partitioning to modify the default settings, the Configurator checks your hard disk and displays the following options:
  - Accept proposal as-is
  - Base partition setup on this proposal
  - Create custom partition setup
  Select Accept Proposal as is and click on Next.
  
  Note –
  If you want to create a dual boot system, partitioning is an essential part of the installation procedure. Please see Guidelines for Partitioning for more information.
- Software
  - Default system with StarOffice
  If you click on Software, the Configurator displays the following software options:
  
  Default system with StarOffice
  
  Default system with StarSuite
  
  Select the appropriate option and click on Accept.
  
  Note –
  The Configurator supports grouping software packages together in Selections. If you want to install additional software packages, click on Detailed selection to display a package manager dialog. For example, if you want to install NetBeans, do the following:
  - From the package manager dialog, select Package Groups from the Filter drop-down list.
  - Select Applications in the package tree.
  - Select the following packages in the right pane:
    - sun-netbans-ide
    - sun-netbans-ide4-modules
    - sun-netbeans-mobility
    - sun-netbeans-platform4
  - Click on Accept.
  For more information about Net Beans, see http://www.netbeans.org/kb/index.html.
- Booting — Boot loader type: GRUB
  
  If you click on Booting, the Configurator displays the Boot Loader Setup dialog from where you can edit boot loader configuration manually.
  
  Accept the booting option proposed by the configurator.
- Time Zone — For example, Europe/Ireland
- Language — For example, English (US)
- Default Runlevel — For example, 5: Full multiuser with network and xdn
Note –
You have the following courses of action available at this stage in the installation procedure:
- Click on Accept to continue with the installation.
- Click on Change to modify the installation settings before you proceed with the installation.
- Click on Abort Installation to abort the installation.
Click on Accept to continue with the installation.
Click on Yes, install to commit the installation and all the choices made so far.

A message informs you that the Configurator is preparing your hard disk. When the installation begins, a screen is displayed with the following panes:
- Current Package
  
  Displays the name, description and size of the installation package and a status bar showing percentage completion of the installation.
- Installation
  
  Displays the status of the percentage download completed from the CD and the estimated time remaining to complete the download.
- Installation Log (Extract)
  
  Displays a log of activity for all the packages currently being installed on your system. When the packages from CD 1 are installed, a dialog requests you to insert CD 2.
Insert CD 2 and click OK.

When the packages from CD 2 are installed, a dialog requests you to insert CD 3.
Insert CD 3 and click OK.

When the packages from CD 3 are installed, a dialog requests you to insert CD 4.
Insert CD 4 and click OK.

When the packages from CD 4 are installed, a dialog requests you to insert CD 5.
Insert CD 5 and click OK.

When all the packages from CD 5 are successfully installed, the Configurator prompts you to enter a password for the root user.
Enter a password for the root user.
Reenter the password for verification and click on Next.

Note –
Make a note of the root password for future references. You only need to log in as root for system administration purposes.
The Configurator displays the Network Configuration for the following hardware devices:
- Network Interfaces
- DSL Connections
- ISDN Adapters
- Modems
- Proxy
- VNC Remote Administration
You can choose to skip or accept the network configuration. To change any of the Network Configuration settings, click on Change. Click on Next to accept the settings.
The Configurator displays the User Authentication Method dialog.

Select from one of the following authentication methods and click on Next to continue:
- NIS
- LDAP
- Local (/etc/passwd)
The Configurator displays the Add a New Local User dialog.
Enter the Full User Name, User Login, and Password for the user you want to add and click on Next. A new user account is created with the details you enter.
The Configurator displays the location for the Java Desktop System Release Notes. Click on Next to continue.
The Configurator displays the Hardware Configuration as follows.
- Graphics Card
- Printers
- Sound
Select from one of the following and click on Next:
- Skip Configuration
- Use Following Configuration
A message is displayed informing you that the installation is complete.
Click on the Finish button to display the Sun Java Desktop System Registration.
Eject CD 5.
At the login screen, log in with the username and password that you set up for the new user.

You can now use the Java Desktop System.

Refer to the Java Desktop System Release 3 User Guide for help to get you started using the Java Desktop System.

Updating an Existing System From CD

If the Configurator detects that Linux is installed on your system, you are presented with the following options:

New installation
Update an existing system
Boot installed system
Abort Installation

If you want to upgrade an installed version of Linux, perform the following steps:

Select Update an existing system

This option preserves configuration settings from your existing system whenever possible.
Select Create a backup if you want to make a backup of your existing system.
Click Next.
You are prompted to choose the type of upgrade you require.
Follow the online instructions to complete the update of your existing system as described in Installing From CD.

Installing From the Network

You can perform a network installation of your Java Desktop System on Linux platforms. Ensure you have access to an NFS shared directory that has approximately 3GB of free space.

Setting up a Network Installation Image

The following sample procedure describes how to set up an installation image for the Java Desktop System on Linux installation via a Network File System (NFS).

Log in as the root user and copy the CDs into a special directory structure. Go to a directory of your choice and execute the following commands in steps 2 to 15:
mkdir -p installroot/sles9/CD1

Copy the contents of JDS CD1 into this directory.
mkdir -p installroot/core9/CD1

Copy the contents of JDS CD2 into this directory.
mkdir -p installroot/core9/CD2

Copy the contents of JDS CD3 into this directory.
mkdir -p installroot/core9/CD3

Copy the contents of JDS CD4 into this directory.
mkdir -p installroot/core9/CD4

Copy the contents of JDS CD5 into this directory.
ln -s sles9/CD1/boot boot
ln -s sles9/CD1/content content
ln -s sles9/CD1/control.xml control.xml
ln -s sles9/CD1/media.1 media.1
mkdir -p installroot/yast
echo "/sles9/CD1 /sles9/CD1" > yast/instorder
echo "/core9/CD1 /core9/CD1" >> yast/instorder
echo "/sles9/CD1 /sles9/CD1" > yast/order
echo "/core9/CD1 /core9/CD1" >> yast/order

Setting up a MS Windows System as an Installation Server

To set up a MS windows system as an installation server, perform the following steps:

Go to the directory dosutils/install.
Copy the instorder file to \suseinstall\yast.
Replace the UserAccount, PASSword, and IP-Number variables with the respective values of your MS windows machine.
Copy the order file to \suseinstall\yast.
Run the install.bat script to create the structure and to prompt you for the CDs.

Note –
During the installation process you need only to specify the share suseinstall.

Before You Begin a Network Installation

Before you begin installing the Java Desktop System from the network, you need to have the following:

IP address of your machine
IP address of a nameserver
IP address of an NFS server
Network subnet mask
Type of network card installed
JDS CD1 or three boot disks (see the following section to locate the boot disks)

Boot Disk Locations

The boot disks are available from the following locations:

On disk labelled CD 1 included with your Java Desktop System installation package.
From your network install image in the sles9/CD1/boot folder.

The boot disk subfolders are named as follows:

bootdisk
modules1
modules3

Use the following command to make other disks, if required:

dd if=/export/suseimage/boot/bootdisk of=/dev/fd0

Note –

You may need additional disks depending on your hardware, for example, SCSI controllers and USB drives.

Network File System Installation Procedure

The following procedure describes how to perform a NFS installation on Linux systems.

Insert JDS CD1 in your drive.

The system starts to boot.
From the JDS CD1 boot screen, press the F3 button.
Select NFS.
Enter the following information:

The IP address of the install server

The location of the install image
Press Return.
Select Installation, then press Return.
Follow the remaining online installation instructions to complete the Java Desktop System network installation procedures. For more information, see Installing From CD.

Guidelines for Partitioning

The following table contains recommended guidelines for partitioning your disk:

Table 2–1 Guidelines for Partitioning


Partition	Size	Type	Notes
/	6 GB, 4 GB minimum	Primary	Install the entire `Java Desktop System` operating system onto a single partition. This method provides sufficient space for you to install a later releases of the `Java Desktop System` without the need to repartition the disk.
swap	Double the size of RAM 256 MB minimum	swap	You can increase or reduce the size of the swap partition as necessary.

Resizing Your Partition

The Configurator presents the following options when resizing your partition:

Accept proposal as-is
Base partition setup on this proposal
Create custom partition setup

Perform the following steps to resize a partition:

From the Installation Settings dialog, select Partitioning, select Base partition setup on this proposal option, then click on Next.
Highlight the partition that you want to resize, then click on Resize.
Use the slider to set how much space you want to allocate to your Windows partition and your Linux partition, then click OK.

Note –
The minimum allocation of space for Linux is 3024 MB.
Click on Next to save the partition table and return to the Installation Settings dialog.

Creating a Custom Partition Table

If the partition recommended by the Configurator is unsuitable for the Java Desktop System installation, you might need to create a custom partition table.

Perform the following steps to create a custom partition table:

Back up any files you want to keep. This procedure overwrites your existing Windows partition.
From the Installation Settings dialog, select Partitioning, select Create custom partition option, then click Next.
Select Custom partitioning, for experts option, then click Next to display the Expert Partitioner dialog.
Select the device that refers to the disk where you want to install the application, for example /dev/hda, then click Delete to erase all partitions on that disk.
Click Create to create a new partition and select the Primary option.
In the popup window, set the Start Cylinder size to 0, set the End Cylinder size to + 5 GB and set the Mount Point to / .
Click Create to create a new partition and select the Extended option.

The popup window must contain all the correct settings. For example, the Start Cylinder value must be one more than the End Cylinder value of hda1 and the End Cylinder value can be the same as the End Cylinder value for /dev/hda.

Creating an extended partition that covers the remainder of the disk forces all other partitions to be created within that extended partition.
Click Create to create a new partition.
Select Swap from the menu beneath the Format option.
Specify the size of the swap partition using the + syntax in the End field. For example, if your system has 256 MB RAM, you would have 512 MB of swap memory, which is expressed as + 512 MB.
Click Create to create a new partition. A new partition to occupy the remainder of the disk is configured. Set the Mount Point to /usr.
Click Next to save the partition table and return to the Installation Settings dialog.