General 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 Single-User Installation (Page 15 ) Multi-User or Network Installation (Page ) Usage Installs the OpenOffice.org software on one computer for one user. 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. 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

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
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.

1. Log on with your user name (system administrator rights are not required for a single-user installation).
16 OpenOffice.org 1.1 Setup Guide
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.
4. Click OK to start the installation.
Chapter 3 Single-User Installation 17
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. (If there are spaces in the path, be sure to include the quotation marks.)
6. 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
18 OpenOffice.org 1.1 Setup Guide
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.

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.
Chapter 3 Single-User Installation 19
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.
20 OpenOffice.org 1.1 Setup Guide
1. Read the information, and then click Next.
Chapter 3 Single-User Installation 21

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.
22 OpenOffice.org 1.1 Setup Guide

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.
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:
Chapter 3 Single-User Installation 23
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.

Select the type of installation that you want to perform. Click Next to continue the installation.
24 OpenOffice.org 1.1 Setup Guide

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 semitransparent. Categories in dark blue are installed with all of their components. Categories in light blue are installed with only some of their components. Categories in white are not installed. To restore the standard installation options, click the Default button.
Select the modules and the components you want to include in the installation. Click Next to continue the installation.
Chapter 3 Single-User Installation 25

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.
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.
26 OpenOffice.org 1.1 Setup Guide
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.
Chapter 3 Single-User Installation 27

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.
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.

34 OpenOffice.org 1.1 Setup Guide
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.
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 where X:\instdir is the directory with the download set files. (If there are spaces in the path, be sure to include the quotation marks.) 3. Click OK to start the installation. 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.
Chapter 4 Multi-User and Network Installation 35
1. Choose an install option, and then click Next.
36 OpenOffice.org 1.1 Setup Guide
Read the information, and then click Next.
Chapter 4 Multi-User and Network Installation 37
Standard Installation - recommended for most users. Installs all of the OpenOffice.org applications, and a selection of filters.
38 OpenOffice.org 1.1 Setup Guide
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.
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.
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 semitransparent.
Chapter 4 Multi-User and Network Installation 39
Categories in dark blue are installed with all of their components. Categories in light blue are installed with only some of their components. Categories in white are not installed. To restore the standard installation options, click the Default button.

40 OpenOffice.org 1.1 Setup Guide
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.
Chapter 4 Multi-User and Network Installation 41
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.
42 OpenOffice.org 1.1 Setup Guide
1. Click Install to continue with the installation, or click Back to alter the settings made.
Chapter 4 Multi-User and Network Installation 43
44 OpenOffice.org 1.1 Setup Guide
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.
Chapter 4 Multi-User and Network Installation 45
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. When you update an existing Server Installation, users are automatically prompted to update the Workstation Installations the next time they are started.
A workstation installation requires a minimum of 20 MB free space.
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".
46 OpenOffice.org 1.1 Setup Guide
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. (If there are spaces in the path, be sure to include the quotation marks.)
4. Click OK to start the workstation installation.
Chapter 4 Multi-User and Network Installation 47
48 OpenOffice.org 1.1 Setup Guide
Chapter 4 Multi-User and Network Installation 49
50 OpenOffice.org 1.1 Setup Guide
Chapter 4 Multi-User and Network Installation 51
52 OpenOffice.org 1.1 Setup Guide
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 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.
Chapter 4 Multi-User and Network Installation 53
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
54 OpenOffice.org 1.1 Setup Guide
Chapter 4 Multi-User and Network Installation 55
56 OpenOffice.org 1.1 Setup Guide

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 29.
Chapter 4 Multi-User and Network Installation 57
Click Complete to finish the installation. Depending on the window manager that you use, you may need to log off and restart your window manager.

Setting up Printers

Under UNIX based platforms, the OpenOffice.org software only offers direct support for printers using the PostScript technology. Other printers must be set up as described in the section Printer Drivers in the OpenOffice.org Software. The OpenOffice.org software automatically provides a printer with the default driver for each system queue. You can add additional printers as needed.

Adding a Printer

1. Click the New Printer button. 2. Select the Create Printer option and click Next. 3. Select the appropriate driver for your printer. If you are not using a PostScript printer or your model is not listed, use the Generic Printer driver or follow the steps below. You can also add new drivers using the Import button or delete unnecessary drivers using the Delete button. Click Next. 4. Choose a command line that you can use to print on your printer (for example, lp -d my_queue). Click Next.
62 OpenOffice.org 1.1 Setup Guide
5. Give the printer a name and determine whether it should become the default printer. Click Finish. 6. To print a test page, click on Test Page. If the test page fails to print or is incorrectly printed, check all settings as described in Changing Printer Settings.
Printer Drivers in the OpenOffice.org Software
When installing a non-PostScript printer, you must set your system so that PostScript can be converted into the language of the printer. We recommend using current PostScript conversion software such as Ghostscript (http://www.cs.wisc.edu/~ghost/). You should set up the Generic Printer in that case. Also make sure that the page margins are set correctly. If you are using a printer using the PostScript technology, you should install a description file for the printer (PostScript Printer Definition - PPD) so that you can utilize the specific printer features like paper tray selection, duplex print function and all built-in fonts. You can also use the generic printer driver since it contains the most important data and is suitable for most printers. In that case, you will have to do without the paper tray selection and must correctly set the page margins. Some PPD files are installed as default files. If there is no matching PPD file for your printer, you will find various PPD files at http://www.adobe.com/products/printerdrivers/. You can also ask the manufacturer of your printer for PPD files.
Importing Drivers When Creating a New Printer
1. Click Import in the driver selection dialog. 2. Click Browse to select the directory where you unpacked the PPD files. 3. In the Selection of drivers list box, select the printer driver you want to install. 4. Click OK.

Chapter 5 Appendix 63

Deleting Drivers When Creating a New Printer
Select the printer driver. Click Delete.
Be sure that you do not delete the generic printer driver, and remember that drivers deleted from Server Installations are no longer available to other users who are using the same Server Installation. If the printer has more fonts built in than the usual PostScript fonts, you must also load the AFM files for these additional fonts. Copy the AFM files into the {installpath}/share/psprint/fontmetric directory or into the {installpath}/user/psprint/fontmetric directory. You can find AFM files, for example, at ftp://ftp.adobe.com/pub/adobe/type/win/all/afmfiles/.
Changing Printer Settings
In the printer administration program spadmin, select the printer from the Installed printers list box and click Properties. The Properties dialog appears containing several tab pages. This is where you can make settings that are used according to the PPD file of the selected printer.
Select the command on the Command tab page. You can remove superfluous commands using the Remove button.
Linux users using the CUPS printing system with the KDE desktop should set the print command to kprinter -stdin. Gnome desktop users should use the Gnome equivalent.
On the Paper tab page, you can define the paper format and paper tray to be used as the default settings for this printer. On the Device tab page, you can activate the special options for your printer. If your printer can only print in black and white, choose "grayscale" under Color, otherwise choose "color". If switching to grayscale leads to unfavorable results, you can also select "color" under Color and see how the printer or PostScript emulator applies it. Furthermore, on this tab page you can set the precision with which colors are described as well as the PostScript level. The Font Replacement tab page allows you to select a printer font type available in the printer for each font type installed on your computer. This way you

Chapter 5 Appendix 73

Valid Command Line Parameters
Parameter -help / -h / -? -writer -calc -draw -impress -math -global -web -minimized -invisible Meaning Lists the available command line parameters in a dialog box. -help shows a long help text, -h shows a short help text. Starts with an empty Writer document. Starts with an empty Calc document. Starts with an empty Draw document. Starts with an empty Impress document. Starts with an empty Math document. Starts with an empty global document. Starts with an empty HTML document. Starts minimized. The splash screen is not displayed. Starts in invisible mode. Neither the start-up logo nor the initial program window will be visible. However, the OpenOffice.org software can be controlled and documents and dialogs opened via the API. When the OpenOffice.org software has been started with this parameter, it can only be ended using the taskmanager (Windows) or the kill command (UNIX based systems). It cannot be used in conjunction with -quickstart. More information is found in the OpenOffice.org Developer's Guide. Disables restart and file recovery after a system crash. Activates the Quickstarter. The splash screen is not displayed. Registers some UNO services and ends. The splash screen does not appear.
-norestore -quickstart -terminate_after_init
More information is found in the OpenOffice.org Developer's Guide. -accept={UNO string} Notifies the OpenOffice.org software that upon the creation of "UNO Acceptor Threads", an "UNO Accept String" will be used. More information is found in the OpenOffice.org Developer's Guide.
74 OpenOffice.org 1.1 Setup Guide
Parameter -userid={user id}
Meaning Specifies a user's directory that is used instead of the data from the soffice.ini, bootstrap.ini and sversion.ini files. More information is found in the OpenOffice.org Developer's Guide. Prints the files {filename1} {filename2}. to the default printer and ends. The splash screen does not appear. If the file name contains spaces, then it must be enclosed in quotation marks. (for example, "C:\My File.sxw") Prints the files {filename1} {filename2}. to the printer {Printername} and ends. The splash screen does not appear. If the file name contains spaces, then it must be enclosed in quotation marks. (for example, "C:\My File.sxw") Opens {filename} for editing, even if it is a template. Creates a temporary copy of {filename} and opens it readonly. Creates a new document using {filename} as a template. Disables the splash screen at program start. Sets the DISPLAY environment variable on UNIX based platforms to the value {display}. This parameter is only supported by the start script for the OpenOffice.org software on UNIX based platforms. Starts in "headless mode" which allows using the application without user interface. This special mode can be used when the application is controlled by external clients via the API.

-p {filename1} {filename2}.
-pt {Printername} {filename1} {filename2}.
-o {filename} -view {filename} -n {filename} -nologo -display {display}

-headless

Registering OpenOffice.org
The registration dialog window appears the second time you start OpenOffice.org. You can also access this dialog by choosing Help Registration in any OpenOffice.org application. You can modify the registration dialog by editing the common.xml file in the {installpath}/share/config/registry/instance/org/openoffice/Office/ directory. To permanently deactivate the registration dialog, set the value of RequestDialog

Chapter 5 Appendix 75

under Registration to 0. To permanently deactivate the registration menu command, set ShowMenuItem under Registration to false: <Registration> <RequestDialog cfg:type="int">0</RequestDialog> <ShowMenuItem cfg:type="boolean">false</ShowMenuItem> </Registration>
76 OpenOffice.org 1.1 Setup Guide
The OpenOffice.org software can be extended using the tools in the OpenOffice.org Software Development Kit (SDK). Typically, these extensions include shared libraries, Java class files, OpenOffice.org Basic scripts, or new interface type descriptions. For more information on creating extensions for the OpenOffice.org software, refer to the OpenOffice.org Developer's Guide. The special package manager pkgchk is installed and registered by the OpenOffice.org setup application. It is located in the {office_install}/program directory. The syntax for using the package manager is: pkgchk <switches> [package1 package2.] Switches: -s or --shared -r or --renewal -v or --verbose -l <file> or --log <file> --strict_error --supersede_basic_libs -h or --help Checks/installs shared components Re-installs all packages (in case of cache errors) Prints verbose output during installation Writes to a custom log <file> Terminates package installation immediately when an error occurs Overwrites existing basic library entries of the same name Prints a short help text
If you run pkgchk without any parameters, only the {office_install}/user/uno_packages directory is scanned for the following changes:
If a new extension package file is found, the extension is installed for the current user. If an extension package file for an installed extension is missing, the corresponding extension is de-registered. If an extension package file for an installed extension differs from the original extension package file, the corresponding extension is updated.
If you start pkgchk with a package file name and path as parameter, the corresponding package file is copied to the {office_install}/user/uno_packages directory and installed.

Chapter 5 Appendix 77

If you start pkgchk with -shared or -s and a package file name and path as parameter, the corresponding package file is copied to the {office_net_install}/share/uno_packages directory and installed for all users of a network installation (shared).

Installing, Updating and Removing Extensions for a Single User
1. Close all OpenOffice.org windows. Ensure that you exit all OpenOffice.org applications, including the Quickstarter. 2. Do one of the following:
To install an extension package, copy the package to {office_install}/user/uno_packages. To update an extension package, copy the updated package to {office_install}/user/uno_packages, and ensure that it overwrites the existing package. To remove an extension package, delete the package from the {office_install}/user/uno_packages directory.
3. Run pkgchk in the {office_install}/program directory. The package manager tool scans the {office_install}/user/uno_packages directory for extension packages and performs all necessary installation or de-installation steps. After the package is installed, do not remove the package file from the directory. You can find a list of all actions performed by the package manager in {office_install}/user/uno_packages/cache/log.txt.
78 OpenOffice.org 1.1 Setup Guide
Installing, Updating and Removing Extensions for Multiple Users
1. Close all OpenOffice.org windows. Ensure that you exit all OpenOffice.org applications locally and on the Server. This includes the Quickstarter. 2. Do one of the following (where {office_net_install}/share is the shared directory of the Server Installation):
To install an extension package, copy the package to the {office_net_install}/share/uno_packages directory. To update an extension package, copy the updated package to the {office_net_install}/share/uno_packages directory, and ensure that it overwrites the existing package. To remove an extension package, delete the package from the {office_net_install}/share/uno_packages directory.
3. Run pkgchk -shared in the {office_net_install}/program directory. The package manager tool scans the {office_install}/user/uno_packages directory for extension packages and performs all necessary installation or de-installation steps. After the package is installed, do not remove the package file from the directory. You can find a list of all actions performed by the package manager in {office_install}/user/uno_packages/cache/log.txt.

Chapter 5 Appendix 79

OpenOffice.org 1.0

Setup Guide

April 2002, Revision D

Contents

1. OpenOffice.org Setup Guide Icons in the Documentation 5
2. The OpenOffice.org Installation Installation Types 9 11
General Installation Tips System Requirements
Preparing the Installation 3. Single-User Installation Installation Requirements Starting the Installation The Setup Procedure Welcome 13 14
Important Information License Agreement User Data 18 Type of Installation Component Selection Installation Directory
Concluding the Installation Options
Assigning File Types Copying the Files 25
Java Runtime Environment Concluding the Installation Starting OpenOffice.org 27
4. Multi-User or Network Installation Installation Phase 41 52
Installation Requirements Starting the Installation The Setup Procedure Workstation Installation Starting the Installation The Setup Procedure Starting OpenOffice.org 5. Appendix 53
Installation Requirements
Automated Installation under Unix Setting up Printers 54 57
Setting up Printer, Fax and Fonts under Unix Using Fax Functionality Installing Fonts 59
Connecting a PostScript for PDF Converter
Installing a patch under the Solaris Operating Environment Modifying the OpenOffice.org Installation Modify Repair Remove 63

Setup Parameters

OpenOffice.org 1.0 Setup Guide

CHAPTER

OpenOffice.org Setup Guide
Icons in the Documentation
There are three icons used to call your attention to additional helpful information. The "Important!" icon points out important information regarding data and system security. The "Note" icon points out extra information: for example, alternative ways to reach a certain goal. The "Tip" icon points out tips for working with the program in a more efficient manner.
OpenOffice.org 1.0 Setup Guide April 2002
The OpenOffice.org Installation

Installation Types

This chapter gives you general information on the different types of installation, the prerequisites for installation and the installation process. Information on how to modify an existing OpenOffice.org installation can be found in the Appendix under Modifying the OpenOffice.org Installation on page 62. The following table explains the different types of installation and when they are applicable. Installation Type Single-User Installation Usage OpenOffice.org is installed on one computer for a single specific user only (NOT recommended for Unix/ Linux). OpenOffice.org is installed for multiple users on a computer or installed on a network computer for collective use. This installation consists of two phases, in the first phase (typically done by root or admin) all shared components are installed on a single computer, and the second phase, a Workstation Installation in which user specific files and configurations are installed. The Single-User Installation is most suited for use with single-user operating systems and should typically NOT be used for Unix.
Multi-User or Network Installation
A simple installation script that helps to simplify the process of installation is available for Unix users. Examples of its use:
./install./install --prefix=/opt

# do a multi-user installation into /usr/local # do a multi-user installation into /opt
Type./install --help for syntax and see Automated Installation under Unix in the Appendix on page 53.
In the Appendix, we describe how the OpenOffice.org Printer Administration Utility spadmin for Unix is used to set up printers, faxes and fonts for OpenOffice.org.
General Installation Tips

System Requirements

General System Requirements
250 MB available hard-disk space Graphics capabilities of at least 800 x 600 resolution and 256 colors
Special System Requirements for the Solaris Operating Environment on the SPARC Platform
Operating Environment Solaris 7 or 8 (for support of Asian languages, Solaris 8 is recommended) Solaris 8 requires patches 108434-01 and 108435-01 (64 bit) For the support of Asian languages, the additional patch 108773-12 is required for Solaris 8. Solaris 7 requires patches 106327-08, 106300-09 (64 bit) XServer (with at least 800x600, 256 colors) with window manager (e.g. OpenWindows, CDE, GNOME) 128 MB RAM
Patches for the Solaris Operating Environment can be found at http://sunsolve.sun.com.

Chapter 2

Special System Requirements for the Solaris Operating Environment on the Intel Platform
PC with Pentium or compatible processor Operating Environment Solaris 7 or 8 (for support of Asian languages, Solaris 8 is recommended) Solaris 8 requires patch 108436-01 For the support of Asian languages, the additional patch 108774-12 is required for Solaris 8. Solaris 7 requires patches 106328-08 XServer (with at least 800x600, 256 colors) with window manager (e.g. OpenWindows, CDE, GNOME) 64 MB RAM Patches for the Solaris Operating Environment can be found at http://sunsolve.sun.com.
Special System Requirements for Linux (x86 and PPC)
PC with Pentium or compatible processor, or PowerPC processor Linux Kernel 2.2.13 or higher XServer (with at least 800x600, 256 colors) with window manager (e.g. GNOME) 64 MB RAM Installed glibc2 version 2.1.3 or higher (glibc2 version 2.2.1 or higher for PPC Linux)
Special System Requirements for Windows
Windows 95 or higher. For the support of Asian languages, Windows 98 or higher is required. (Windows 2000 is recommended) PC with Pentium or compatible processor 64 MB RAM
Preparing the Installation
Expand the compressed installation file for your operating system into a temporary directory of your choice. This will create a subdirectory called installer containing all files of the installation set and the setup routine.

You can find important installation tips in the files: readme.txt (Windows) or README (Solaris and Linux) in the installation directory. We strongly recommend that you read these files because they may contain information that only became available after this guide was printed. The installation process can be stopped at any time by clicking the Cancel button. You will then not be able to run OpenOffice.org. You can have the installation directory automatically removed after you cancel the installation. Please note, however, that in that case all files and subfolders contained therein will also be removed.
For Windows NT / 2000 and for Win9x versions which have been setup for multi-user operation: In these versions the sversion.ini file will not be written into the Windows directory but rather into the user data directory set up for each user (for example, in C:\Documents and Settings\Username\Application Data).
There is a special installation script called install available to help automate the installation procedure under Unix which is described in detail in Automated Installation under Unix in the Appendix on page 53.

Single-User Installation

The single-user installation is what you use to set up OpenOffice.org on one computer for one specific user only. When installing OpenOffice.org as a single-user installation, log in to the system as that single specific user and install OpenOffice.org in any directory of your choice to which you have full access rights. This type of installation should typically NOT be used on Unix / Linux systems. Since Unix systems are rarely ever restricted to a single specific user, using the supplied install script or using the Multi-User / Network installation method is strongly recommended.
The directory into which OpenOffice.org is to be installed should have approximately 190 to 250 MB of free space, depending on the installation options you select. You will also need up to 40 MB of additional space for temporary files during installation. After successful completion of the installation, the temporary files will be automatically deleted.

Starting the Installation
If you have already installed a previous version of OpenOffice.org, you should first check to see if this file exists:
.sversionrc file in your Unix home directory or sversion.ini file in the Windows user directory.
This file contains the path and version number of an already installed OpenOffice.org. If the version number is identical to the version number of the OpenOffice.org to be installed, you must deinstall the old OpenOffice.org version before you can install the new one.
If necessary, log in to the system with your user name. You do not need any system administrator rights for a single-user installation. Under Unix, go to the graphical X Window interface if it was not already automatically activated. Go to the directory where the installation files reside either by command line in a terminal window or through the File Manager. Start the installation script with the command./setup
Under Windows, you can use the Windows Explorer to run the OpenOffice.org setup program. To start the setup program with a parameter, open the Start menu on the Windows Start bar, select the Run. command and enter the following line in the text box (you can also use the Browse button to find the file and to correctly enter the path in the text box): X:\{tempdir}\install\setup.exe -parameter where X:\{tempdir} is the temporary directory where the installation files reside after decompressing the downloaded installation file. To run the single-user installation, you do not have to give the setup program parameters. More information on setup parameters can be found in the Appendix.

The Setup Procedure

Welcome
The first thing to appear on the screen is a welcome dialog.
In many of the setup program dialogs you will see a Help button which displays brief information about the current dialog. After you have read the Help text, use the Back button to return to the setup program. Do NOT close the Help with the "X" system button (top right) as this would exit the setup program.
Confirm the Welcome dialog by clicking the Next button.

Chapter 3

Important Information
Now a window appears containing the readme.txt file (Windows) or README file(Solaris and Linux). This file can also be opened and read from the OpenOffice.org directory after the installation process is completed.
Read the information and confirm by clicking Next.

License Agreement

The next dialog contains the license agreement.

Carefully read the license agreement. If you agree to all points, click Accept to continue with the installation. If you do not agree to the license agreement click Cancel. In the latter case OpenOffice.org will not be installed.

User Data

You will now see the Enter User Data dialog.
Enter your personal data. The data entered here will be used in fields in OpenOffice.org, for example, to automatically insert your data into the corresponding fields in letter and fax templates. You can also access this dialog later by choosing Tools - Options OpenOffice.org - User Data.
Click Next to continue the installation.

Type of Installation

The next dialog in the OpenOffice.org setup program allows you to select the type of installation to be carried out. The memory requirements shown here are approximates based on the cluster sizes of the next target directory containing sufficient free space.
We recommend the Standard Installation for most users. This generally means that all of the components will be installed together with a selection of filters. If you select this option you will only be prompted to specify the directory in which OpenOffice.org is to be installed. In the Custom Installation you also first see a dialog for selecting the installation directory. Then, in the subsequent dialog, you select the individual components to be installed. The Minimum installation will only install those components that are required to run OpenOffice.org. If this is chosen the Help files will not be installed nor will the majority of the samples and templates. After choosing this option you will only be required to enter the name of the directory in which OpenOffice.org is to be installed.
Select the type of installation suitable to your needs. Click Next to continue the installation.

Component Selection

If you have selected the Custom Installation you will now see a dialog for selecting the components to be installed.
As a rule, all of the components which have a colored box next to their name will be installed. If you do not want to install a particular component, click the box next to the name and it will change to gray. Each time you click one of the boxes, it will change from colored to gray or vice versa, and the corresponding component and all subordinate components will either be part of the installation (colored) or not part of the installation (gray). When you click the plus sign next to the name of a component, a list of the subordinate components will be revealed. Again, clicking the individual boxes will either include the components in or exclude them from the installation. If a group entry contains components to be installed as well as components excluded from installation, the box in front of the group entry will appear semi-transparent. For example, the box in front of the OpenOffice.org Writer text filters is by default semi-transparent because the default setting does not include all filters. You can use the Default button, to restore the settings that were originally shown when the dialog was opened for the first time. Entries shown in red denote that these components will be installed no matter what and that they cannot be deselected. Select the modules and components you want to include in the installation.

Installation Directory

The next dialog to appear is for selecting the installation directory.
In the top part of the dialog, there is a list of the drives on your system with details regarding how much space is required and how much space is available. The amount of memory required can differ due to different drives and cluster sizes.
You can also select the installation path from a selection dialog by clicking Browse or by directly entering the path in the text box. If the directory entered does not exist, you will be asked if it should be created. OpenOffice.org will install files and other subfolders with files in the directory you specify. Click Next to continue the installation.
A dialog will inform you that all of the details needed to copy the program files have been entered.
Click Install to continue the installation.

Assigning File Types

In the following dialog, select which additional file types are to be opened with OpenOffice.org. OpenOffice.org will be registered in the operating system as the default program for these file types.
Select the file types that OpenOffice.org is to open in addition to its own file types. To use OpenOffice.org as default editor for HTML files (Web pages), mark the check box under Default HTML Editor. This setting only applies to editing HTML files. They will be opened with your browser (e.g. Netscape). Click OK.

Java Runtime Environment

The next dialog to appear lists the Java Runtime Environment versions registered in your system.
In this dialog, select the Java Runtime Environment you want to use. You require version 1.3.1 or higher. If you have already installed a newer version than 1.3.1, you do not have to install the version provided as long as OpenOffice.org identifies your version as verified.
Select the preferred option and click OK.

Copying the Files

On screen, you will see how the installation is progressing and approximately how much time is left till the installation is complete.
Concluding the Installation
After the process of copying and registering the files is finished, you will see the final dialog.

./install --help

for its syntax or see Automated Installation under Unix in the Appendix for more information.
Call the Setup.exe program from the installation directory using the -net parameter. To start the setup program by using a parameter, open the Start menu on the Start bar, select the Run. command and enter the following line in the text box (you can also use the Browse button to find the file and to correctly enter the path in the text box): X:\{tempdir}\install\setup.exe -net where X:\{tempdir} is the temporary installation directory where the installation files reside after decompressing the downloaded installation file.

Chapter 4

Now a window appears containing the readme.txt file (Windows) or README file (Solaris and Linux). This file can also be opened and read from the OpenOffice.org directory after the installation process is completed.
When installing OpenOffice.org on a network server you should install all of the available components. To do this select the Custom Installation and select all of the options contained in the dialog following on from the next one in which a directory is chosen.
Select Custom Installation. Click Next to continue the installation.
Select a directory in which all users have read and execute rights so that the workstation installations can be carried out.
As a rule, all of the components which have a colored box next to their name will be installed. If you do not want to install a particular component, click the box next to the name and it will change to gray. Each time you click one of the boxes, it will change from colored to gray or vice versa, and the corresponding component and all subordinate components will either be part of the installation (colored) or not part of the installation (gray). When you click the plus sign next to the name of a component, a list of the subordinate components will be revealed. Again, clicking the individual boxes will either include the components in or exclude them from the installation. If a group entry contains components to be installed as well as components excluded from installation, the box in front of the group entry will appear semi-transparent. For example, the box in front of the OpenOffice.org Writer text filters is by default semi-transparent because the default setting does not include all filters. You can use the Default button, to restore the settings that were originally shown when the dialog was opened for the first time. Entries shown in red denote that these components will be installed no matter what and that they cannot be deselected.
Select the modules and components you want to include in the installation. Click Next to continue the installation.
Now, with the aid of the workstation installation, each user can install OpenOffice.org in his or her Home directory or local hard disk.

As system administrator, you can also call the printer administration utility spadmin in order to, among other things, define printer settings for the individual user installations and to install fonts. You can find more details on spadmin in the Appendix.

Workstation Installation

Every user can carry out a user installation under his or her login name by calling the setup program from the installation made in Phase 1.
About 2 to 4 MB of free space is required on the hard disk where OpenOffice.org is to be installed.
Before the workstation installation can be initiated, a Phase 1 installation must have been carried out successfully as described under Installation Phase 1 on page 29. If you have already installed a previous version of OpenOffice.org, you should first check to see if this file exists:
Log in to the system with your user name. Go to the graphical X Window interface. Open a terminal window and use the command line to go to the network installation path on the server and then to the program sub-directory. If the server installation was made in the directory /opt/OpenOffice.org1.0, this could be done using the command: cd /opt/OpenOffice.org1.0/program Start the installation script with the command./setup
Run the Setup.exe program located in the network installation directory on the server. When working under Windows you can use the Windows Explorer to call up the setup program.
Select the Workstation Installation as your user installation. Only the files that contain variable data for a user will be installed. The Local Installation option installs a complete OpenOffice.org locally. The server installation serves as the source.
Under Windows in the Start menu under programs / OpenOffice.org 1.0, you will now find menu entries for starting the various OpenOffice.org components that have been installed. During the OpenOffice.org installation, a link is created in the autostart folder of the Windows Start menu. This link leads to the OpenOffice.org Quickstarter, which is available in the system tray after you restart your system. Right-click the Quickstarter icon to activate a context menu from which you can start various OpenOffice.org components. Detailed information on Quickstarter functionality can be found in the Help under the word "Quickstart". To start OpenOffice.org under Unix, go to the OpenOffice.org1.0/program directory, or to the local OpenOffice.org directory in your home directory, and start OpenOffice.org with the command./soffice You can also place the OpenOffice.org1.0/program directory into the path for programs under Unix. You will then be able to start OpenOffice.org by using the command "soffice" in any directory. To set up the default printer, call the Printer Administration Utility spadmin, which is described in the Appendix. After completing the installation process under the Solaris Operating Environment, you should log out and log in again to update the CDE integration.

Setting up Printers

Under Unix, OpenOffice.org only offers direct support for PostScript printers. Other printers must be set up as described in the section Printer Drivers in OpenOffice.org. OpenOffice.org automatically provides a printer with the default driver for each system queue. You can add additional printers as needed.

Adding a Printer

1. Click the New Printer button. 2. Select the Create Printer option and click Next.
3. Select the appropriate driver for your printer. If you are not using a PostScript printer or your model is not listed, use the "Generic Printer" driver or follow the steps below. You can also add new drivers using the Import button or delete unnecessary drivers using the Delete button (see below for details). Click Next. 4. Choose a command line that you can use to print on your printer (for example, lp -d my_queue). Click Next. 5. Give the printer a name and determine whether it should become the default printer. Click Finish. 6. To print a test page, click on Test Page. If the test page fails to print or is incorrectly printed, check all settings as described in Change Printer Settings. You now have a new printer in OpenOffice.org.
Printer Drivers in OpenOffice.org
When installing a non-PostScript enabled printer, you must set your system so that PostScript can be converted into the language of the printer. We recommend using current PostScript conversion software such as Ghostscript (http://www.cs.wisc.edu/~ghost/). You should set up the "Generic Printer" in that case. Make sure the page margins are set correctly as well. You can find this information in the following sections. If you are in possession of a PostScript-enabled printer, you must always install a description file that adapts the printer (PostScript Printer Definition - PPD) so that you can utilize the paper tray selection, the duplex print function (if the printer has it) and any built-in fonts. You can also use the generic printer driver since it contains the most important data and is suitable for most printers. In that case, you will have to do without the paper tray selection and correctly set the page margins. Some PPD files are installed as default files. If there is no matching PPD file for your printer, you will find various PPD files at http://www.adobe.com/products/printerdrivers/. You can also ask the manufacturer of your printer for PPD files. Unpack a suitable driver and connect it with spadmin to your system.
Drivers can be imported or deleted when creating a new printer.
To import new drivers, click Import in the driver selection dialog. Click Browse to select the directory where you unpacked the PPD files. In the Selection of drivers list box, select the printer driver you want to install and then click OK.

Chapter 5 Appendix

To delete a printer driver, select the printer driver and click Delete. Be sure that you do not delete the generic printer driver, and remember that drivers deleted from network installations are no longer available to other users who are using the same network installation. If the printer has more fonts built in than the usual PostScript fonts, you must also load the AFM files for these additional fonts. Copy the AFM files into the OpenOffice.org1.0/share/psprint/fontmetric directory of the OpenOffice.org installation or into the OpenOffice.org1.0/user/psprint/fontmetric directory of the User Installation. You can find AFM files, for example, at ftp://ftp.adobe.com/pub/adobe/type/win/all/afmfiles/.

Changing Printer Settings
In the printer administration program "spadmin", select the printer from the Installed printers list box and click Properties. The Properties dialog appears containing several tab pages. This is where you can make settings that are used according to the PPD file of the selected printer.
Select the command on the Command tab page. You can remove superfluous commands using the Remove button. On the Paper tab page, you can define the paper format and paper tray to be used as the default settings for this printer. On the Device tab page, you can activate the special options for your printer. If your printer can only print in black and white, choose "grayscale" under Color, otherwise choose "color". If switching to grayscale leads to unfavorable results, you can also select "color" under Color and see how the printer or PostScript emulator applies it. Furthermore, on this tab page you can set the precision with which colors are described as well as the PostScript level. The Font Replacement tab page allows you to select a printer font type available in the printer for each font type installed on your computer. This way you can reduce the data volume sent to the printer. Font replacement can be turned on or off for each printer individually. You should also set the page margins correctly on the Additional settings tab when using the generic printer drivers so that your printout is not cropped. You can also enter a description in the Comments field, which will also be displayed on the Print dialog.
Some of these settings can also be set per document/printout in the Print dialog or the Printer Settings dialog in OpenOffice.org via the Properties button.
Renaming or Deleting Printers
Select a printer from the Installed printers list box. To rename the selected printer, click Rename. Enter an appropriate name in the dialog that appears and click OK. The name must be unique and should be chosen so that you can recognize the printer and the application. Printer names must be assigned the same for all users because, when documents are exchanged, the selected printer remains unchanged if the recipient has it under the same name. To delete the selected printer, click Remove. The default printer or a printer that has been created by the system administrator in a network installation cannot be removed using this dialog.
Selecting a Default Printer
To make the printer selected from the Installed printers list box the default printer, double-click its name or click the Default button.

If a PostScript for PDF converter such as Ghostscript or Adobe Acrobat Distiller(tm) is installed on your computer, you can quickly create PDF documents in OpenOffice.org. 1. Click New Printer. This opens the Add Printer dialog. 2. Select Connect a PDF converter. Click Next. 3. Choose whether to use the default driver, the Acrobat Distiller driver or another driver. Click Next. If you are not using the default driver or the Acrobat Distiller driver, select the appropriate driver and click Next. 4. In the next dialog, enter a command line with which to communicate with the PostScript->PDF Converter. Moreover, enter the directory where the PDF files created should be saved. If you do not provide this directory, the user's home directory will be used. In the command line of each created PDF document "(TMP)" is replaced by a temporary file and "(OUTFILE)" by the target file, the name of which is created from the document name. If "(TMP)" occurs in the command line, the Postscript code is transmitted in a file, otherwise via standard input (i.e., as a pipe). If Ghostscript or Adobe Acrobat Distiller is in the search path, you can use one of the predefined command lines. Click Next. 5. Assign a name to your new PDF converter. Click Finish. You can now create PDF documents by printing to the converter that has just been created.

Installing Fonts

When you are working with OpenOffice.org you might notice that a different number of fonts is provided depending on the document type being used. This is because not all of the fonts can be used in every case.
Therefore, only those fonts will be shown in the font selection box when working with a text document which can also be printed, as it is assumed that you will only want to use those fonts that you can actually have printed on paper. In an HTML document or in online layout, only fonts that are available on screen are offered. On the other hand, when working with spreadsheets and drawings you will be able to use all of the fonts that can be either printed or shown on the screen.
OpenOffice.org tries to have the display on screen correspond to the printout (WYSIWYG). Possible problems using the font are shown in the bottom margin of the dialog you open by choosing Format Character.

Adding Fonts

You can integrate additional fonts in OpenOffice.org. Fonts which you integrate are available exclusively to OpenOffice.org and can be used with various Xservers without your having to install them there. To make the fonts available to other programs as well, proceed as usual by adding the fonts to your Xserver. OpenOffice.org can display and print out PostScript Type1 fonts as well as TrueType fonts (including TrueType Collections). To integrate additional fonts in OpenOffice.org, proceed as follows: 1. Start spadmin. 2. Click Fonts. 3. All fonts added for OpenOffice.org are listed in the dialog that appears. You can remove selected fonts using the Remove button or add new fonts with the Add button. 4. Click Add. The Add Fonts dialog appears. 5. Enter the directory from which you want to add the fonts. Press the. button and select the directory from the path selection dialog or enter the directory directly. 6. Now a list of the fonts from this directory appears. Select the fonts you want to add. To add all the fonts, click Select All.

Modifying the OpenOffice.org Installation
Calling the Setup program again after OpenOffice.org is already installed leads you to a dialog that allows you to either modify, repair or remove an existing installation. You can also call the setup program from the installation directory. If the setup program recognizes a OpenOffice.org installation, it will offer to repair the version on the hard drive.

Modify

If you select the Modify option, you will see the same dialog as for the Custom Installation. This dialog enables you to define which OpenOffice.org components you want to add or remove. The gray boxes represent the components which have not been installed. When you click a gray box, it will become colored indicating that that component will also be installed.
The components that have already been installed have a colored box in front of them. When you click such a box, it will be highlighted by a red mark which indicates that that component will be deleted from the installation. A plus sign in front of a component indicates that there is a group of components to be found there. To view the whole group, click the plus sign. Now you can select the individual components to install or delete. Please note that the graphics filters are listed under the "optional components".

Repair

Choose the Repair option in the OpenOffice.org Setup program to repair your OpenOffice.org when entries in the system registry are no longer correct. The repair function will try to restore unintentionally deleted program files.

Remove

Deinstallation deletes OpenOffice.org entries contained in the registry of the corresponding operating system and also the files mentioned in the previous paragraph. Furthermore almost all of the files and folders in the OpenOffice.org directory will be deleted except for those that you have created or altered after having installed the program or those needed by the setup program itself. Therefore, your documents and most of the settings will be kept. When working under Windows you can activate/ deactivate a check box which decides if files created in the OpenOffice.org folder are also to be deleted or kept. If you cannot immediately delete some of the program files under Windows, delete them directly after restarting your system. If you want to remove the server installation on the network, you have to completely delete the entire OpenOffice.org folder on the server. All user installations based thereon will be automatically deactivated.
The parameter -repair calls the setup program and repairs OpenOffice.org without any dialogs being displayed. The parameter -net or -n starts the server part of the network installation. In the parameter -D:destination_path the information you enter in place of "destination_path" specifies the path where OpenOffice.org is to be installed. In the parameter -F:application_name the information you enter in place of "application_name" specifies the name of an application that is to be started immediately after installation.