Difference between revisions of "Documentation/Administration Guide/Windows"

From Apache OpenOffice Wiki
Jump to: navigation, search
Line 7: Line 7:
 
}}
 
}}
 
{{DISPLAYTITLE:Microsoft Windows}}
 
{{DISPLAYTITLE:Microsoft Windows}}
<!--
 
 
== Windows Installer (MSI) Packages ==
 
== Windows Installer (MSI) Packages ==
The StarOffice setup uses under Windows MSI packages. MSI is the standard for installation packages under Windows. Newer Windows releases (2000, XP) includes a Microsoft Installer with an User Interface. The installation with User Interface get described in the [http://docs.sun.com/app/docs/doc/817-7351?a=load StarOffice 8 Getting Started Guide.]
+
The {{OOo}} setup uses Windows MSI packages. MSI is the standard for installation packages under Windows.
  
Unattended installations and the other installation options could started with the mouse. They required a command shell. The Microsoft Installer provides a rich set of command line parameters. The most important parameters get described here.  
+
Unattended installations and the other installation options cannot be started in the GUI, they must be started in a command shell. The Microsoft Installer provides a rich set of command line parameters. The most important parameters are described here.  
  
The Advertise option (/J{m|u}) of the Windows installer is not supported by the StarOffice installation package.
+
The Advertise option (/J{m|u}) of the Windows installer is not supported by the {{OOo}} installation package.
  
 
=== User of a download installation set ===
 
=== User of a download installation set ===
  
{{Documentation/Note|The following steps are not necessary for download installation sets which are newer than from January 2006. Those providing two new parameters /EXTRACTONLY=ON and /D to extract the packages.
+
<!-- {{Documentation/Note|The following steps are not necessary for download installation sets which are newer than from January 2006. Those providing two new parameters /EXTRACTONLY=ON and /D to extract the packages.
  
 
  /EXTRACTONLY=ON Activates the expand option
 
  /EXTRACTONLY=ON Activates the expand option
Line 28: Line 27:
  
 
Skip the rest of the steps below}}
 
Skip the rest of the steps below}}
 +
-->
  
All files of the StarOffice installation set are packed in a single file at the download version of the StarOffice installation set. This file need to be unpacked first before the MSI package is directly accessible.  
+
All files of the {{OOo}} installation set are packed in a single file in the download version of the {{OOo}} installation set. This file must be unpacked first before the MSI package is accessible.  
  
 
To expand the download installation set :
 
To expand the download installation set :
  
 
# Double click on the the file from the download install set or start the file from the command line.
 
# Double click on the the file from the download install set or start the file from the command line.
# The StarOffice 8 Installation Preparation Wizard appears.
+
# The {{OOo}} Installation Preparation Wizard appears.
 
# Select the folder in which to save the unpacked files.
 
# Select the folder in which to save the unpacked files.
# Once all files are unpacked, the regular StarOffice 8 Installation dialog appears.  
+
# Once all files are unpacked, the regular {{OOo}} Installation dialog appears.  
# Do not follow the installation dialog. Leave the dialog open and copy the expanded files from the installation set in a different directory.
+
# Do not follow the installation dialog. Leave the dialog open and copy the expanded files from the installation set into a different directory.
# Cancel the StarOffice Installation dialog now.
+
# Cancel the {{OOo}} Installation dialog.
  
 
=== Customized installation ===
 
=== Customized installation ===
Customized installation means to install StarOffice without a certain package. The Windows Installer uses 'transformation templates' to customize the normal installation package. The StarOffice Enterprise CD, which is part of the Enterprise Edition, includes a Wizard to create those transformation templates.  
+
Customized installation means to install {{OOo}} without certain packages. The Windows Installer uses 'transformation templates' to customize the normal installation package.  
 +
<!-- The StarOffice Enterprise CD, which is part of the Enterprise Edition, includes a Wizard to create those transformation templates. -->
  
# Start the Transformation Wizard directly from the Enterprise CD or expanded download installation set
+
# Start the Transformation Wizard directly from the expanded download installation set
# Enter the directory where the staroffice8.msi packages are located. This could be the Office directory on your installation CD or the directory with the expanded files from the download installation set. (See above to expand the download installation set)
+
# Enter the directory where the openoffice.msi packages are located.
# Click next to specify the modules/features and the location of the StarOffice installation.
+
# Click next to specify the modules/features and the location of the {{OOo}} installation.
# Click next to make StarOffice or another Office suite to the preferred suite for editing of Microsoft Office documents.
+
# Click next to make {{OOo}} or another Office suite to the preferred suite for editing of Microsoft Office documents.
 
# Choose a location for the transformation template and click create.
 
# Choose a location for the transformation template and click create.
# To install StarOffice with the transformation template
+
# To install {{OOo}} with the transformation template
 
+
<!--
 
  <nowiki>msiexec /qn /i starOffice8.msi TRANSFORMS=<transformation template></nowiki>
 
  <nowiki>msiexec /qn /i starOffice8.msi TRANSFORMS=<transformation template></nowiki>
 
+
-->
 
=== Unattended (silent) installation ===
 
=== Unattended (silent) installation ===
 
The parameter /qn suppress the User Interface and all message boxes during the installation.
 
The parameter /qn suppress the User Interface and all message boxes during the installation.
 
+
<!--
 
  msiexec /qn /i staroffice8.msi
 
  msiexec /qn /i staroffice8.msi
 
+
-->
=== Administrative installation option. Copy the StarOffice installation set on a network share. ===
+
=== Administrative installation option. Copy the {{OOo}} installation set on a network share. ===
The installation type does not install StarOffice on machine, it copies the installation files, ready for a StarOffice installation, in a directory. The user could start the StarOffice setup from this directory for a local installation.
+
The installation type does not install {{OOo}} on machine, it copies the installation files, ready for a {{OOo}} installation, in a directory. The user could start the {{OOo}} setup from this directory for a local installation.
 
+
<!--
 
  msiexec /a starOffice8.msi
 
  msiexec /a starOffice8.msi
 
+
-->
=== Deinstallation ===
+
=== Uninstall ===
The deinstallation from the command line of MSI packages is not easy. Using the original name of the MSI package does not work. The Windows Installer expect the ProductCode of the application. The product code for an English StarOffice installation set is different to the product code for a German or Italian installation set. StarOffice saves this ProductCode into the setup.ini that is located in the program directory of StarOffice. The parameter for the deinstallation is /X and the /qn- parameter for a silent installation.  
+
Uninstalling MSI packages from the command line is not easy. Using the original name of the MSI package does not work. The Windows Installer expects the ProductCode of the application. The product code for an English {{OOo}} installation set is different to the product code for a German or Italian installation set. {{OOo}} saves this ProductCode into the setup.ini that is located in the program directory of {{OOo}}. The parameter for the uninstall is /X and the /qn- parameter for a silent installation.  
 
+
<!--
 
  msiexec /qn- /x {4BC1CB2B-FDCE-4DB4-A557-BA8127569B0D}
 
  msiexec /qn- /x {4BC1CB2B-FDCE-4DB4-A557-BA8127569B0D}
 
+
-->
Heads up: It is most likely that the ProductCode {4BC1CB2B-FDCE-4DB4-A557-BA8127569B0D} won't work for you. You have to determine the product code for your StarOffice installation. How to do it, see above.
+
{{Documentation/Note|The ProductCode above {4BC1CB2B-FDCE-4DB4-A557-BA8127569B0D} is an example. You must determine the correct product code for your {{OOo}} installation.}}
  
 
=== Repairing StarOffice installation ===
 
=== Repairing StarOffice installation ===
Existing StarOffice installations could also be repaired. The MSI installation provides a rich set of options
+
Existing {{OOo}} installations can also be repaired
  
 
  <nowiki>msiexec /f [p|o|e|d|c|a|u|m|s|v] /x {Product Code}</nowiki>
 
  <nowiki>msiexec /f [p|o|e|d|c|a|u|m|s|v] /x {Product Code}</nowiki>
Line 78: Line 79:
 
The Product Code is described above.
 
The Product Code is described above.
  
=== Installing StarOffice Product Upgrades/Patches (unattended) ===
+
<!--
 +
=== Installing {{OOo}} Product Upgrades/Patches (unattended) ===
 
The Product Updates are not regular MSI patches. They are normal MSI packages and has to be installed as any other MSI package. However to install the patches without user interaction you have to start the installation from the command line. Before you could do this you have to expand the patch installation file first.  
 
The Product Updates are not regular MSI patches. They are normal MSI packages and has to be installed as any other MSI package. However to install the patches without user interaction you have to start the installation from the command line. Before you could do this you have to expand the patch installation file first.  
  

Revision as of 09:06, 18 July 2008


Windows Installer (MSI) Packages

The Apache OpenOffice setup uses Windows MSI packages. MSI is the standard for installation packages under Windows.

Unattended installations and the other installation options cannot be started in the GUI, they must be started in a command shell. The Microsoft Installer provides a rich set of command line parameters. The most important parameters are described here.

The Advertise option (/J{m|u}) of the Windows installer is not supported by the Apache OpenOffice installation package.

User of a download installation set

All files of the Apache OpenOffice installation set are packed in a single file in the download version of the Apache OpenOffice installation set. This file must be unpacked first before the MSI package is accessible.

To expand the download installation set :

  1. Double click on the the file from the download install set or start the file from the command line.
  2. The Apache OpenOffice Installation Preparation Wizard appears.
  3. Select the folder in which to save the unpacked files.
  4. Once all files are unpacked, the regular Apache OpenOffice Installation dialog appears.
  5. Do not follow the installation dialog. Leave the dialog open and copy the expanded files from the installation set into a different directory.
  6. Cancel the Apache OpenOffice Installation dialog.

Customized installation

Customized installation means to install Apache OpenOffice without certain packages. The Windows Installer uses 'transformation templates' to customize the normal installation package.

  1. Start the Transformation Wizard directly from the expanded download installation set
  2. Enter the directory where the openoffice.msi packages are located.
  3. Click next to specify the modules/features and the location of the Apache OpenOffice installation.
  4. Click next to make Apache OpenOffice or another Office suite to the preferred suite for editing of Microsoft Office documents.
  5. Choose a location for the transformation template and click create.
  6. To install Apache OpenOffice with the transformation template

Unattended (silent) installation

The parameter /qn suppress the User Interface and all message boxes during the installation.

Administrative installation option. Copy the Apache OpenOffice installation set on a network share.

The installation type does not install Apache OpenOffice on machine, it copies the installation files, ready for a Apache OpenOffice installation, in a directory. The user could start the Apache OpenOffice setup from this directory for a local installation.

Uninstall

Uninstalling MSI packages from the command line is not easy. Using the original name of the MSI package does not work. The Windows Installer expects the ProductCode of the application. The product code for an English Apache OpenOffice installation set is different to the product code for a German or Italian installation set. Apache OpenOffice saves this ProductCode into the setup.ini that is located in the program directory of Apache OpenOffice. The parameter for the uninstall is /X and the /qn- parameter for a silent installation. Template:Documentation/Note

Repairing StarOffice installation

Existing Apache OpenOffice installations can also be repaired

msiexec /f [p|o|e|d|c|a|u|m|s|v] /x {Product Code}

A description of all repair options is available here :http://msdn.microsoft.com/library/default.asp?url=/library/en-us/msi/setup/command_line_options.asp

The Product Code is described above.

Content on this page is licensed under the Public Documentation License (PDL).
Personal tools