StarOffice™ 5.2
Installation with Response Files

Sun Microsystems, Inc.
901 San Antonio Road
Palo Alto, CA 94303
U.S.A. 650-960-1300
June 2000, Revision A

Copyrights and Trademarks
Copyright 2000 Sun Microsystems, Inc., 901 San Antonio Road, California 94303, U.S.A. All rights reserved.
This product is distributed under licenses restricting its use, copying, distribution, and decompilation. No partof this product may be reproduced in any form by any means without prior written authorization of Sun and its
licensors, if any.
Third-party software, including font technology, is copyrighted and licensed from Sun suppliers. Copyright1992 International Electronic Thesaurus and Copyright 1991 International CorrectSpell by Lernout & Hauspie
Speech Products N.V. All rights reserved. Copyright 1996 Word for Word. Inso Corporation. All rights
reserved. Copyright 2000 Adabas D by Software AG. Third-party software, including font technology, is copyrighted and licensed from Sun suppliers.
Portions allowing ASN.1 encoding and decoding are © 1997 Eric Young. All rights reserved.
Portions © 1998, 1999 James Clark. Portions © 1996,1998 Netscape Communications Corporation. Portions ©
1996, 1997 Kenneth Albanowski. You can find the original as well as - if applicable - the modified versions at
http://www.sun.com/staroffice/source/index.html.
Sun, Sun Microsystems, the Sun logo, StarOffice, the StarOffice logo, Java, and the Java Coffee Cup are trade
marks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. International CorrectSpell is a trademark of Lernout & Hauspie Speech Products N.V. Oterro is a trademark of R:BASE
Technologies, Inc. PostScript is a registered trademark of Adobe Systems Inc. X-Printer is a registered trademarkof Bristol Technology Inc. SPARC is a registered trademark of SPARC International Inc. UNIX is a registeredtrademark, which is solely licensed in the United States, and in other countries by X/Open Company Ltd. Motifis a registered trademark of Open Software Foundation Inc. X Window System is a trademark of X Consortium
Inc.
U.S. Government approval required when exporting the product.
Federal Acquisitions: Commercial Software - Government Users Subject to Standard License Terms and Conditions.
DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESSFOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENTTHAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID.

Contents
1

What is a Response File Installation?

5

2

How Do I Install StarOffice with Response Files? 7
Preparing the Response File Installation 7
Creating a Response File

7

Testing the Response File8

Install StarOffice Using the Response File 8
3

Response File Structure and Sections
Response File Structure99Section Environment 9
Section Module_Specify 9
Section Procedures

10

Section Java 10
3

Section Explanation 10
Section Environment 10
Section Module_Specify 13
Section Procedures

15

Section Java 16
4

Setup Command Line Parameter

17

Running StarOffice Setup with Parameters 17-sdump17-debug18

5Script.Htm

19

6

Basic Setup

31

DirEntry. Function31

Hide/Show Setup. Function 32
7

Error Return Codes in the Response File Mode 33

8

Example35

Section Environment 35
Module Section Specification 36
Section Procedures
94

Customer Support

36

41

Installation with Response Files • June 2000

CHAPTER

1

1

What is a Response File Installation?
To install a single-user installation you need a valid StarOffice installation set and a
StarOffice Setup program. After starting the Setup, you can select various parameters
for the installation. For example, you can define which StarOffice Module you want toinstall.
When installing StarOffice in a network, it needs to be installed or adapted to managea large number of users, and therefore, installation or configuration by the user oradministrator at each workstation is not always the best solution.
For this reason, you, as administrator now have the possibility to automate a central
installation, reparation, configuration or deinstallation of StarOffice by using response
files. The response file takes over control of the StarOffice Setup program. You can, forexample, enter the following information for the StarOffice 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 StarOffice sets and assign these to specificuser 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 StarOffice
Setup 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.

5

6Installation with Response Files • June 2000

CHAPTER

2

2

How Do I Install StarOffice with
Response Files?
The process followed during a StarOffice remote installation when a response file isused is outlined below:■

Preparing the response file installation■

Creating a response file■

Testing a response file■

Installing StarOffice using a response file

Preparing the Response File Installation
You need to have the following to install StarOffice using response files:■

A valid StarOffice installation set■

Access to the client computer■

The functioning response file

