Skip to content

start:

Setup Guide OpenOffice.org 1.1


June 2003, Revision A

OpenOffice.org 1.1





Setup Guide


Public Documentation License Notice

The contents of this Documentation are subject to the Public Documentation License Version 1.0 (the "License"); you may only use this Documentation if you comply with the terms of this License. A copy of the License is available at http://www.openoffice.org/licenses/PDL.html.

The Initial Writer of the Original Documentation is Sun Microsystems, Inc. Copyright (C) 2003. All Rights Reserved. (Initial Writer contact(s): dedr@openoffice.org).

The English language document was edited and added to by Alex Fisher. (contact information: settantta@openoffice.org

Additional graphic images were provided by Kevin B Hendrcks and Kedar.

Contents

1 About This Guide 7

Icons Used in This Guide 7

2 General Installation Information 9

Installation Types 9

System Requirements 10

General System Requirements 10

Special System Requirements for the Solaris™ Operating Environment (SPARC® Platform Edition) – Solaris OE (SPARC) 10

Special System Requirements for Linux 11

Special System Requirements for Windows 11

Contents of the Download Setup Packages 12

Before You Install From a Downloaded Set 12

Updating an Existing Installation 13

Updating a Multi-User Installation 13

3 Single-User Installation 15

Installation Requirements 15

Starting the Installation 16

Installing From a CD on UNIX Platforms 16

Installing From a Download Set on UNIX Platforms 17

Installing From a CD on Windows Platforms (using download earlier than 1.1.3) 17

Installing From a CD on Windows Platforms (using 1.1.3 download and later) 18

Installing From a Download Set on Windows Platforms 18

The Setup Procedure 19

Welcome 19

Important Information 20

License Agreement 22

User Data 23

Type of Installation 23

Component Selection 25

Installation Directory 26

Reviewing the Installation Options 27

Assigning File Types 28

Java™ Runtime Environment Installation 30

Copying the Files 30

Concluding the Installation 31

Starting OpenOffice.org 32

4 Multi-User and Network Installation 33

Server Installation 33

Installation Requirements 33

Starting the Installation 34

The Setup Procedure 35

Workstation Installation 46

Installation Requirements 46

Starting the Installation 46

The Setup Procedure 48

5 Appendix 61

Installing the Java™ Runtime Environment Under Windows 61

Setting up Printer, Fax and Fonts Under UNIX® Based Platforms 61

Setting up Printers 62

Using Fax Functionality 65

Connecting a PostScript to PDF Converter 66

Installing Fonts 67

Installing a patch under the Solaris™ Operating Environment (OE) 70

Modifying an Existing OpenOffice.org Installation 71

Modify 71

Repair 71

Remove 72

Setup Parameters 72

Starting the OpenOffice.org Software With Parameters 73

Starting the OpenOffice.org Software From the Command Line 73

Valid Command Line Parameters 74

Registering OpenOffice.org 75

Extending the OpenOffice.org Software 77

Installing, Updating and Removing Extensions for a Single User 78

Installing, Updating and Removing Extensions for Multiple Users 79

1About This Guide

Icons Used in This Guide

There are some icons used to call your attention to additional helpful information.

Warning Icon

The "Important" icon alerts you to information regarding data and system security.



Note Icon

The "Note" icon marks extra information that you may find useful - for example, an alternative way to reach a certain goal.



Tip Icon

The "Tip" icon indicates information that lets you work with the program easier.



Solaris Icon

The "Solaris" icon marks information that only applies to the Solaris™ Operating Environment (OE).



Linux Icon

The "Linux" icon marks information that only applies to Linux platforms.



Unix Icon

The "Unix" icon marks information that applies to all platforms based on the UNIX® platform (Solaris OE and Linux).



Windows Icon

The "Win" icon marks information that only applies to the Microsoft Windows operating system.

2General Installation Information

This chapter provides general installation information and the system requirements for running OpenOffice.org. Information on modifying an existing OpenOffice.org 1.1 installation can be found in the Appendix under "Modifying an Existing OpenOffice.org Installation" on page 71.

Installation Types

Installation Type

Usage

Single-User Installation (Page 15 )

Installs the OpenOffice.org software on one computer for one user.

Multi-User or
Network Installation (Page
)

Installs the OpenOffice.org software on a single computer for multiple users or users with restricted access rights, or on a network computer for collective use.

Network installation consists of two phases:

  1. Server Installation - installs common components on a single computer (usually performed by a system administrator).

  2. Workstation Installation - installs user-specific files, including user settings, on a single workstation.

Tip Icon

If you install OpenOffice.org in Windows as a user with restricted access rights (any user without administrator rights), the software will not install correctly.

In this case, perform a Server Installation as an administrator, followed by a Workstation Installation as a user, as described on page .

System Requirements

General System Requirements

  • CD-ROM drive, (if installing from a CD)

  • Approximately 300 MB of available hard-disk space is required for the standard installation.

  • Graphics device capable of 800 x 600 resolution and 256 colors.

Special System Requirements for the Solaris™ Operating Environment (SPARC® Platform Edition) – Solaris OE (SPARC)

  • Solaris™ 8 Operating Environment (OE) or higher (Solaris 9 OE recommended)

  • Solaris 8 OE requires patches 108434-10, 108773-17, 109147-21 and 108435-10 (64 bit only)

  • XServer (capable of 800x600 screen resolution and 256 colors) with a window manager (for example, the OpenWindows™ software, CDE, or GNOME). For accessibility support, GNOME 2.0 or higher is required.

  • at least 128 MB of RAM

Tip Icon

Patches for the Solaris OE can be found on the CD in the directory /solsparc/patches, or on the internet at http://sunsolve.sun.com.

Special System Requirements for Linux

  • PC with Pentium or compatible processor

  • Linux Kernel 2.2.13 or higher

  • glibc2 version 2.2.0 or higher

  • XServer (capable of 800x600 screen resolution and 256 colors) with window manager (for example, GNOME). For accessibility support, GNOME 2.0 or higher is required.

  • at least 128 MB of RAM

Warning Icon

OpenOffice.org cannot be installed on a (V)FAT partition under Linux since FAT file systems do not support the creation of symbolic links.

Special System Requirements for Windows

  • Microsoft Windows 98, ME, NT (Service Pack 6 or higher), 2000 or XP. For support of Asian character input under Windows 98/ME a native Windows 98/ME system is required.

  • PC with Pentium or compatible processor

  • 64 MB of RAM

  • Please note that administrator rights are needed for the installation process.



Contents of the Download Setup Packages

Download setup packages consist of the OpenOffice.org setup application, and the User and Setup (this document) Guides in Portable Document Format (PDF). The contents of the setup packages for the different platforms are listed in the following table:

Platform

Installation Files

Windows

OpenOffice.org Setup: setup.exe, setup.inf and copies of the licenses.


Solaris OE (SPARC)

OpenOffice.org Setup: nstall (a shell script). setup (the setup program), setup.ins (a plain text list of files to be installed) and copies of the licenses


Linux

OpenOffice.org Setup: install (a shell script). setup (the setup program), setup.ins (a plain text list of files to be installed) and copies of the licenses


Before You Install From a Downloaded Set

Place all the downloaded installation files in the same folder.

Unix Icon

Ensure that the setup files have executable rights. If they do not, use chmod to change the rights.

Updating an Existing Installation

You can update an existing OpenOffice.org installation (1.0.2 and higher) to OpenOffice.org 1.1 and continue to use the existing configuration settings. If the setup application finds a earlier OpenOffice.org version on your system, you are prompted to update the installation, or to install the latest version in a different directory. You cannot update an earlier version that is in a different language.

Warning Icon

We do not recommend that you update to a beta version of the OpenOffice.org software.

Updating a Multi-User Installation

The setup application only updates the server installation of a multi-user installation (see also page 33). The next time a user opens OpenOffice.org, a prompt appears offering to update the local user data.

3Single-User Installation

The single-user installation installs the OpenOffice.org 1.1 software on one computer for one user. For a single-user installation, log on to your system as a normal user, and then install OpenOffice.org into your home directory, or in another local directory for which you have full access rights.



Linux/Unix and Window XP/2000users: It is essential to use the two stage Multi-user installation procedure, even if it is on a stand-alone box, and you are the only user.

Linux/Unix users: It is recommended that you use the automated installation script provided.



Note Icon

You can stop the installation process at any time by clicking the Cancel button in the installation dialog. You can also choose to remove the installation directory at this point. If you do, all files and subfolders are removed.

Installation Requirements

Depending on the options that you choose, the single-user installation requires between 190 and 250 MB of free space on your hard-disk. During the installation, an additional 40 MB is required for temporary files on Windows systems, and 80 MB on UNIX® based platforms.

On systems with a previously installed version of OpenOffice.org, open one of the following files:

  • .sversionrc (UNIX based systems)

  • sversion.ini (Windows based systems).
    For Windows NT/2000 and Win9x configured for multiple users, the sversion.ini file is in "C:\Program Files and Settings\{user name}\Application Data".

These files contain the path and version number of the installed OpenOffice.org software. If the version number is identical to the version that you want to install, you must uninstall OpenOffice.org, before you can reinstall it. If the version number is lower than the version that you want to install, and greater than 1.0.2, you can choose to update the installation (see Updating an Existing Installation on page 13)

Starting the Installation

Installing From a CD on UNIX Platforms

  1. Log on with your user name (system administrator rights are not required for a single-user installation).

  2. Start the graphical X Window interface.

  3. Change to the installation directory on the CD. On a multiple-platform installation CD, the installation files are found in:

  • Solaris/Sparc for the Solaris™ Operating Environment (SPARC® Platform Edition) – Solaris OE (SPARC)

  • Solaris/Intel for the Solaris™ Operating Environment (x86 Platform Edition) – Solaris OE (x86)

  • Linux for Linux

  1. Start the setup application with the command:

    ./setup

Installing From a Download Set on UNIX Platforms

  1. Log on with your user name (system administrator rights are not required for a single-user installation).

  2. Start the graphical X Window interface.

  3. Change to the directory containing the downloaded installation file.

  4. Unpack the tarball into a suitable temporary location, either by using a graphical front-end to tar, or by opening a terminal and executing the command
    tar -xzf Ooo_1.1.0_LinuxIntel_install.tar.gz
    (This will create a new directory named Ooo_1.1.0_LinuxIntel_install)

  5. Open a console window in an X-session.


    Note: The setup progam must be run from within an X-session. It cannot be run from the command line.

  6. Execute the following commands:
    cd /<temp_dir>/Ooo_1.1rc3_LinuxIntel_install
    ./setup

Installing From a CD on Windows Platforms (using download earlier than 1.1.3)

  1. If required, log on with your user name (system administrator rights are not required for a single-user installation).

  2. Change to the setup directory on the installation CD.

    On a multiple-platform CD, the setup files are found in the Windows folder.

  3. Do one of the following:

  • Double-click setup.exe

  • Open the Windows Start menu, choose Run, and then type
    X:\Windows\setup.exe in the Open box where X is the letter of your CD-ROM drive.

  1. Click OK to start the installation.

Installing From a CD on Windows Platforms (using 1.1.3 download and later)

The 1.1.3 Downloads are now EXE files, which means that you no longer have to unzip before running the Install.

To run the install, just double click on the EXE file.

Installing From a Download Set on Windows Platforms

  1. If required, log on with your user name (system administrator rights are not required for a single-user installation).

  2. Change to the directory containing the downloaded installation file.

  3. Open the Zip file with a suitable program such as WinZip, and extract the files to a suitable temporary location (C:\Temp is suitable). This will create a new directory named C:\<temporary_directory>\OOo_1.1.0_Win32Intel_install

  4. Change to the directory containing the un-packed downloaded installation files.

  5. Do one of the following:

  • Double-click setup.exe.

  • Open the Windows Start menu, choose Run, and then type
    X:\instdir\setup.exe in the Open box where X:\instdir is the directory with the download set files.

  1. Click OK to start the installation.

The Setup Procedure

During the installation, click the Help button to display information about the current dialog, and then click the Back button to return to the setup program. Do NOT close the Help window with the "X" button on the top right corner of the window, as this would exit the setup program.

Welcome

The first window to appear after you start the setup application is the welcome dialog.

Welcome Dialog

  • Click Next.

If the setup application finds a previous version of OpenOffice.org (1.0.2 or higher), you are prompted to update the installation, or to install into a new directory.

Update Installation Dialog

Choose an install option, and then click Next.

Important Information

The readme file is displayed in a window. The readme file is located in the installation directory on your machine, so that you can open it later.

  1. Read the information, and then click Next.



License Agreement

The next dialog contains the license agreement. If you do not accept the agreement the OpenOffice.org software will not be installed.



  • Read through the license agreement. If you agree, ensure that you have scrolled to the bottom of the agreement, select the I accept the terms of the agreement box, and then click OK.

  • If you do not agree, click Decline to exit the setup program.



User Data

Next, the Enter User Data dialog appears.

The data entered here is used by OpenOffice.org to personalize templates and documents.

You can access this dialog later from any OpenOffice.org application, choose Tools - Options - OpenOffice.org - User Data.

Personal Data Dialog

  • Enter your personal data.

  • Click Next to continue with the installation.

Type of Installation

Use this dialog to select the type of installation that you want to perform. This dialog does not appear if you are updating a previous version of OpenOffice.org.

The space requirements that are listed are only estimates and depend on the properties of the storage media.

There are three types of installation available:

  • Standard Installation - recommended for most users. Installs all of the OpenOffice.org applications, and a selection of filters.

  • Custom Installation - recommended for advanced users. Allows you to select the individual components to be installed.

  • Minimum installation - recommended for users with space restrictions. This option only installs the components that are required to run OpenOffice.org.

Installation Type Dialog

  • Select the type of installation that you want to perform.

  • Click Next to continue the installation.



Component Selection

If you select the Custom Installation option, you can then choose the modules and the components that you want to install.

Click the plus sign (+) next to the name of a module or component category to expand the list. Click the category or the component that you want to install. If a category contains unselected components, the box in front of the category is semi-transparent.

Complete Installation Icon

Categories in dark blue are installed with all of their components.

Partial Installation Icon

Categories in light blue are installed with only some of their components.

No Installation Icon

Categories in white are not installed.

To restore the standard installation options, click the Default button.

Select Module Dialog

  • Select the modules and the components you want to include in the installation.

  • Click Next to continue the installation.

Installation Directory

The next dialog lets you select the installation directory. This dialog does not appear in an update installation.

The available drives on your system are listed in this dialog. The space requirements displayed are only estimates and depend on the properties of the storage media.


Note: There are slight differences between the Windows dialog and the unix/linux dialog.



Setup Directory Dialog

  • Enter a path for the Installation directory in the text box, or click Browse to select a directory.

    If the directory does not exist, you are prompted to create it.

  • Click Next to continue with the installation.

Reviewing the Installation Options

After you set your installation options, a dialog appears that allows you review the settings.



  • Click Install to continue with the installation, or click Back to alter the settings made.

Assigning File Types

Use this dialog to associate OpenOffice.org with Microsoft file types, and with HTML documents. This information is registered in your operating system.

File Type Assignment Dialog

  • Select the File types that you want OpenOffice.org to open.


Unless you intend to use OpenOffice.org as your regular daily Office suite, make sure you leave the boxes unchecked. (If you forget, or miss this screen, don"t panic, as your files are still there, and are still in the original format. They may still be opened from within Word or Excel by using the "Open File..." button. They can also be re-associated with Microsoft Office, by right-clicking on a file (Shift-right-click in Windows 9x/Me) and selecting "Open With...", then choosing the Microsoft program and checking the "Always open with this program" box.).

Whether you check these boxes or not, you may still open all your Microsoft Office files with OpenOffice.org.

  • To make OpenOffice.org Writer the default editor for HTML files, select the check box in the Default HTML Editor check box.

  • Click OK.

Note Icon

You can set the file type assignments of an existing installation by running the setup application and selecting the Modify option (see Modify on page 71).

Java™ Runtime Environment Installation

The next dialog lists the versions of the Java™ Runtime Environment (JRE) registered in your system, or gives you the option to install the JRE.

Select the JRE that you want to use. Version 1.4 or higher is recommended. If you already have a JRE installed, you do not have to install the version provided.

Java Runtime Environment Installations List

  • If a JRE is present on your system, select the version that you want to use, and then click OK.

Copying the Files

During the installation, the progress is indicated as a percentage and the remaining time is estimated.

Concluding the Installation

When the installation is complete, a final dialog is displayed.

Click Complete to finish the installation.

Unix Icon

Depending on the window manager that you use, you may need to log off and restart your window manager.

Starting OpenOffice.org

Unix Icon

Change to the {installpath}/program directory, or to the local OpenOffice.org directory in your home directory, and type:

./soffice

You can also add the {installpath}/program directory to the program path, and then type "soffice" in any directory to start OpenOffice.org.

To set up the default printer for OpenOffice.org, call the spadmin Printer Administration Utility, as is described in the Appendix. After completing the installation process under the Solaris OE, log out and log in again to update the CDE integration.

Windows Icon

The icons for starting the OpenOffice.org applications are added to the Windows Start menu in the programs/OpenOffice.org 1.1 folder.

During the installation process, a link to the OpenOffice.org Quickstarter is added to the Autostart folder in the Windows Start menu. The Quickstarter is added to the system tray when you start Windows. Right-click the Quickstarter icon in the system tray, and choose the OpenOffice.org application that you want to start.

For more information on the Quickstarter, see the online help.

Information about starting OpenOffice.org with command line parameters is found in the Appendix.

4Multi-User and Network Installation

Installing OpenOffice.org for multiple users on a network is a two-step process:

  1. Server Installation - installed by the system administrator using the setup -net command. The OpenOffice.org files are copied to a directory with read and execute permission for all users (see page 33)

  2. User Installation - each user installs a copy of OpenOffice.org in their home directory, or only installs user-specific files. The latter is also known as a Workstation Installation, and requires access to the Server Installation to run the OpenOffice.org applications (see page 46).

Server Installation

The Server Installation is not a stand-alone version of the OpenOffice.org software. Before you can use OpenOffice.org, you must perform a Workstation Installation from the Server Installation (see "Workstation Installation" on page 46).

Installation Requirements

The Server Installation of the OpenOffice.org software requires approximately 250 MB of disk space. Temporary setup files generated during the install process require an additional 20 MB of disk space. These temporary files are automatically removed after the installation. Under UNIX®, an 80 MB temporary swap volume is created during the installation and deleted afterwards.

Starting the Installation

Installing From a CD on UNIX Platforms

  1. Log on as the system administrator.

  2. Start the graphical XWindow interface.

  3. Change to the installation directory on the CD. On a multiple-platform installation CD, the installation files are found in:

  • Solaris/Sparc for the Solaris™ Operating Environment (SPARC® Platform Edition) – Solaris OE (SPARC)

  • Solaris/Linux for the Solaris™ Operating Environment (x86 Platform Edition) – Solaris OE (x86)

  • Linux (for Linux)

  1. Start the installation script with the command:
    ./setup -net

Note: For Linux there is an automated installation script named install. This may be used instead of the 'setup -net' command if a custom installation is not required.

Installing From a Download Set on UNIX Platforms

  1. Log on as the system administrator.

  2. Start the graphical XWindow interface.

  3. Change to the directory containing the downloaded installation files.

  4. Start the setup application with the command:
    ./setup -net

Note: For Linux there is an automated installation script named install. This may be used instead of the 'setup -net' command if a custom installation is not required.

Installing From a CD on Windows Platforms

  1. Log in as the system administrator.

  2. Open the Windows Start menu, choose Run, and then type
    X:\Windows\setup.exe -net in the Open box.

    X is the letter of your CD ROM drive.

  3. Click OK to start the installation.

Installing From a Download Set on Windows Platforms

  1. Log in as the system administrator.

  2. Open the Windows Start menu, choose Run, and then type
    X:\instdir\setup.exe -net in the Open box.

    X:\instdir is the directory with the download set files.

  3. Click OK to start the installation.

Tip Icon

When updating an existing OpenOffice.org installation, you may have to tell the setup program where this previous version is installed.

If the setup procedure does not automatically recognize a previous version that can be updated, try running the setup application with the -update parameter:

./<setup> -net -update:<path_to_previous_serverinst>

where <setup> is the name of the setup routine to be started (see above), and <path_to_previous_serverinst> is the fully qualified path to the previous server installation of OpenOffice.org.

The Setup Procedure

Welcome

The first window to appear after you start the setup application is the welcome dialog.

Welcome Dialog

  • Click Next.

If the setup application finds a previous version of OpenOffice.org (1.0.2 or higher), you are prompted to update the installation, or to install into a new directory.

Update Installation Dialog

  1. Choose an install option, and then click Next.

Important Information

The readme file is displayed in a window. The readme file is located in the installation directory on your machine, so that you can open it later.

Read the information, and then click Next.



License Agreement

The next dialog contains the license agreement. If you do not accept the agreement the OpenOffice.org software will not be installed.



  • Read through the license agreement. If you agree, ensure that you have scrolled to the bottom of the agreement, select the I accept the terms of the agreement box, and then click OK.

  • If you do not agree, click Decline to exit the setup program.

Type of Installation

Use this dialog to select the type of installation that you want to perform. This dialog does not appear if you are updating a previous version of OpenOffice.org.

The space requirements that are listed are only estimates and depend on the properties of the storage media.

There are three types of installation available:

  • Standard Installation - recommended for most users. Installs all of the OpenOffice.org applications, and a selection of filters.

  • Custom Installation - recommended for advanced users. Allows you to select the individual components to be installed.

  • Minimum installation - recommended for users with space restrictions. This option only installs the components that are required to run OpenOffice.org.

Installation Type Dialog

  • Select Custom Installation.

    Install all of the OpenOffice.org components during the server installation, so that each user can access these options during a Workstation Installation.

  • Click Next to continue the installation.

Component Selection

If you select the Custom Installation option, you can then choose the modules and the components that you want to install.

Click the plus sign (+) next to the name of a module or component category to expand the list. Click the category or the component that you want to install. If a category contains unselected components, the box in front of the category is semi-transparent.


Complete Installation Icon

Categories in dark blue are installed with all of their components.

Partial Installation Icon

Categories in light blue are installed with only some of their components.

No Installation Icon

Categories in white are not installed.

To restore the standard installation options, click the Default button.

Select Module Dialog

  • Select the modules and the components you want to include in the installation.

  • Click Next to continue the installation.

Installation Directory

The next dialog lets you select the installation directory. This dialog does not appear in an update installation.

The available drives on your system are listed in this dialog. The space requirements displayed are only estimates and depend on the properties of the storage media.

Select Installation Directory Dialog

  • Enter a path for the Installation directory in the text box, or click Browse to select a directory.

    If the directory does not exist, you are prompted to create it.

  • Click Next to continue with the installation.

Tip Icon

Ensure that the directory that you select for the server installation, has read and execution rights for all users, so that you can perform Workstation Installations.

Java™ Runtime Environment Installation

The next dialog lists the versions of the Java™ Runtime Environment (JRE) registered in your system, or gives you the option to install the JRE.

Select the JRE that you want to use. Version 1.4 or higher is recommended. If you already have a JRE installed, you do not have to install the version provided.

Java Runtime Environment Installations List

  • If a JRE is present on your system, select the version that you want to use, and then click OK.

Tip Icon

The JRE installation is a shared installation for all users. If you do not install the JRE at this point, users can install it when they perform a workstation installation.

Reviewing the Installation Options

After you set your installation options, a dialog appears that allows you review the settings.

  1. Click Install to continue with the installation, or click Back to alter the settings made.

Copying the Files

During the installation, the progress is indicated as a percentage and the remaining time is estimated.

Concluding the Installation

When the installation is complete, a final dialog is displayed.

Click Complete to finish the installation.

Unix Icon

Depending on the window manager that you use, you may need to log off and restart your window manager.

Now, each user can perform a Workstation Installation, to copy the necessary files to his or her home directory or local hard disk. The Workstation Installation is described in the next chapter.

If you intend to perform a large number of installations from a Server Installation, you may want to turn off the registration dialog that appears the second time a user starts OpenOffice.org. For details, see 75 in the Appendix.

Workstation Installation

Before you can run OpenOffice.org on a network installation, you must perform a Workstation Installation. Each Workstation Installation requires access to the main OpenOffice.org components on the central server installation.

Tip Icon

When you update an existing Server Installation, users are automatically prompted to update the Workstation Installations the next time they are started.

Installation Requirements

A workstation installation requires a minimum of 20 MB free space.

Starting the Installation

Before you can install OpenOffice.org on a workstation, you must perform a Server Installation. See Server Installation on page 33 for details.

On systems with a previously installed version of OpenOffice.org, open one of the following files:

  • .sversionrc (UNIX based systems)

  • sversion.ini (Windows based systems).

    For Windows NT/2000 and Win9x configured for multiple users, the sversion.ini file is in "C:\Program Files and Settings\{user name}\Application Data".

These files contain the path and version number of the installed OpenOffice.org software. If the version number is identical to the version that you want to install, you must uninstall OpenOffice.org, before you can reinstall it. If the version number is lower than the version that you want to install, and greater than 1.0.2, you can choose to update the installation (see Updating an Existing Installation on page 13)

Installing on UNIX Platforms

  1. Log on with your user name.

  2. Start the graphical XWindow interface.

  3. Change to the program subdirectory in the setup directory on the server installation. Do not use the original setup file of the OpenOffice.org installation.

  4. Start the installation script with the command:

    ./setup


An alternative method for Linux users is to open a graphical file manager such as Konqueror (KDE) or Nautilus (Gnome) and (double-) click on the setup file.

You may also press <Alt-F2> and type the command '<server_install_directory>/setup and click 'Run'.

Installing on Windows Platforms

  1. Log on with your user name.

  2. Change to the program subdirectory in the setup directory on the server installation. Do not use the original setup file of the OpenOffice.org installation.

  3. Do one of the following

  • Double-click setup.exe.

  • Open the Windows Start menu, choose Run, and then type {server install dir}\program\setup.exe in the Open box.

    where {server install dir} is the setup directory on the server installation.

  1. Click OK to start the workstation installation.

The Setup Procedure

Welcome

The first window to appear after you start the setup application is the welcome dialog.

Welcome Dialog

  • Click Next.

Update Installation Dialog

If the setup application finds a previous version of OpenOffice.org (1.0.2 or higher), you are prompted to update the installation, or to install into a new directory.

  • Choose an install option, and then click Next.



Important Information

The readme file is displayed in a window. The readme file is located in the installation directory on your machine, so that you can open it later.



  • Read the information, and then click Next.



License Agreement

The next dialog contains the license agreement. If you do not accept the agreement the OpenOffice.org software will not be installed.



  • Read through the license agreement. If you agree, ensure that you have scrolled to the bottom of the agreement, select the I accept the terms of the agreement box, and then click OK.

  • If you do not agree, click Decline to exit the setup program.



User Data

Next, the Enter User Data dialog appears.

The data entered here is used by OpenOffice.org to personalize templates and documents.

You can access this dialog later from any OpenOffice.org application, choose Tools - Options - OpenOffice.org - User Data.

Personal Data Dialog

  • Enter your personal data.

  • Click Next to continue with the installation.

Type of Installation

Tip Icon

If you do not see the dialog window described below, but rather a dialog window offering standard, custom and minimum installation types, close the dialog, and then run the setup application in the program subdirectory on the server installation.

The Workstation Installation option only installs user-specific files locally, and requires access to the server installation to run OpenOffice.org.

The Local Installation option installs a complete copy of OpenOffice.org locally. The resulting installation does not require access to the Server Installation to run OpenOffice.org.

Select Installation Type Dialog

  • Select Workstation Installation as the installation type. You have to perform a separate workstation installation for each user on the same machine.

  • Click Next to continue the installation.

Installation Directory

The next dialog lets you select the installation directory. This dialog does not appear in an update installation.

The available drives on your system are listed in this dialog. The space requirements displayed are only estimates and depend on the properties of the storage media.


Note: The Windows dialog may appear slightly differently



Select Installation Directory Dialog

  • Enter a path for the Installation directory in the text box, or click Browse to select a directory.

    If the directory does not exist, you are prompted to create it.

  • Click Next to continue with the installation.

Reviewing the Installation Options

After you set your installation options, a dialog appears that allows you review the settings.



  • Click Install to continue with the installation, or click Back to alter the settings made.



Assigning File Types

Use this dialog to associate OpenOffice.org with Microsoft file types, and with HTML documents. This information is registered in your operating system.

File Type Assignment Dialog

  • Select the File types that you want OpenOffice.org to open.


Unless you intend to use OpenOffice.org as your regular daily Office suite, make sure you leave the boxes unchecked. (If you forget, or miss this screen, don"t panic, as your files are still there, and are still in the original format. They may still be opened from within Word or Excel by using the "Open File..." button. They can also be re-associated with Microsoft Office, by right-clicking on a file (Shift-right-click in Windows 9x/Me) and selecting "Open With...", then choosing the Microsoft program and checking the "Always open with this program" box.).

Whether you check these boxes or not, you may still open all your Microsoft Office files with OpenOffice.org.

  • To make OpenOffice.org Writer the default editor for HTML files, select the check box in the Default HTML Editor check box.

  • Click OK.

Note Icon

You can set the file type assignments of an existing installation by running the setup application and selecting the Modify option (see Modify on page 71).

Java™ Runtime Environment

If the Java™ Runtime Environment (JRE) was not installed during the Server Installation, you are prompted to install the JRE. To install the JRE, follow the instructions on page 30.

Copying the Files

During the installation, the progress is indicated as a percentage and the remaining time is estimated.



Concluding the Installation

When the installation is complete, a final dialog is displayed.

Click Complete to finish the installation.

Unix Icon

Depending on the window manager that you use, you may need to log off and restart your window manager.

Starting OpenOffice.org

Unix Icon

Change to the {installpath}/program directory, or to the local OpenOffice.org directory in your home directory, and type:

./soffice

You can also add the {installpath}/program directory to the program path, and then type "soffice" in any directory to start OpenOffice.org.

To set up the default printer for OpenOffice.org, call the spadmin Printer Administration Utility, as is described in the Appendix.

After completing the installation process under the Solaris OE, log out and log in again to update the CDE integration.

Windows Icon

The icons for starting the OpenOffice.org applications are added to the Windows Start menu in the programs/OpenOffice.org 1.1 folder.

During the installation process, a link to the OpenOffice.org Quickstarter is added to the Autostart folder in the Windows Start menu. The Quickstarter is added to the system tray when you start Windows.

Right-click the Quickstarter icon in the system tray, and choose the OpenOffice.org application that you want to start.

For more information on the Quickstarter, see the online help.

Information about starting OpenOffice.org with command line parameters is found in the Appendix.

5Appendix

The Appendix contains instructions for installing the Java™ Runtime Environment (JRE),and information about the printer administration program under the Solaris™ Operating Environment and under Linux. It also contains information about modifying, repairing, and deinstalling the OpenOffice.org software.

Installing the Java™ Runtime Environment Under Windows

During the OpenOffice.org installation, you are prompted to install the Java Runtime Environment (JRE). These files are only required to run JAVA based applets and some OpenOffice.org components, such as the Report AutoPilot.

To install the JRE later, run the jvmsetup located in the program directory of the OpenOffice.org installation.

Linux Icon

To use the Java Runtime Environment (JRE) under Linux, refer to the readme file for the most up-to-date information.

Setting up Printer, Fax and Fonts Under UNIX® Based Platforms

Under UNIX® based platforms, the printer administration program spadmin is provided to help you set up printers, faxes and fonts for use with the OpenOffice.org software.

Call the printer administration program spadmin as follows:

  • Go to the {installpath}/program directory.

  • Enter: