How-to Autoinstall using Response Files

[How-to Autoinstall using Response Files]
[1.0]
First edition: [2002/9/27]
First English edition: [2004/04/09 ]

Contents

Contents	1

Overview	4

Copyright and trademark information	4

Feedback	4

Acknowledgments	4

Modifications and updates	4

What is a Response File Installation?	5

How Do I Install OpenOffice with Response Files?	6

Preparing the Response File Installation	6

Preparing the Response File Installation	6

Testing the Response File	8

Install OpenOffice Using the Response File	8

Response File Structure and Sections	9

Response File Structure	9

Section Environment	9

[Environment]	9

Section Module_Specify	9

[Module_Specify]	9

Section Procedures	10

Section Java	10

Section Environment	10

Installation Mode	10

Values	10

Default -	10

InstallationType	11

Values	11

Default: STANDARD	11

DestinationPath	11

Values	11

Default: <firstfree> + directory name of DefaultPath from the setup script	11

StartProcedure	12

Value	12

Default: None	12

EndProcedure	12

Value	12

Default: None	12

Section Module_Specify	12

'ModulSetName' =	12

Values	12

Default: None	12

InstallModuleSet	12

Value	12

Default: None	12

DeInstallModuleSet	13

Value	13

Default: None	13

InstallProcedure	13

Value	13

Default: None	13

DeInstallProcedure	13

Value	13

Default: None	13

Section Procedures	14

Example:	14

Section Java	14

Values	14

Section Windows_Desktop_Integration	14

Values	14

4Setup Command Line Parameter	15

Running OpenOffice Setup with Parameters	15

-sdump	15

-debug	15

Script.Htm	16

Basic Setup	22

DirEntry. Function	22

Syntax	22

Return	22

Example	22

Hide/Show Setup. Function	22

Syntax	22

Return	22

Example	22

Error Return Codes in the Response File Mode	24

8 Example	25

Section Environment	25

Module Section Specification	25

Section Procedures	26

Real World Examples	29

For any *NIX environment	29

For Windows environments	33

Index	37

Public Documentation License, Version 1.0	38

Overview

This, the OpenOffice.org How-To, attempts to provide a method to automate a central installation, repair, configuration or deinstallation of OpenOffice by using response files.

Copyright and trademark information

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

The Original Documentation is “Comment Automatiser l'installation d'OpenOffice.org ”. The Initial Writer(s) of the Original Documentation is/are Frédéric Labbe Copyright (C) 2002. All Rights Reserved. (Initial Writer contact(s) fred@frederic-labbe.com).

The English Translation is “How-to Autoinstall using Response Files”. The Translator is/are G. Roderick Singleton © 2004. All Rights Reserved. (Initial Translator contact(s):G. Roderick Singleton <grsingleton@openoffice.org>.)

Contributor(s): G. Roderick Singleton.

Portions created by G. Roderick Singleton are Copyright © 2004. All Rights Reserved.

All trademarks within this guide belong to legitimate owners.

[Note: a copy of the PDL is included in this template and is also available at:
http://www.openoffice.org/licenses/PDL.rtf.]

Feedback

Please direct any comments or suggestions about this document to:
grsingleton@openoffice.org

Acknowledgments

Modifications and updates

Version	Date	Description of Change
[0.1]	[2004-04-09]	[grs: Initial translation issued for comment]
[0.2]	[2004-07-06]	[grs: Revised to use new template]

What is a Response File Installation?

To install, you need a valid OpenOffice installation set and a OpenOffice Setup program. After starting the Setup, you can select various parameters for the installation. For example, you can define which OpenOffice Module you want to install.

When installing OpenOffice in a network, it needs to be installed or adapted to manage a large number of users, and therefore, installation or configuration by the user or administrator at each workstation is not always the best solution.

For this reason, you, as administrator now have the possibility to automate a central installation, repair, configuration or deinstallation of OpenOffice by using response files. The response file takes over control of the OpenOffice Setup program. You can, for example, enter the following information for the OpenOffice network installation:

Which option should be run: installation, repair, configuration, deinstallation?

Which modules are to be installed or deinstalled?

For which user/user group should the actions be executed?

At the same time you can define different OpenOffice sets and assign these to specific user groups by means of parameters. Similarly you can also define further information, rules or restrictions in Basic scripts and run them during 'StartofSetup', 'Installation' and 'EndofSetup'.

Information about the basic structure and the individual components of a OpenOfficeSetup response file is listed below. Explanations are also contained showing which Basic commands can be used together with a response file installation. Finally you will be shown the actual methodology by means of a practical example of a response file.

How Do I Install OpenOffice with Response Files?

The process followed during a OpenOffice remote installation when a response file is used is outlined below:

Preparing the response file installation

Creating a response file

Testing a response file

Installing OpenOffice using a response file

Preparing the Response File Installation

You need to have the following to install OpenOffice using response files:

A valid OpenOffice installation set

Access to the client computer

The functioning response file

You can create a response file. The process followed during a OpenOffice remote installation when a response file is used is outlined below:

Preparing the response file installation

Creating a response file

Testing a response file

Installing OpenOffice using a response file

Preparing the Response File Installation

You need to have the following to install OpenOffice using response files:

A valid OpenOffice installation set

Access to the client computer with any editor program.

Creating a Response File

To create a response file:

Define which actions are to be run for which user group.

Define the rules for running the actions.

Define whether you want to allow user feedback when running the actions.

Write the response file.

Test the response file.

Run the response file.

The individual features of working with response files are shown at the end of this booklet in the form of a detailed practical example.

Testing the Response File

Proceed as follows to test a response file:

Create a new directory on a network drive.

Alter the path details in your response file to match those of this network path.

Run the response file from a shell.

Check the results of the response file setup in the specified drive.

NOTE:The return codes produced by the response file can be shown in a message box by entering the –debug setup command line parameter. This allows you to see if the response file functions as required.

Install OpenOffice Using the Response File

To install OpenOffice by using response files:

Define in the response file which OpenOffice modules are to be installed.

Define the installation path.

Run the response file.

Check the installation, if necessary.

Response File Structure and Sections

This section contains a detailed description of the response file structure needed for the OpenOffice Setup, the components used and how they function.

Response File Structure

Section Environment

[Environment]

The Environment section describes all of the entries needed when installing with a response file. These entries are normally carried out by the user in the OpenOffice Setup or are transferred using parameters. The following keys have been defined for this purpose:

InstallationMode

InstallationType

DestinationPath

StartProcedure

end procedure

Section Module_Specify

[Module_Specify]

Use this section to compose individual OpenOffice module sets and assign them to an installation or deinstallation procedure. You are able to define any combination of the modules found in the setup script. The modules can be accessed by using either the module name or a module ID.

NOTE: Use the –sdump setup command lines parameter to create a setup script file. Also see the setup command lines parameter.

'ModulSetName'

InstallModuleSet

DeInstallModuleSet

InstallProcedure

DeInstallProcedure

Migration

Section Procedures

In the Procedures section you can implement basic functions which can be assigned to different positions in the response file, for example, to the 'StartofSetup' or 'EndofSetup' intervals. These functions are independent and, therefore, cannot call each other.

Section Java

Use this section to determine if an existing Java installation is to be included.

Section Environment

Installation Mode

Values

INSTALL_NORMAL	Installs a local OpenOffice standalone version
INSTALL_NETWORK	Installs a OpenOffice network version
INSTALL_WORKSTATION	Installs a workstation version from an existing network installation
DEINSTALL	Deinstalls an existing OpenOffice version
REPAIR	Repairs a OpenOffice version
REINSTALL	Reinstalls a OpenOffice version
MIGRATION	If set to YES the migration is executed if an old version of OpenOffice is found. If set to NO or if the key is left out, the migration is not executed.

Default -

The InstallationMode sets the general context under which the response files are run. The INSTALL_NORMAL, INSTALL_NETWORK and INSTALL_WORKSTATION modes in the source medium should be used for initial installations. These three modes also orient themselves to the InstallationType while running. The 'INSTALL_WORKSTATION' mode can only be used with the setup found on a network installation.

The 'DEINSTALL', 'REPAIR' and 'REINSTALL' modes can only be used on installed versions. 'DEINSTALL' and 'REPAIR' do not need any further specifications and will be executed immediately. 'REINSTALL' evaluates the [MODULE_SPECIFY] section to determine which actions are to be carried out.

InstallationType

Values

STANDARD	Installs the module selection, defined as the default in the setup script
SPECIFY	Installs the module selection, defined in the
[MODULE_SPECIFY]	section
MINIMUM	Installs the module selection, defined in setup script as minimal
WORKSTATION	Copies only a small network installation onto the client

Default: STANDARD

The installation type is only valid in the 'INSTALL_*' modes. If the Setup is under the 'WORKSTATION' context, 'STANDARD' installs a complete executable network version locally on the client, the 'WORKSTATION' type, on the other hand, only installs a small network installation in this mode.

DestinationPath

Values

d:\OpenOffice
<firstfree>\OpenOffice
<home>\OpenOffice

Default: <firstfree> + directory name of DefaultPath from the setup script

You can enter the target path for an installation in absolute terms or relative to an identifier which the Setup replaces. '<firstfree>' will be replaced by the first drive letter found that has enough disk space to store the specified installation type (WIN/WNT). '<home>'will be replaced with the home directory (UNIX).

StartProcedure

Value

ProcedureName

Default: None

The 'StartProcedure' is run before all actions, including those procedures defined with BEFORE_INST in the setup script. The procedure must be implemented in the [PROCEDURES] section.

EndProcedure

Value

ProcedureName

Default: None

The 'EndProcedure' is run after all actions have taken place, including those procedures defined with AFTER_INST in the setup script. The procedure must be implemented in the [PROCEDURES] section.

Section Module_Specify

'ModulSetName' =

Values

ModuleName1, ModuleName2, ...

Default: None

This section is used to define a logical set of modules, which is then accessed through its name at different positions in the response file or via the SetupBASIC. Enter the module names as listed in the setup script after a self-defined name. The module names need to be written in a line and separated by commas. By using the Select- ModuleSet and DeSelectModuleSet functions you can access these module sets with SetupBASIC.

InstallModuleSet

Value

ModuleSetName

Default: None

Define the module set in the InstallModuleSet which is to be installed when a specific installation type refers to this section and the response file setup has been set in an installation context (e.g. INSTALL_NORMAL, REINSTALL).

DeInstallModuleSet

Value

ModuleSetName

Default: None

DeInstallModuleSet is used to define the module set to be deinstalled when a specific installation type or mode refer to this section and the response file setup has been set in a deinstallation context (e.g. DEINSTALL, REINSTALL).

InstallProcedure

Value

ProcedureName

Default: None

InstallProcedure is the name of the procedure that decides which modules are to be installed when an installation type or mode refer to this section. You can access the module sets by using SetupBASIC. The procedure has to be implemented in the [Procedures] section. If a InstallModuleSet is defined along with InstallProcedure in this section, the procedure will always be run.

DeInstallProcedure

Value

DeInstallProcedure

Default: None

DeInstallProcedure denotes the procedure that decides which modules are to be deinstalled when an installation type or mode refer to this section. You can access the module sets by using SetupBASIC. The procedure has to be implemented in the [Procedures] section. If you define an additional DeInstallModuleSet in the DeInstallProcedure in this section, the procedure will always be executed.

Section Procedures

The Procedures section is used to implement the Basic functions to be assigned to different positions in the response file. The functions are independent and cannot call each other.

Example:

Sub ProcedureName

Code ...

EndSub

Sub NextProcedureName

Code ...

EndSub

Section Java

This section defines if an existing Java installation is to be supported.

[Java]

JavaSupport=

Values

None	not supported
preinstalled_or_none	supports Java, if installed
newinstall installs	Java

If the 'newinstall' switch is being used, you have to manually operate the Java installation dialog.

Section Windows_Desktop_Integration

Under Microsoft Windows only, several keys can be used to suppress the registration of OpenOffice for Microsoft Office document types or as a default HTML editor.

Values

Register4MsWord	f set to NO OpenOffice will not register for MS Word files.
Register4MsExcel	f set to NO OpenOffice will not register for MS Excel files.
Register4MsPowerPoint	If set to NO OpenOffice will not register for MS Powerpoint files.
RegisterAsDefaultHtmlEditor	If set to NO OpenOffice will not register as default HTML editor.

4Setup Command Line Parameter

You can run OpenOffice Setup under different command line parameters:

[-sdump [-d:<destpath>]]

[-r:<response_file> [-debug]]

Running OpenOffice Setup with Parameters

To run OpenOffice Setup with one of the parameters:

Start OpenOffice Setup from a shell.

Enter the required parameter: Example: C:\OpenOffice\setup.exe -Parameter

-sdump

SDUMP (ScriptDump)

A Setup started with the SDUMP parameter creates a 'script.htm' HTML file which contains the module hierarchy of the current script. IMPORTANT: This file is written in the currently selected directory if you start the Setup from a CD. If you want to create the file in another directory, you can also enter the '-D:path' (DestinationPath) parameter. This HTML file helps you to define your own ModuleSets when writing response files.

-debug

This parameter sets the Setup to a Debug mode. If an error occurs while running a response file, the corresponding ExitCode and an error description will be displayed in an Error Box before quitting the program. This function is helpful when testing your own response file.

Script.Htm

An example of the HTML file 'script.htm' created with the –sdump setup parameter is found below. You can address each of the topics about the contents of a module set either by name or module ID in the response file.

Module	Module ID	Files	Size
OpenOffice	gid_Module_Root	430	217633 KB
OpenOffice ProgramModules	gid_Module_Prg	0	53579 KB
OpenOffice Writer	gid_Module_Prg_Wrt	0	22418 KB
Optional Text Filters	gid_Module_Prg_Wrt_Flt	0	13804 KB
ClarisWorks Import	gid_Module_Prg_Wrt_Flt_Claris	1	161 KB
Corel Word Perfect Import	gid_Module_Prg_Wrt_Flt_Wperfect	0	2302 KB
Corel Word Perfect (Win) 7.0	gid_Module_Prg_Wrt_Flt_Wperfect7	1	253 KB
Corel Word Perfect (Win) 6.1	gid_Module_Prg_Wrt_Flt_Wperfect61	1	253 KB
Corel Word Perfect (Win)	gid_Module_Prg_Wrt_Flt_Wperfect6	1	253 KB
Corel Word Perfect (Win) 5.X	gid_Module_Prg_Wrt_Flt_Wperfect52	1	170 KB
Corel Word Perfect (Mac) 3	gid_Module_Prg_Wrt_Flt_Wperfectmac3	1	133 KB
Corel Word Perfect (Mac) 2	gid_Module_Prg_Wrt_Flt_Wperfectmac2	1	133 KB
Corel Word Perfect (Mac) 1	gid_Module_Prg_Wrt_Flt_Wperfectmac1	1	98KB
Corel Word Perfect 6.1	gid_Module_Prg_Wrt_Flt_Wperfectdos61	1	253 KB
Corel Word Perfect	gid_Module_Prg_Wrt_Flt_Wperfectdos6	1	253 KB
Corel Word Perfect 5.1	gid_Module_Prg_Wrt_Flt_Wperfectdos51	1	170 KB
Corel Word Perfect 5.0	gid_Module_Prg_Wrt_Flt_Wperfectdos5	1	170 KB
Corel Word Perfect 4.2	gid_Module_Prg_Wrt_Flt_Wperfectdos42	1	80 KB
Corel Word Perfect 4.1	gid_Module_Prg_Wrt_Flt_Wperfectdos41	1	80 KB
CTOS DEF Import	gid_Module_Prg_Wrt_Flt_Ctos	1	103 KB
DataGeneral CEO Write Import	gid_Module_Prg_Wrt_Flt_Ceowrite	1	97 KB
DCA Import	gid_Module_Prg_Wrt_Flt_Dca	0	289 KB
DCA Revisable Form Text	gid_Module_Prg_Wrt_Flt_Dcarevisable	1	102 KB
DCA with Display Write 5	gid_Module_Prg_Wrt_Flt_Dcadispwrite	1	102 KB
DCA/FFT – Final Form Text	gid_Module_Prg_Wrt_Flt_Dcafft	1	84 KB
DEC Import	gid_Module_Prg_Wrt_Flt_Decimp	0	250 KB
DEC DX	gid_Module_Prg_Wrt_Flt_Decdx	1	91 KB
DEC WPS-Plus Import Filter	gid_Module_Prg_Wrt_Flt_Decwps	1	158 KB
DisplayWrite Import	gid_Module_Prg_Wrt_Flt_Dispwrt	0	205 KB
DisplayWrite 5.x Import	gid_Module_Prg_Wrt_Flt_Dispwrt5	1	102 KB
DisplayWrite 2.0-4.x	gid_Module_Prg_Wrt_Flt_Dispwrt2	1	102 KB
EBCDIC Import	gid_Module_Prg_Wrt_Flt_Ebcdic	1	66 KB
Enable Import	gid_Module_Prg_Wrt_Flt_Enable	1	86 KB
FrameMaker Import	gid_Module_Prg_Wrt_Flt_Fmaker	0	592 KB
FrameMaker MIF 4.0	gid_Module_Prg_Wrt_Flt_Fmaker4	1	197 KB
FrameMaker MIF 5.0	gid_Module_Prg_Wrt_Flt_Fmaker5	1	197 KB
FrameMaker MIF 3.0	gid_Module_Prg_Wrt_Flt_Fmaker3	1	197 KB
Frame Work Import	gid_Module_Prg_Wrt_Flt_Fwork	0	162 KB
Frame Work IV	gid_Module_Prg_Wrt_Flt_Fwork4	1	81 KB
Frame Work III	gid_Module_Prg_Wrt_Flt_Fwork3	1	81 KB
HP AdvanceWrite Plus Import	gid_Module_Prg_Wrt_Flt_Awrite	1	80 KB
ICL Office Power Import	gid_Module_Prg_Wrt_Flt_Icl	0	244 KB
ICL Office Power 7	gid_Module_Prg_Wrt_Flt_Icl7	1	122 KB
ICL Office Power 6	gid_Module_Prg_Wrt_Flt_Icl6	1	122 KB
Interleaf Import	gid_Module_Prg_Wrt_Flt_Interleaf	0	233 KB
Interleaf	gid_Module_Prg_Wrt_Flt_Interleafimp	1	101 KB
Interleaf 5-6	gid_Module_Prg_Wrt_Flt_Interleaf6	1	101 KB
Legacy Winstar onGo Import	gid_Module_Prg_Wrt_Flt_Legacy	1	107 KB
Lotus Ami Pro Import	gid_Module_Prg_Wrt_Flt_Amipro	1	162 KB
Lotus Manuscript Import	gid_Module_Prg_Wrt_Flt_Lotusman	1	136 KB
Mac Write Import	gid_Module_Prg_Wrt_Flt_Macwrite	0	332 KB
Mac Write Pro	gid_Module_Prg_Wrt_Flt_Macwritepro	1	121 KB
Mac Write II	gid_Module_Prg_Wrt_Flt_Macwrite2	1	105 KB
Mac Write 4.x/5.0	gid_Module_Prg_Wrt_Flt_Macwrite5	1	106 KB
MASS 11 Import	gid_Module_Prg_Wrt_Flt_Mass	0	269 KB
MASS 11 rel. 8.5 - 9.0	gid_Module_Prg_Wrt_Flt_Mass9	1	134 KB
MASS 11 rel.8.0 - 8.3	gid_Module_Prg_Wrt_Flt_Mass8	1	134 KB
Microsoft Word/WinWord Filters	gid_Module_Prg_Wrt_Flt_Mword	0	1335 KB
WinWord 2.x	gid_Module_Prg_Wrt_Flt_Mword2	1	200 KB
WinWord 1.x	gid_Module_Prg_Wrt_Flt_Mword1	1	200 KB
MacWord 5.x	gid_Module_Prg_Wrt_Flt_Mword5	1	157 KB
MacWord 4.0	gid_Module_Prg_Wrt_Flt_Macword4	1	157 KB
MacWord 3.0	gid_Module_Prg_Wrt_Flt_Macword3	1	157 KB
Word	gid_Module_Prg_Wrt_Flt_Dosword6	1	116 KB
Word 5.0	gid_Module_Prg_Wrt_Flt_Dosword5	1	116 KB
Word 4.0	gid_Module_Prg_Wrt_Flt_Dosword4	1	116 KB
Word 3.0	gid_Module_Prg_Wrt_Flt_Dosword3	1	116 KB
MS Works Import	gid_Module_Prg_Wrt_Flt_Msworks	0	423 KB
MSWorks 4.0 Mac	gid_Module_Prg_Wrt_Flt_Msworks4	1	143 KB
MSWorks 3.0Win	gid_Module_Prg_Wrt_Flt_Msworks3	1	140 KB
MSWorks 2.0 DOS	gid_Module_Prg_Wrt_Flt_Msworks2	1	140 KB
MultiMate Import	gid_Module_Prg_Wrt_Flt_Mmate	0	376 KB
MultiMate 4	gid_Module_Prg_Wrt_Flt_Mmate4	1	94 KB
MultiMate 3.3	gid_Module_Prg_Wrt_Flt_Mmate3	1	94 KB
MultiMate Adv. II 3.7	gid_Module_Prg_Wrt_Flt_Mmate37	1	94 KB
MultiMate Adv. 3.6	gid_Module_Prg_Wrt_Flt_Mmate36	1	94 KB
NAVY DIF Import	gid_Module_Prg_Wrt_Flt_Navy	1	77 KB
OfficeWriter Import	gid_Module_Prg_Wrt_Flt_Owriter	0	261 KB
OfficeWriter 6.x	gid_Module_Prg_Wrt_Flt_Owriter6	1	87 KB
OfficeWriter 5.0	gid_Module_Prg_Wrt_Flt_Owriter5	1	87 KB
OfficeWriter 4.0	gid_Module_Prg_Wrt_Flt_Owriter4	1	87 KB
Peach Text Import	gid_Module_Prg_Wrt_Flt_Peach	1	78 KB
PFS First Choice Import	gid_Module_Prg_Wrt_Flt_Pfs	0	319 KB
PFS First Choice 3.0	gid_Module_Prg_Wrt_Flt_Pfs3	1	106 KB
PFS First Choice 2.0	gid_Module_Prg_Wrt_Flt_Pfs2	1	106 KB
PFS First Choice 1.0	gid_Module_Prg_Wrt_Flt_Pfs1	1	106 KB
PFSWrite Import	gid_Module_Prg_Wrt_Flt_Pfswrite	1	106 KB
Professional Write Import	gid_Module_Prg_Wrt_Flt_Profwrt	0	375 KB
Professional Write Plus	gid_Module_Prg_Wrt_Flt_Profwrtplus	1	162 KB
Professional Write 2.x	gid_Module_Prg_Wrt_Flt_Profwrt2	1	106 KB
Professional Write 1.0	gid_Module_Prg_Wrt_Flt_Profwrt1	1	106 KB
Q&AWrite Import	gid_Module_Prg_Wrt_Flt_Qa	0	162 KB
Q&AWrite 4.0	gid_Module_Prg_Wrt_Flt_Qa4	1	81 KB
Q&AWrite 1.0 – 3.0	gid_Module_Prg_Wrt_Flt_Qa3	1	81KB
Rapid File Import	gid_Module_Prg_Wrt_Flt_Rapid	0	152 KB
Rapid File 1.2	gid_Module_Prg_Wrt_Flt_Rapid12	1	76 KB
Rapid File 1.0	gid_Module_Prg_Wrt_Flt_Rapid1	1	76 KB
SamnaWord IV Import	gid_Module_Prg_Wrt_Flt_Samna	1	80 KB
Total Word Import	gid_Module_Prg_Wrt_Flt_Tword	1	98 KB
Uniplex Import	gid_Module_Prg_Wrt_Flt_Uniplex	0	222 KB
Uniplex V7 - V8	gid_Module_Prg_Wrt_Flt_Uniplex8	1	115 KB
Uniplex onGO	gid_Module_Prg_Wrt_Flt_Uniplexongo	1	107 KB
VolksWriter Import	gid_Module_Prg_Wrt_Flt_Volkswrt	0	171 KB
VolksWriter Deluxe	gid_Module_Prg_Wrt_Flt_Volkswrtdlx	1	73KB
VolksWriter 3 and 4	gid_Module_Prg_Wrt_Flt_Volkswrt4	1	98 KB
Wang Import	gid_Module_Prg_Wrt_Flt_Wang	0	249 KB
Wang PC	gid_Module_Prg_Wrt_Flt_Wangpc	1	78 KB
Wang II SWP	gid_Module_Prg_Wrt_Flt_Wangswp	1	75 KB
Wang WP Plus	gid_Module_Prg_Wrt_Flt_Wangswpplus	1	96KB
Win Write 3.x Import	gid_Module_Prg_Wrt_Flt_Wwrite3	1	125 KB
WITA Import	gid_Module_Prg_Wrt_Flt_Wita	1	110 KB
WiziWord 3.0 Import	gid_Module_Prg_Wrt_Flt_Wiziword	1	107 KB
WordStar Import	gid_Module_Prg_Wrt_Flt_Wstar	0	1311 KB
WordStar 2000 Rel. 3.5	gid_Module_Prg_Wrt_Flt_Wstar200035	1	94KB
WordStar 2000 Rel. 3.0	gid_Module_Prg_Wrt_Flt_Wstar200030	1	94KB
WordStar 7.0	gid_Module_Prg_Wrt_Flt_Wstar7	1	145 KB
WordStar	gid_Module_Prg_Wrt_Flt_Wstar6	1	145 KB
WordStar 5.5	gid_Module_Prg_Wrt_Flt_Wstar55	1	145 KB
WordStar 5.0	gid_Module_Prg_Wrt_Flt_Wstar5	1	145 KB
WordStar 4.0	gid_Module_Prg_Wrt_Flt_Wstar4	1	145 KB
WordStar 3.45	gid_Module_Prg_Wrt_Flt_Wstar345	1	145 KB
WordStar 3.3x	gid_Module_Prg_Wrt_Flt_Wstar33	1	145 KB
WordStar 2000 1.x -2.0	gid_Module_Prg_Wrt_Flt_Wstar20001	1	107 KB
WriteNow 3.0 (Mac) Import	gid_Module_Prg_Wrt_Flt_Writenow3	1	112 KB
Writing Assistant Import	gid_Module_Prg_Wrt_Flt_Wassist	1	82 KB
XEROX XIF Import	gid_Module_Prg_Wrt_Flt_Xerox	0	802 KB
XEROX XIF (Res Graphic)	gid_Module_Prg_Wrt_Flt_Xerox6	1	200 KB
XEROX XIF (Color Bitmap)	gid_Module_Prg_Wrt_Flt_Xerox6color	1	200 KB
XEROX XIF 5.0	gid_Module_Prg_Wrt_Flt_Xerox5	1	200 KB
XEROX XIF 5.0 (Illustrator)	gid_Module_Prg_Wrt_Flt_Xerox5illu	1	200 KB
XyWrite Import	gid_Module_Prg_Wrt_Flt_Xywrite	0	789 KB
XyWrite (Win) 1.0	gid_Module_Prg_Wrt_Flt_Xywrite1	1	131 KB
XyWrite IV	gid_Module_Prg_Wrt_Flt_Xywrite4	1	131 KB
XyWrite III+	gid_Module_Prg_Wrt_Flt_Xywrite3p	1	131 KB
XyWrite III	gid_Module_Prg_Wrt_Flt_Xywrite3	1	131 KB
XyWrite Signature	gid_Module_Prg_Wrt_Flt_Xywritesign	1	131 KB
XyWrite Sig. (Win)	gid_Module_Prg_Wrt_Flt_Xywritesignwin	1	131 KB
Program Module	gid_Module_Prg_Wrt_Bin	6	2300 KB
OpenOffice Writer Help	gid_Module_Prg_Wrt_Help	2	5200 KB
OpenOffice Writer Templates	gid_Module_Prg_Wrt_Temp	6	640 KB
OpenOffice Writer Samples	gid_Module_Prg_Wrt_Sample	3	474 KB
OpenOffice Calc	gid_Module_Prg_Calc	0	10939 KB
OpenOffice Calc Program Module	gid_Module_Prg_Calc_Bin	4	5030 KB
OpenOffice Calc Help	gid_Module_Prg_Calc_Help	2	5036 KB
OpenOffice Calc Templates	gid_Module_Prg_Calc_Temp	3	284 KB
OpenOffice Calc Samples	gid_Module_Prg_Calc_Sample	1	215 KB
OpenOffice Add-in	gid_Module_Optional_Addins	5	372 KB
OpenOffice Impress	gid_Module_Prg_Impress	0	10264 KB
OpenOffice Impress Program Module	gid_Module_Prg_Impress_Bin	1	36 KB
OpenOffice Impress Help	gid_Module_Prg_Impress_Help	3	7007 KB
OpenOffice Impress Templates	gid_Module_Prg_Impress_Temp	5	2411 KB
OpenOffice Impress Samples	gid_Module_Prg_Impress_Sample	1	809 KB
OpenOffice Draw	gid_Module_Prg_Draw	0	7197 KB
OpenOffice Draw Program Module	gid_Module_Prg_Draw_Bin	1	36 KB
OpenOffice Draw Help	gid_Module_Prg_Draw_Help	3	7007 KB
OpenOffice Draw Templates	gid_Module_Prg_Draw_Temp	1	31 KB
OpenOffice Draw Samples	gid_Module_Prg_Draw_Sample	1	122 KB
OpenOffice Math	gid_Module_Prg_Math	0	2759 KB
OpenOffice Math Program Module	gid_Module_Prg_Math_Bin	5	660 KB
OpenOffice Math Help	gid_Module_Prg_Math_Help	1	2041 KB
OpenOffice Math Samples	gid_Module_Prg_Math_Sample	1	57 KB
OpenOffice Optional Components	gid_Module_Optional	0	59098 KB
OpenOffice Quickstarter	gid_Module_Optional_Quickstart	0	0 KB
OpenOffice General Help Modules	gid_Module_Optional_Help	0	0 KB
OpenOffice Basic Help	gid_Module_Optional_Help_Basic	0	0 KB
OpenOffice Additional Gallery Themes	gid_Module_Optional_Gallery	21	35704 KB
OpenOffice Java Environment Installation	gid_Module_Optional_Java	0	0 KB
OpenOffice Graphics Filters	gid_Module_Optional_Grfflt	0	754 KB
Adobe Photoshop Import Filter	gid_Module_Optional_Grfflt_Adobe	1	28 KB
TGA Import	gid_Module_Optional_Grfflt_Tga	1	28 KB
EPS Import/Export Filter	gid_Module_Optional_Grfflt_Eps	3	82 KB
XPM Export Filter	gid_Module_Optional_Grfflt_Xpm	1	24 KB
Portable Bitmap Import/Export	gid_Module_Optional_Grfflt_Pbmp	4	96 KB
SUN Rasterfile Import/Export	gid_Module_Optional_Grfflt_Sunrst	2	48 KB
GIF Export	gid_Module_Optional_Grfflt_Gif	2	29 KB
AutoCAD Import	gid_Module_Optional_Grfflt_Acad	1	56 KB
Kodak Photo-CD Import	gid_Module_Optional_Grfflt_Kodac	1	24 KB
Mac-Pict Import/Export	gid_Module_Optional_Grfflt_Macpict	3	86 KB
OS/2 Metafile Import/Export	gid_Module_Optional_Grfflt_Os2meta	3	74 KB
PCX Import	gid_Module_Optional_Grfflt_Pcx	1	24 KB
PNG Export Filter	gid_Module_Optional_Grfflt_Png	2	29 KB
TIFF Import	gid_Module_Optional_Grfflt_Tiff	2	64 KB
SVG Export	gid_Module_Optional_Grfflt_Svg	1	60 KB
Language Modules	gid_Module_Optional_Language	0	17992 KB
English	gid_Module_Optional_Language_Inso1	2	1715 KB
French	gid_Module_Optional_Language_Inso2	2	1825 KB
Spanish	gid_Module_Optional_Language_Inso3	2	1371 KB
German	gid_4Module_Optional_Language_Inso4	2	13080 KB
Fonts	gid_Module_Optional_Font	0	4646 KB
Arial Narrow	gid_Module_Optional_Font_Arialnarrow	4	1003 KB
Arial Black	gid_Module_Optional_Font_Arialbk	1	256 KB
Imprint MT Shadow	gid_Module_Optional_Font_Imprintshadow	2	211 KB
Palace Script	gid_Module_Optional_Font_Palacescript	2	187 KB
Garamond	gid_Module_Optional_Font_Garamond	4	1203 KB
Broadway	gid_Module_Optional_Font_Broad	1	109 KB
Kidprint	gid_Module_Optional_Font_Kidprint	2	310 KB
Sheffield	gid_Module_Optional_Font_Sheffield	3	307 KB
Andale Sans	gid_Module_Optional_Font_Andalesans	4	1057 KB
Sync Client	gid_Module_S1w_Syncclient	0	0 KB

6

Basic Setup

In the [Procedures] section you can use Basic to create procedures which are then called up at different intervals when the response file is running. Several functions are described below and these can be used in your response files to directly address the OpenOffice Setup.

DirEntry. Function

Syntax

String DirEntry ( Path 1 As String, Path 2 As String, ... )

Return

The DirEntry function joins several path components together and converts the results to the current system convention. The result will appear as a string.

Example

Sub Test

Dim strAbsPath As String

strAbsPath = DirEntry( GetSetupEnv.DestPath, "help", "01" )

MsgBox strAbsPathEnd Sub

System	Result
W16, W95, W2000, WNT	D:\OpenOffice\help\01
Unix	/home/Ur/ok/OpenOffice/help/01

Hide/Show Setup. Function

Syntax

void HideSetup ( )

void ShowSetup ( )

Return

The HideSetup function is used to hide the Setup application window when running the response file setup. The ShowSetup function displays the Setup application window tracks and gives feedback about the progress of the installation. The running of the response file setup cannot be influenced by the user as neither of these functions send or receive parameters.

Example

Sub Test

HideSetup

MsgBox "gone!"

ShowSetup

MsgBox "and back again!"

End Sub

7

Error Return Codes in the Response File Mode

If Setup confronts an error while working through the response file, it terminates and relays an error code to the initiating program (shell). If you enter the '_debug parameter when starting the setup, the return code will be shown as text in an error box before setup terminates. The following error messages are defined:

Abort	Exit Code	Error Message
Yes	1	resource file cannot be found
Yes	2	response file cannot be found
Yes	3	illegal installation mode
Yes	4	illegal installation type
Yes	5	script version outdated
Yes	6	wrong command line parameter
Yes	7	setup script file cannot be found
Yes	8	script error
Yes	9	INSTALL_INFO flag is missing
Yes	10	ui procedure cannot be found
Yes	11	no modules accessible
Yes	12	update installation cannot be found
Yes	13	no updates for Try&Buy versions
Yes	14	installation file cannot be found
Yes	15	WORKSTATION type only available on a network installation
Yes	16	error while reading PROCEDURE section
Yes	17	version already installed
Yes	18	<firstfree> wrong system
Yes	19	<home> wrong system
Yes	20	not enough space on the destination drive
Yes	21	nvalid destination path
Yes	22	module cannot be found
Yes	23	installed version required for this type
Yes	24	Install procedure cannot be found
Yes	25	installmoduleset cannot be found
Yes	26	De-install procedure cannot be found
Yes	27	De-install module set cannot be found
Yes	28	wrong or invalid license key
Yes	29	Invalid license
No	-	xterm cannot be found
No	-	could not start xterm
No	-	start xterm return error code
No	-	an error occurred while copying a file
No	-	an error occurred while unpacking a file
No	-	an error occurred while creating a directory

8 Example

The options for installing a response file OpenOffice are introduced in the following examples. Each section found in the example contains a short description of the defined specifications.

Section Environment

This section is used to define the framework of the setup to be controlled by the response files.

[Environment]

InstallationMode = INSTALL_NORMAL

InstallationType = SPECIFY

DestinationPath = d:\OpenOffice.resp

StartProcedure = MyStartProc

EndProcedure = MyEndProc

Comments	
InstallationMode =INSTALL_NORMAL	Installs a OpenOffice stand alone version
InstallationType = SPECIFY	Installs the modules defined in the [Module_Specify] section
DestinationPath = d:\OpenOffice.resp	Provides an explicit destinationpath.
StartProcedure = MyStartProc	Defines MyStartProc as the procedure to be run before the Setup start.
EndProcedure = MyEndProc	Defines MyEndProc as the procedure to be run after the Setup has been run.

Module Section Specification

Define module sets in this section. You can also directly communicate with or install the defined module sets, or refer to one of the defined Install Procedures in the procedures section.

[Module_Specify]

MySet_Writer_Draw = OpenOffice Writer , OpenOffice Draw

MySet_Schedule = OpenOffice Schedule

InstallModuleSet = MySet_Writer_Draw

InstallProcedure = MySelectProc

Comments	
MySet_Writer_Draw = OpenOffice Writer, OpenOffice Draw	Determines the OpenOffice Writer and OpenOffice Draw modules as components of the MySet_Writer_Draw set.
MySet_Schedule = OpenOffice Schedule	Defines the OpenOffice Schedule as component of the MySetSchedule set.
InstallModuleSet = MySet_Writer_Draw	Installs all modules which are defined in MySet_Writer_Draw.
InstallProcedure = MySelectProc	Runs the MySelectProc installationprocedure.

Section Procedures

Define the procedures to be run at various intervals during the Setup.

[Procedures]

Sub MyStartProc

SetUserFirstName ( "Tom" )

SetUserLastName ( "Meyer" )

SetUserID ( "tm" )

SetUserEMail ( "tm@newcompany.com" )

SetUserStreet ( "111 Main Street" )

SetUserZip ( "52365" )

SetUserCity ( "Springfield" )

SetUserCompanyname ( "NewCompany" )

ShowSetup

MsgBox "Start"

End Sub

Comments	
Sub MyStartProc	Begins the MyStartProc procedure
SetUserFirstName ( "Tom" ) SetUserLastName ( "Meyer" ) SetUserID ( "TM" ) SetUserEMail ( "tm@newcompany.com" )	Determines the user parameters for the OpenOffice Installation. These parameters can be used to influence the running time by utilizing environment variables.
ShowSetup	Shows the application window while running the Setup response file.
MsgBox "Start"	Shows a text box with the 'Start' text.
End Sub	End of MyStartProc procedure

Sub MyEndProc

HideSetup

MsgBox "End"

DefuseRestart(True)

End Sub

Comments	
Sub MyEndProc	Start of the MyEndProc procedure
HideSetup	Hides the OpenOffice Setup. Application window
MsgBox "End"	Shows the 'End' text in a text box.
DefuseRestart(True)	Prevents the system rebooting after installation
End Sub	End of the MyEndProc procedure

Sub MySelectProc

SelectModuleSet ( "MySet_Schedule" )

rem DeSelectModuleSet ( "MySet_Schedule" )

EnvVar = Environ( "vcsid" )

If EnvVar = "OK"

Then

SelectModuleByName ( "OpenOffice Chart " )

rem DeSelectModuleByName ( "OpenOffice Chart " )

Endif

SelectModuleByID ( "gid_Module_Prg_Image" )

rem DeSelectModuleByID ( "gid_Module_Prg_Image" )

End Sub

Comments	
Sub MySelectProc	Begins the MySelectProc procedure.
SelectModuleSet ( "MySet_Schedule" )	Selects the Module, which is determined a MySet_Schedule component.
Rem DeSelectModuleSet ("MySet_Schedule" )	If the Module is deselected, the MySet_Schedule component will be determined
EnvVar = Environ( "vcsid" )	Defines the EnvVar variable and assigns an environment variable as value
If EnvVar = "HE"	Requests the EnvVar with the 'HE'value.
Then SelectModuleByName ( "OpenOffice Chart " )	Selects further module – OpenOffice Chart - with the module name.
Rem DeSelectModuleByName( "OpenOffice Chart " )	Deselects the corresponding module with the module name.
Endif	Ends the If loop.
SelectModuleByID ( "gid_Module_Prg_Image" )	Selects a Module on the basis of itsModule ID.
Rem DeSelectModuleByID ( "gid_Module_Prg_Image" )	Deselects the corresponding module by its module ID
End Sub	Ends the MySelectProc procedure

[Java]

JavaSupport = preinstalled_or_none

Comments	
JavaSupport = preinstalled_or_none\	Java will be supported if a version has already been installed on the system.

Real World Examples

For any *NIX environment

The following is an actual script from the *NIX installation distribution. It illustrates how to employ response files to achieve an non-interactive installation. Note: Watch for folded lines.

#! /bin/sh

# should only be run local to the install directory

cd `dirname $0`

# Set the Defaults Here

oo_version="OpenOffice.org 1.1.1"

oo_home=OpenOffice.org1.1.1

oo_default_prefix=/usr/local

oo_default_netflg=-net

oo_default_interact=no

# these are the actual variables

prefix=$oo_default_prefix

netflg=$oo_default_netflg

interact=$oo_default_interact

installtype=INSTALL_NETWORK

# now parse the command line and interpret the options

oo_prev=

for oo_option

do

# If the previous option needs an argument, assign it.

if test -n "$oo_prev"; then

eval "$oo_prev=\$oo_option"

oo_prev=

continue

fi

case "$oo_option" in

-*=*) oo_optarg=`echo "$oo_option" | sed[gerry@gerrypc ajkv]$ 's/[-_a-zA-Z0-9]*=//'` ;;

*) oo_optarg= ;;

esac

case "$oo_option" in

-? | -help | --help | --hel | --he)

cat << EOF

Usage: install [options]

Options: [defaults in brackets after descriptions]

Configuration:

--help print help message (this message)

--version print the version of OpenOffice.org to be installed

--prefix=PREFIX install OpenOffice.org into PREFIX [$oo_default_prefix]

--single install single user version of OpenOffice.org

--interactive install OpenOffice.org using interactive mode

EOF

exit 0 ;;

-prefix | --prefix | --prefi | --pref | --pre | --pr | --p)

oo_prev=prefix ;;

-prefix=* | --prefix=* | --prefi=* | --pref=* | --pre=* | --pr=* | --p=*)

prefix="$oo_optarg" ;;

-s | -single | --single | --singl | --singl | --sin | --si | --s)

netflag=

installtype=INSTALL_NORMAL ;;

-i | -interactive | --interactive | --interact | --intera | --inter)

interact=yes ;;

-version | --version | --versio | --versi | --vers)

echo "$oo_version"

exit 0 ;;

-*) { echo "configure: error: $oo_option: invalid option; use --help to show usage" 1>&2; exit 1; }

;;

esac

done

if test -n "$oo_prev"; then

{ echo "configure: error: missing argument to --`echo $oo_prev | sed 's/_/-/g'`" 1>&2; exit 1; }

fi

# now for the actual installation

# if a single user install

if test "$installtype" = INSTALL_NORMAL; then

# Remove previous .sversionrc to prevent problems with previous versions

oo_versionrc="$HOME/.sversionrc"

#if [ -f "$oo_versionrc" ]; then

# rm -f $oo_versionrc

#fi

# what should we do about prefix setting here if is was not set on the command

# line (ie still the default of /usr/local change it to $HOME)

# perhaps change it to home directory?

if test "$prefix" = /usr/local ; then

prefix=$HOME

fi

fi

# create the proper autoresponse file

# we need to be careful of races in creating root files in /tmp

# for security reasons.

# for more information, please see:

# www.dwheeler.com/secure-programs/Secure-Programs-HOWTO/avoid-race.html

TMPFILE=`mktemp -q /tmp/$0.XXXXXX`

if [ $? -ne 0 ]; then

echo "$0: Can't create temp file, exiting..."

exit 1

fi

cat << EOF >> ${TMPFILE}

[ENVIRONMENT]

INSTALLATIONMODE=$installtype

INSTALLATIONTYPE=STANDARD

DESTINATIONPATH=$prefix/$oo_home

OUTERPATH=

LOGFILE=

LANGUAGELIST=<LANGUAGE>

[JAVA]

JavaSupport=preinstalled_or_none

EOF

# echo something to be patient

echo "Installation starting, please be patient ..."

# if interactive simply run setup with proper flags

# otherwise use the autoresponse file

case "$interact" in

yes)

./setup ${netflg}

;;

no)

./setup -v -nogui -r:${TMPFILE}

;;

esac

# now clean up autoresponse file

rm -f ${TMPFILE}

# finish up

echo " "

echo "Installation Completed"

For Windows environments

The following is a working example courtesy of Laurent Godard and will work in both French and English. If you choose to type this in be aware that some lines are folded.

Rem ########################################

Rem # Auteur : F. Labbe #

Rem # Mail : fred@frederic-labbe.com #

Rem # Date : 14/04/2003 #

Rem # Objet : Fichier d'installation #

Rem # : automatique de OOo 11 en #

Rem # : mono user sous Windows #

Rem # : avec prise en charge des #

Rem # : extension Microsoft Office #

Rem # #

Rem # Adaptation : Laurent Godard	#

Rem # dev.godard@wanadoo.fr #

Rem # #

Rem ########################################

[ENVIRONMENT]

INSTALLATIONMODE=INSTALL_NORMAL

INSTALLATIONTYPE=STANDARD

DESTINATIONPATH=<firstfree>\OpenOffice1.1

MIGRATION=NO

LANGUAGELIST=33

STARTPROCEDURE=Debut

ENDPROCEDURE=Fin

Rem #######################################

[Windows_Desktop_Integration]

Register4MsWord=FALSE

Register4MsExcel=FALSE

Register4MsPowerPoint=FALSE

RegisterAsDefaultHtmlEditor=FALSE

Rem #######################################

[JAVA]

JavaSupport=preinstalled_or_none

Rem #################################

[PROCEDURES]

Sub Debut

dim questions(1 to 2, 0 to 4) 'fr/en, racinelangue/nom/prenom/Titre fenetre

dim chaine as string, RepSource as string

'Langue de l'installation / � changer

IndxLangue=1 'fr

'Initialisation dialogue

questions(1,0)="fr"

questions(1,1)="Veuillez saisir votre pr�nom :"

questions(1,2)="Veuillez saisir votre nom :"

questions(1,3)="OpenOffice.org 1.1 - Installation automatique"

questions(1,4)="Le processus d'installation va commencer et prendre

quelques minutes."+chr(10)+"Un message vous avertira quand ce sera termin�."

questions(2,0)="en"

questions(2,1)="Please give your first name :"

questions(2,2)="Please give your last name "

questions(2,3)="OpenOffice.org 1.1 - Automatic Setup"

questions(2,4)="The install process is about to start and will take

several minutes."+chr(10)+"A message will occur when achieved."

'Message de demarrage

Msgbox questions(IndxLangue,4),64,questions(IndxLangue,3)

'Repertoire source de l'installation

RepSource=GetSetupEnv.SourcePath

if right(RepSource,1)<>"\" then

RepSource=RepSource+"\"

endif

RepSource=RepSource+"..\..\"

'Collecte Informations Utilisateurs

chaine=""

'chaine=InputBox(questions(IndxLangue,1),questions(IndxLangue,3))

SetUserFirstName ( chaine )

'chaine=InputBox(questions(IndxLangue,2),questions(IndxLangue,3))

SetUserLastName ( chaine )

SetUserCompanyname ( "" )

'Installation Java

retour=Shell( RepSource+"java\j2re_1_4_2_01_win.exe",1,"/S /v/qn",true)

ShowSetup

End Sub

Rem #################################################################

Rem #################################################################

Rem #################################################################

Sub Fin

dim questions(1 to 2, 0 to 2) 'fr/en, racinelangue/message Fin/Titre fenetre

dim RepSource as string

questions(1,0)="fr"

questions(1,1)="Installation termin�e"

questions(1,2)="OpenOffice.org 1.1 - Installation automatique"

questions(2,0)="en"

questions(2,1)="Setup finished"

questions(2,2)="OpenOffice.org 1.1 - Automatic Setup"

HideSetup

'Langue de l'installation / � changer

IndxLangue=1 'fr

'Repertoire source de l'installation

RepSource=GetSetupEnv.SourcePath

if right(RepSource,1)<>"\" then

RepSource=RepSource+"\"

endif

RepSource=RepSource+"..\..\"

'Install dictionaires fran�ais

if IndxLangue=1 then

RepDest=curDir

if right(RepDest,1)<>"\" then

RepDest=RepDest+"\"

endif

RepDest=RepDest+"..\share\dict\ooo\"

fichier=dir(RepSource+"dic\*.*")

while fichier<>""

filecopy RepSource+"dic\"+fichier, RepDest+fichier

fichier=dir()

wend

endif

'Message de fin

msgbox	questions(IndxLangue,1),64,questions(IndxLangue,2)

DefuseRestart(True)

End Sub

Index

Public Documentation License, Version 1.0

1.0 DEFINITIONS.

1.1. "Commercial Use" means distribution or otherwise making the Documentation available to a third party.

1.2. "Contributor" means a person or entity who creates or contributes to the creation of Modifications.

1.3. "Documentation" means the Original Documentation or Modifications or the combination of the Original Documentation and Modifications, in each case including portions thereof.

1.4. "Electronic Distribution Mechanism" means a mechanism generally accepted for the electronic transfer of data.

1.5. "Initial Writer" means the individual or entity identified as the Initial Writer in the notice required by the Appendix.

1.6. "Larger Work" means a work which combines Documentation or portions thereof with documentation or other writings not governed by the terms of this License.

1.7. "License" means this document.

1.8. "Modifications" means any addition to or deletion from the substance or structure of either the Original Documentation or any previous Modifications, such as a translation, abridgment, condensation, or any other form in which the Original Documentation or previous Modifications may be recast, transformed or adapted. A work consisting of editorial revisions, annotations, elaborations, and other modifications which, as a whole represent an original work of authorship, is a Modification. For example, when Documentation is released as a series of documents, a Modification is:

A. Any addition to or deletion from the contents of the Original Documentation or previous Modifications.

B. Any new documentation that contains any part of the Original Documentation or previous Modifications.

1.9. "Original Documentation" means documentation described as Original Documentation in the notice required by the Appendix, and which, at the time of its release under this License is not already Documentation governed by this License.

1.10. "Editable Form" means the preferred form of the Documentation for making Modifications to it. The Documentation can be in an electronic, compressed or archival form, provided the appropriate decompression or de-archiving software is widely available for no charge.

1.11. "You" (or "Your") means an individual or a legal entity exercising rights under, and complying with all of the terms of this License or a future version of this License issued under Section 5.0 ("Versions of the License"). For legal entities, "You" includes any entity which controls, is controlled by, or is under common control with You. For purposes of this definition, "control" means (a) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (b) ownership of more than fifty percent (50%) of the outstanding shares or beneficial ownership of such entity.

2.0 LICENSE GRANTS.

2.1 Initial Writer Grant.