You can create a response file with any editor program.

Creating a Response FileTo create a response file:
1. Define which actions are to be run for which user group.

72. Define the rules for running the actions.
3. Define whether you want to allow user feedback when running the actions.
4. Write the response file.
5. Test the response file.
6. Run the response file.
The individual features of working with response files are shown at the end of thisbooklet in the form of a detailed practical example.

Testing the Response File
Proceed as follows to test a response file:
1. Create a new directory on a network drive.
2. Alter the path details in your response file to match those of this network path.
3. Run the response file from a shell.
4. Check the results of the response file setup in the specified drive.
The return codes produced by the response file can be shown in a message box byentering the –debug setup command line parameter. This allows you to see if the
response file functions as required.

Install StarOffice Using the Response FileTo install StarOffice by using response files:
1. Define in the response file which StarOffice modules are to be installed.
2. Define the installation path.
3. Run the response file.
4. Check the installation, if necessary.

8

Installation with Response Files • June 2000

CHAPTER

3

3

Response File Structure and Sections
This section contains a detailed description of the response file structure needed for
the StarOffice 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 StarOffice
Setup or are transferred using parameters. The following keys have been defined forthis purpose:■

InstallationMode■

InstallationType■

DestinationPath■

StartProcedure■

EndProcedure

Section Module_Specify[Module_Specify]
Use this section to compose individual StarOffice module sets and assign them to an
installation or deinstallation procedure. You are able to define any combination of the9modules found in the setup script. The modules can be accessed by using either themodule name or a module ID.
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

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

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

Section Explanation
Section Environment
Installation Mode
Values10

INSTALL_NORMAL

Installs a local StarOffice standalone version

INSTALL_NETWORK

Installs a StarOffice network version

Installation with Response Files • June 2000

INSTALL_WORKSTATION

Installs a workstation version from an existing
network installation

DEINSTALL

Deinstalls an existing StarOffice version

REPAIR

Repairs a StarOffice version

REINSTALL

Reinstalls a StarOffice version

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 threemodes 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 installedversions. 'DEINSTALL' and 'REPAIR' do not need any further specifications and will
be executed immediately. 'REINSTALL' evaluates the [MODULE_SPECIFY] section todetermine which actions are to be carried out.

InstallationType
ValuesSTANDARD

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
Chapter 3

Response File Structure and Sections

11

version locally on the client, the 'WORKSTATION' type, on the other hand, only
installs a small network installation in this mode.

DestinationPath
Valuesd:\office5x<firstfree>\office5x<home>\office5x

Default: <firstfree> + directory name of DefaultPath from the setup
scriptYou 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.

12

Installation with Response Files • June 2000

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' =ValuesModuleName1, ModuleName2, ...

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

Chapter 3

Response File Structure and Sections

13

InstallModuleSet
Value
ModuleSetName

Default: None
Define the module set in the InstallModuleSet which is to be installed when a specificinstallation 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 specificinstallation 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 beinstalled when an installation type or mode refer to this section. You can access the

14

Installation with Response Files • June 2000

module sets by using SetupBASIC. The procedure has to be implemented in the[Procedures] section. If a InstallModuleSet is defined along with InstallProcedure inthis section, the procedure will always be run.

DeInstallProcedure
Value
DeInstallProcedureDefault: 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 themodule 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 todifferent positions in the response file. The functions are independent and cannot calleach other.

Example:Sub ProcedureName
Code ...
EndSub

Sub NextProcedureName
Code ...
EndSub

Chapter 3

Response File Structure and Sections

15

Section Java
This section defines if an existing Java installation is to be supported.
[Java]JavaSupport=

Valuesnone

not supported

preinstalled_or_none

supports Java, if installed

newinstallinstalls Java

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

16

Installation with Response Files • June 2000

CHAPTER

4

4

Setup Command Line Parameter
You can run StarOffice Setup under different command line parameters:■[-sdump [-d:<destpath>]]■[-r:<response_file> [-debug]]

Running StarOffice Setup withParameters
To run StarOffice Setup with one of the parameters:
1. Start StarOffice Setup from a shell.
2. Enter the required parameter: Example:
C:\office52\setup.exe -Parameter-sdumpSDUMP (ScriptDump)
A Setup started with the SDUMP parameter creates a 'script.htm' HTML file whichcontains 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 tocreate 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.

17-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 displayedin an Error Box before quitting the program. This function is helpful when testing yourown response file.

18

Installation with Response Files • June 2000

CHAPTER

5

5

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

ModuleModule ID

Files Size

StarOffice 5.2

gid_Module_Root

354

183777KB

StarOffice 5.2
program module

gid_Module_Prg

044948 KBStarOffice Writer 5.2

gid_Module_Prg_Wrt

018574 KB

Textfilter

gid_Module_Prg_Wrt_Flt

014144 KB

HTML Import andExportgid_Module_Prg_Wrt_Flt_Html

0

0 KB

Textfilter Importand Export

gid_Module_Prg_Wrt_Flt_Text

0

0 KB

MAC-Text

gid_Module_Prg_Wrt_Flt_Mactext

0

0 KB

DOS-Text

gid_Module_Prg_Wrt_Flt_Dostext

0

0 KB

UNIX-Text

gid_Module_Prg_Wrt_Flt_Unxtext

0

0 KB

RTF Import andExportgid_Module_Prg_Wrt_Flt_Rtf

0

0 KB

Ami Pro Import

gid_Module_Prg_Wrt_Flt_Amipro

0

324 KBAmi Pro 1.1 - 1.2

gid_Module_Prg_Wrt_Flt_Amipro12

1

162 KBAmi Pro 2.0 - 3.1

gid_Module_Prg_Wrt_Flt_Amipro31

1

162 KB

19

20

ModuleModule ID

Files Size

Claris Works
Importgid_Module_Prg_Wrt_Flt_Claris

1

161 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

0289 KBDCA 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 KBDEC DX

gid_Module_Prg_Wrt_Flt_Decdx

1

91 KB

DEC WPS-Plus
Importfilter

gid_Module_Prg_Wrt_Flt_Decwps

1

158 KB

DisplayWrite
Importgid_Module_Prg_Wrt_Flt_Dispwrt

0

205 KB

DisplayWrite 5.x
Importgid_Module_Prg_Wrt_Flt_Dispwrt5

1

102 KB

DisplayWrite 2.0-4.x

gid_Module_Prg_Wrt_Flt_Dispwrt2

1

102 KBEBCDIC Import

gid_Module_Prg_Wrt_Flt_Ebcdic

1

66 KB

Enable Import

gid_Module_Prg_Wrt_Flt_Enable

1

86 KB

Frame Maker
Importgid_Module_Prg_Wrt_Flt_Fmaker

0592 KB

Frame Maker MIF
4.0

gid_Module_Prg_Wrt_Flt_Fmaker4

1

197 KB

Frame Maker MIF
5.0

gid_Module_Prg_Wrt_Flt_Fmaker5

1

197 KB

Frame Maker MIF
3.0

gid_Module_Prg_Wrt_Flt_Fmaker3

1

197 KB

Frame Work Import

gid_Module_Prg_Wrt_Flt_Fwork

0162 KB

Installation with Response Files • June 2000

ModuleModule ID

Files Size

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
Importgid_Module_Prg_Wrt_Flt_Icl

0244 KBICL Office Power 7

gid_Module_Prg_Wrt_Flt_Icl7

1

122 KBICL 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

132 KB

Legacy Winstar
onGo Import

gid_Module_Prg_Wrt_Flt_Legacy

1

107 KB

Lotus Manuscript
Importgid_Module_Prg_Wrt_Flt_Lotusman

1

197 KB

Lotus Manuscript
Importgid_Module_Prg_Wrt_Flt_Macwrite

0332 KBMac Write Pro

gid_Module_Prg_Wrt_Flt_Macwritepro

1

106 KBMac Write II

gid_Module_Prg_Wrt_Flt_Macwrite2

1

105 KBMac Write 4.x/5.0

gid_Module_Prg_Wrt_Flt_Macwrite5

1

121 KBMASS 11 Import

gid_Module_Prg_Wrt_Flt_Mass

0269 KBMASS 11 Rel. 8.5 9.0

gid_Module_Prg_Wrt_Flt_Mass9

1

134 KBMASS 11 Rel. 8.0 8.3

gid_Module_Prg_Wrt_Flt_Mass8

1

134 KB

Microsoft
Word/WinWord
Filtergid_Module_Prg_Wrt_Flt_Mword

01335 KB

Word 97/2000

gid_Module_Prg_Wrt_Flt_Mword97

0

0 KB

Word 95

gid_Module_Prg_Wrt_Flt_Mword95

0

0 KB

WinWord 6.0

gid_Module_Prg_Wrt_Flt_Mword6

0

0 KB

Chapter 5

Script.Htm

21

22

ModuleModule ID

Files Size

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 6.0

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 KBMS Works Import

gid_Module_Prg_Wrt_Flt_Msworks

0423 KBMS Works 4.0 Mac

gid_Module_Prg_Wrt_Flt_Msworks41

143 KBMS Works 3.0 Win

gid_Module_Prg_Wrt_Flt_Msworks31

140 KBMS Works 2.0 DOS

gid_Module_Prg_Wrt_Flt_Msworks2

1

140 KB

MultiMate Import

gid_Module_Prg_Wrt_Flt_Mmate

0376 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

0261 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
Importgid_Module_Prg_Wrt_Flt_Pfs

0319 KBPFS First Choice 3.0

gid_Module_Prg_Wrt_Flt_Pfs3

1

106 KBPFS First Choice 2.0

gid_Module_Prg_Wrt_Flt_Pfs2

1

106 KB

Installation with Response Files • June 2000

ModuleModule ID

Files SizePFS First Choice 1.0

gid_Module_Prg_Wrt_Flt_Pfs1

1

106 KBPFS Write Import

gid_Module_Prg_Wrt_Flt_Pfswrite

1

106 KB

Professional Write
Importgid_Module_Prg_Wrt_Flt_Profwrt

0375 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&A Write Import

gid_Module_Prg_Wrt_Flt_Qa

0

162 KB

Q&A Write 4.0

gid_Module_Prg_Wrt_Flt_Qa4

1

81 KB

Q&A Write 1.0 - 3.0

gid_Module_Prg_Wrt_Flt_Qa3

1

81 KB

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

Samna Word IV
Importgid_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

73 KB

VolksWriter 3 and 4

gid_Module_Prg_Wrt_Flt_Volkswrt4

1

98 KB

Wang Import

gid_Module_Prg_Wrt_Flt_Wang

0249 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

96 KB

Chapter 5

Script.Htm

23

24

ModuleModule ID

Files Size

Win Write 3.x
Importgid_Module_Prg_Wrt_Flt_Wwrite3

1

125 KBWITA Import

gid_Module_Prg_Wrt_Flt_Wita

1

110 KB

WiziWord 3.0
Importgid_Module_Prg_Wrt_Flt_Wiziword

1

107 KB

Word Perfect
Importgid_Module_Prg_Wrt_Flt_Wperfect02336 KB

Word Perfect (Win)7.0

gid_Module_Prg_Wrt_Flt_Wperfect7

1

253 KB

Word Perfect (Win)6.1

gid_Module_Prg_Wrt_Flt_Wperfect61

1

253 KB

Word Perfect (Win)6.0

gid_Module_Prg_Wrt_Flt_Wperfect61

253 KB

Word Perfect (Win)
5.X

gid_Module_Prg_Wrt_Flt_Wperfect52

1

170 KB

Word Perfect (Mac)3

gid_Module_Prg_Wrt_Flt_Wperfectmac3

1

133 KB

Word Perfect (Mac)2

gid_Module_Prg_Wrt_Flt_Wperfectmac2

1

133 KB

Word Perfect (Mac)1

gid_Module_Prg_Wrt_Flt_Wperfectmac1

1

133 KB

Word Perfect 6.1

gid_Module_Prg_Wrt_Flt_Wperfectdos61

1

253 KB

Word Perfect 6.0

gid_Module_Prg_Wrt_Flt_Wperfectdos61

253 KB

Word Perfect 5.1

gid_Module_Prg_Wrt_Flt_Wperfectdos51

1

170 KB

Word Perfect 5.0

gid_Module_Prg_Wrt_Flt_Wperfectdos51

170 KB

Word Perfect 4.2

gid_Module_Prg_Wrt_Flt_Wperfectdos42

1

80 KB

Word Perfect 4.1

gid_Module_Prg_Wrt_Flt_Wperfectdos41

1

80 KB

WordStar Import

gid_Module_Prg_Wrt_Flt_Wstar

01394 KB

WordStar 2000
Rel.3.5

gid_Module_Prg_Wrt_Flt_Wstar200035

1

94 KB

WordStar 2000
Rel.3.0

gid_Module_Prg_Wrt_Flt_Wstar200030

1

94 KB

Installation with Response Files • June 2000

ModuleModule ID

Files Size

WordStar 7.0

gid_Module_Prg_Wrt_Flt_Wstar7

1

145 KB

WordStar 6.0

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

116 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

2

219 KB

WriteNow 3.0 (Mac)
Importgid_Module_Prg_Wrt_Flt_Writenow3

1

112 KB

Writing Assistant
Importgid_Module_Prg_Wrt_Flt_Wassist

1

82 KB

XEROX XIF Import

gid_Module_Prg_Wrt_Flt_Xerox

0

802 KBXEROX XIF 6.0 (ResGraphic)

gid_Module_Prg_Wrt_Flt_Xerox6

1

200 KBXEROX XIF 6.0(Color Bitmap)

gid_Module_Prg_Wrt_Flt_Xerox6color

1

200 KBXEROX XIF 5.0

gid_Module_Prg_Wrt_Flt_Xerox5

1

200 KBXEROX XIF 5.0(Illustrator)

gid_Module_Prg_Wrt_Flt_Xerox5illu

1

200 KB

XyWrite Import

gid_Module_Prg_Wrt_Flt_Xywrite

0789 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_Xywritesign1

131 KB

XyWrite Sig. (Win)gid_Module_Prg_Wrt_Flt_Xywritesignwin 1

131 KB

StarOffice Writer 5.2
Help

gid_Module_Prg_Wrt_Help1642 KB

3

Chapter 5

Script.Htm

25

26

ModuleModule ID

Files Size

StarOffice Writer 5.2
Templates

gid_Module_Prg_Wrt_Temp

61641 KBStarOffice Writer 5.2
Samples

gid_Module_Prg_Wrt_Sample

51146 KBStarOffice Calc 5.2

gid_Module_Prg_Calc

07852 KB

Program module

gid_Module_Prg_Calc_Bin

73577 KBStarOffice Calc 5.2
Help

gid_Module_Prg_Calc_Help31536 KBStarOffice Calc 5.2
Templates

gid_Module_Prg_Calc_Temp

31364 KBStarOffice Calc 5.2
Samples

gid_Module_Prg_Calc_Sample

31373 KBStarOffice Impress
5.2

gid_Module_Prg_Impress

09036 KB

Program module

gid_Module_Prg_Impress_Bin

5

54 KB

StarOffice Impress
5.2 Help

gid_Module_Prg_Impress_Help

31081 KBStarOffice Impress
5.2 Templates

gid_Module_Prg_Impress_Temp

36132 KBStarOffice Impress
5.2 Samples

gid_Module_Prg_Impress_Sample

31768 KBStarOffice Draw 5.2

gid_Module_Prg_Draw0

1730 KB

Program module

gid_Module_Prg_Draw_Bin

5

55 KB

StarOffice Draw 5.2
Help

gid_Module_Prg_Draw_Help

3654 KB

StarOffice Draw 5.2
Templates

gid_Module_Prg_Draw_Temp

1

138 KB

StarOffice Draw 5.2
Samples

gid_Module_Prg_Draw_Sample

3881 KB

StarOffice Math 5.2

gid_Module_Prg_Math01419 KB

Program module

gid_Module_Prg_Math_Bin

6408 KB

Installation with Response Files • June 2000

ModuleModule ID

Files Size

StarOffice Math 5.2
Help

gid_Module_Prg_Math_Help

3861 KB

StarOffice Math 5.2
Samples

gid_Module_Prg_Math_Sample

3

150 KB

StarOffice Chart 5.2

gid_Module_Prg_Chart

01550 KB

Program module

gid_Module_Prg_Chart_Bin

6

906 KB

StarOffice Chart 5.2
Help

gid_Module_Prg_Chart_Help

3644 KB

StarOffice Image 5.2

gid_Module_Prg_Image

01007 KB

Program module

gid_Module_Prg_Image_Bin

3

342 KB

StarOffice Image 5.2
Help

gid_Module_Prg_Image_Help

6665 KB

StarOffice Schedule
5.2

gid_Module_Prg_Schedule

03777 KB

Program module

gid_Module_Prg_Schedule_Bin62678 KBStarOffice Schedule
5.2 Help

gid_Module_Prg_Schedule_Help

3938 KB

Data Synchronization PalmPilot

gid_Module_Prg_Schedule_Palm

3

159 KB

Optional Components

gid_Module_Optional

035500 KB

AddInsgid_Module_Optional_Addins

3

87 KB

Language module

gid_Module_Optional_Language

018582 KB

Germangid_Module_Optional_Language_Inso1

1

12784 KB

English UK

gid_Module_Optional_Language_Inso2

1

1273 KB

English US

gid_Module_Optional_Language_Inso3

11335 KB

Frenchgid_Module_Optional_Language_Inso4

11822 KB

Spanishgid_Module_Optional_Language_Inso5

11367 KB

Graphics filters

gid_Module_Optional_Grfflt

0621 KB

Adobe Photoshop
Importfilter

gid_Module_Optional_Grfflt_Adobe

1

24 KB

Chapter 5

Script.Htm

27

28

ModuleModule ID

Files SizeTGA Import

gid_Module_Optional_Grfflt_Tga

1

24 KB

EPS Import andExport filters

gid_Module_Optional_Grfflt_Eps

3

74 KB

XPM-Export filters

gid_Module_Optional_Grfflt_Xpm

1

20 KB

Portable Bitmap
Import and Export

gid_Module_Optional_Grfflt_Pbmp

4

80 KB

SUN-Rasterfile
Import and Export

gid_Module_Optional_Grfflt_Sunrst

2

40 KB

GIF-Export

gid_Module_Optional_Grfflt_Gif

2

26 KB

AutoCAD Import

gid_Module_Optional_Grfflt_Acad

1

52 KB

Kodak Photo-CD
Importgid_Module_Optional_Grfflt_Kodac

2

26 KB

Mac-Pict Importand Export

gid_Module_Optional_Grfflt_Macpict

3

82 KB

OS/2 Metafile
Import and Export

gid_Module_Optional_Grfflt_Os2meta

3

70 KB

PCX Import

gid_Module_Optional_Grfflt_Pcx

1

20 KB

PNG Export filters

gid_Module_Optional_Grfflt_Png

2

25 KB

TIFF Import

gid_Module_Optional_Grfflt_Tiff

2

56 KB

General Help
modules

gid_Module_Optional_Help

09025 KB

User's Guide

gid_Module_Optional_Help_User27317 KBStarOffice BasicHelp

gid_Module_Optional_Help_Basic

3

1708 KB

Optional Gallery
themesgid_Module_Optional_Gallery

03969 KB

Sound files

gid_Module_Optional_Gallery_Snd22247 KB

Clip arts

gid_Module_Optional_Gallery_Clip21722 KB

Java Environment
Installation

gid_Module_Optional_Java

0

0 KB

Adabas database

gid_Module_Optional_Adabas

4599 KB

Installation with Response Files • June 2000

ModuleModule ID

Files Size

Fonts

gid_Module_Optional_Font

302291 KB

Standard Browser

gid_Module_Optional_Stdbrowser

0

0 KB

Dialergid_Module_Optional_Dial

1

64 KB

PGP Support

gid_Module_Optional_Pgp

3

112 KBUse Internet
Explorer

gid_Module_Optional_Useie

3

83 KB

System integration

gid_Module_Optional_Sysintegration

0

64 KB

System directories

gid_Module_Optional_Sysdir

0

0 KB

Task bar icon area

gid_Module_Optional_Syssoint

2

64 KB

URL_Reg

gid_Module_Optional_Urlreg

0

0 KB

Chapter 5

Script.Htm

29

30

Installation with Response Files • June 2000

CHAPTER

6

6

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

DirEntry. Function
SyntaxString 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.

ExampleSub Test
Dim strAbsPath As String
strAbsPath = DirEntry( GetSetupEnv.DestPath, "help", "01" )MsgBox strAbsPathEnd Sub

31

SystemResultW16, W95, W2000, WNT

D:\office52\help\01

Unix/home/Ur/ok/office52/help/01

Macintosh

Hard disk:office52:help:01

Hide/Show Setup. Function
Syntaxvoid HideSetup ( )voidShowSetup ( )ReturnThe 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 andgives 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.

ExampleSub Test
HideSetup
MsgBox "gone!"ShowSetup
MsgBox "and back again!"
End Sub

32

Installation with Response Files • June 2000

CHAPTER

7

7

Error Return Codes in the Response
File Mode
If Setup confronts an error while working through the response file, it terminates andrelays 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 CodeError Message

Yes

1

resource file cannot be foundYes

2

response file cannot be foundYes

3

illegal installation mode

Yes

4

illegal installation typeYes5

script version outdatedYes

6

wrong command line parameterYes

7

setup script file cannot be foundYes8

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

15

WORKSTATION type only available on a
network installation

Yes

33

34

Abort

Exit CodeError Message

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

invalid 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 licenseNo-xterm cannot be foundNo-

could not start xterm

No-start xterm return error codeNo-

an error occurred while copying a fileNo-

an error occurred while unpacking a fileNo-

an error occurred while creating a directory

Installation with Response Files • June 2000

CHAPTER

8

8

ExampleThe options for installing a response file StarOffice are introduced in the following
examples. Each section found in the example contains a short description of thedefined 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:\office52.resp
StartProcedure = MyStartProc
EndProcedure = MyEndProc
Comments
InstallationMode =INSTALL_NORMAL

Installs a StarOffice stand alone
versionInstallationType = SPECIFY

Installs the modules defined in the[Module_Specify] section

DestinationPath = d:\office52.resp

Provides an explicit destination
path.

StartProcedure = MyStartProc

Defines MyStartProc as the procedure to be run before the Setup
start.
35

Comments
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 installthe defined module sets, or refer to one of the defined Install Procedures in the procedures section.
[Module_Specify]
MySet_Writer_Draw = StarOffice Writer 5.2, StarOffice Draw 5.2
MySet_Schedule = StarOffice Schedule 5.2

InstallModuleSet = MySet_Writer_Draw
InstallProcedure = MySelectProc

Comments
MySet_Writer_Draw = StarOffice Writer5.2, StarOffice Draw 5.2

Determines the StarOffice Writer5.2 andStarOffice Draw5.2 modules as components of the MySet_Writer_Draw set.

MySet_Schedule = StarOffice Schedule 5.2 Defines the StarOffice Schedule5.2 ascomponent of the MySetSchedule set.
InstallModuleSet = MySet_Writer_Draw

Installs all modules which are defined in
MySet_Writer_Draw.

InstallProcedure = MySelectProc

Runs the MySelectProc installation
procedure.

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

Installation with Response Files • June 2000

[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
StarOffice Installation. These parameters can be used to influence therunning time by utilizing environment
variables.

ShowSetup

Shows the application window whilerunning 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

Chapter 8

Example37

Comments
Sub MyEndProc

Start of the MyEndProc procedure

HideSetup

Hides the StarOffice 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 ( "StarOffice Chart 5.2" )rem DeSelectModuleByName ( "StarOffice Chart 5.2" )EndifSelectModuleByID ( "gid_Module_Prg_Image" )rem

DeSelectModuleByID ( "gid_Module_Prg_Image" )End Sub
Comments

38

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

Installation with Response Files • June 2000

Comments
EnvVar = Environ( "vcsid" )Defines the EnvVar variable andassigns an environment variable asvalue

If EnvVar = "HE"Requests the EnvVar with the 'HE'
value.

Then
SelectModuleByName ( "StarOffice Chart 5.2" )Selects further module – StarOffice
Chart5.2 - with the module name.

Rem
Deselects the corresponding
DeSelectModuleByName( "StarOffice Chart 5.2" ) module with the module name.
Endif

Ends the If loop.

SelectModuleByID ( "gid_Module_Prg_Image" )Selects a Module on the basis of its
Module ID.

Rem
DeSelectModuleByID( "gid_Module_Prg_Image" )Deselects the corresponding
module by its module ID

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

Chapter 8

Example39

40

Installation with Response Files • June 2000

CHAPTER

9

9

Customer Support
If you have any questions regarding support visit our interactive Knowledge Databaseat:http://www.sun.com/staroffice/support
We hope you enjoy using StarOffice.

41