The Initial Writer hereby grants You a world-wide, royalty-free, non-exclusive license to use, reproduce, prepare Modifications of, compile, publicly perform, publicly display, demonstrate, market, disclose and distribute the Documentation in any form, on any media or via any Electronic Distribution Mechanism or other method now known or later discovered, and to sublicense the foregoing rights to third parties through multiple tiers of sublicensees in accordance with the terms of this License.

The license rights granted in this Section 2.1 ("Initial Writer Grant") are effective on the date Initial Writer first distributes Original Documentation under the terms of this License.

2.2. Contributor Grant.

Each Contributor hereby grants You a world-wide, royalty-free, non-exclusive license to use, reproduce, prepare Modifications of, compile, publicly perform, publicly display, demonstrate, market, disclose and distribute the Documentation in any form, on any media or via any Electronic Distribution Mechanism or other method now known or later discovered, and to sublicense the foregoing rights to third parties through multiple tiers of sublicensees in accordance with the terms of this License.

The license rights granted in this Section 2.2 ("Contributor Grant") are effective on the date Contributor first makes Commercial Use of the Documentation.

3.0 DISTRIBUTION OBLIGATIONS.

3.1. Application of License.

The Modifications which You create or to which You contribute are governed by the terms of this License, including without limitation Section 2.2 ("Contributor Grant"). The Documentation may be distributed only under the terms of this License or a future version of this License released in accordance with Section 5.0 ("Versions of the License"), and You must include a copy of this License with every copy of the Documentation You distribute. You may not offer or impose any terms that alter or restrict the applicable version of this License or the recipients' rights hereunder. However, You may include an additional document offering the additional rights described in Section 3.5 ("Required Notices").

3.2. Availability of Documentation.

Any Modification which You create or to which You contribute must be made available publicly in Editable Form under the terms of this License via a fixed medium or an accepted Electronic Distribution Mechanism.

3.3. Description of Modifications.

All Documentation to which You contribute must identify the changes You made to create that Documentation and the date of any change. You must include a prominent statement that the Modification is derived, directly or indirectly, from Original Documentation provided by the Initial Writer and include the name of the Initial Writer in the Documentation or via an electronic link that describes the origin or ownership of the Documentation. The foregoing change documentation may be created by using an electronic program that automatically tracks changes to the Documentation, and such changes must be available publicly for at least five years following release of the changed Documentation.

3.4. Intellectual Property Matters.

Contributor represents that Contributor believes that Contributor's Modifications are Contributor's original creation(s) and/or Contributor has sufficient rights to grant the rights conveyed by this License.

3.5. Required Notices.

You must duplicate the notice in the Appendix in each file of the Documentation. If it is not possible to put such notice in a particular Documentation file due to its structure, then You must include such notice in a location (such as a relevant directory) where a reader would be likely to look for such a notice, for example, via a hyperlink in each file of the Documentation that takes the reader to a page that describes the origin and ownership of the Documentation. If You created one or more Modification(s) You may add your name as a Contributor to the notice described in the Appendix.

You must also duplicate this License in any Documentation file (or with a hyperlink in each file of the Documentation) where You describe recipients' rights or ownership rights.

You may choose to offer, and to charge a fee for, warranty, support, indemnity or liability obligations to one or more recipients of Documentation. However, You may do so only on Your own behalf, and not on behalf of the Initial Writer or any Contributor. You must make it absolutely clear than any such warranty, support, indemnity or liability obligation is offered by You alone, and You hereby agree to indemnify the Initial Writer and every Contributor for any liability incurred by the Initial Writer or such Contributor as a result of warranty, support, indemnity or liability terms You offer.

3.6. Larger Works.

You may create a Larger Work by combining Documentation with other documents not governed by the terms of this License and distribute the Larger Work as a single product. In such a case, You must make sure the requirements of this License are fulfilled for the Documentation.

4.0 APPLICATION OF THIS LICENSE.

This License applies to Documentation to which the Initial Writer has attached this License and the notice in the Appendix.

5.0 VERSIONS OF THE LICENSE.

5.1. New Versions.

Initial Writer may publish revised and/or new versions of the License from time to time. Each version will be given a distinguishing version number.

5.2. Effect of New Versions.

Once Documentation has been published under a particular version of the License, You may always continue to use it under the terms of that version. You may also choose to use such Documentation under the terms of any subsequent version of the License published by______________________ [Insert name of the foundation, company, Initial Writer, or whoever may modify this License]. No one other than ________________________[Insert name of the foundation, company, Initial Writer, or whoever may modify this License] has the right to modify the terms of this License. Filling in the name of the Initial Writer, Original Documentation or Contributor in the notice described in the Appendix shall not be deemed to be Modifications of this License.

6.0 DISCLAIMER OF WARRANTY.

DOCUMENTATION IS PROVIDED UNDER THIS LICENSE ON AN "AS IS'' BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENTATION IS FREE OF DEFECTS, MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE OF THE DOCUMENTATION IS WITH YOU. SHOULD ANY DOCUMENTATION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER OR ANY OTHER CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY DOCUMENTATION IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER.

7.0 TERMINATION.

This License and the rights granted hereunder will terminate automatically if You fail to comply with terms herein and fail to cure such breach within 30 days of becoming aware of the breach. All sublicenses to the Documentation which are properly granted shall survive any termination of this License. Provisions which, by their nature, must remain in effect beyond the termination of this License shall survive.

8.0 LIMITATION OF LIABILITY.

UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE, SHALL THE INITIAL WRITER, ANY OTHER CONTRIBUTOR, OR ANY DISTRIBUTOR OF DOCUMENTATION, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO THE USE OF THE DOCUMENTATION, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.

9.0 U.S. GOVERNMENT END USERS.

If Documentation is being acquired by or on behalf of the U.S. Government or by a U.S. Government prime contractor or subcontractor (at any tier), then the Government's rights in Documentation will be only as set forth in this Agreement; this is in accordance with 48 CFR 227.7201 through 227.7202-4 (for Department of Defense (DOD) acquisitions) and with 48 CFR 2.101 and 12.212 (for non-DOD acquisitions).

10.0 MISCELLANEOUS.

This License represents the complete agreement concerning the subject matter hereof. If any provision of this License is held to be unenforceable, such provision shall be reformed only to the extent necessary to make it enforceable. This License shall be governed by California law, excluding its conflict-of-law provisions. With respect to disputes or any litigation relating to this License, the losing party is responsible for costs, including without limitation, court costs and reasonable attorneys' fees and expenses. The application of the United Nations Convention on Contracts for the International Sale of Goods is expressly excluded. Any law or regulation which provides that the language of a contract shall be construed against the drafter shall not apply to this License.

Appendix

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

The Original Documentation is _________________. The Initial Writer of the Original Documentation is ______________________ (C) ____. All Rights Reserved. (Initial Writer contact(s):_______________[Insert hyperlink/alias].)

Contributor(s): ______________________________________.

Portions created by ______ are Copyright (C)_________[Insert year(s)]. All Rights Reserved. (Contributor contact(s):________________[Insert hyperlink/alias]).

Note: The text of this Appendix may differ slightly from the text of the notices in the files of the Original Documentation. You should use the text of this Appendix rather than the text found in the Original Documentation for Your Modifications.

Index

How-to Autoinstall using Response Files	41

Basic Setup

Public Documentation License, Version 1.0

G. Roderick Singleton

2004-07-06T11:58:50

G. Roderick Singleton