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

From Apache OpenOffice Wiki
Jump to: navigation, search
(→‎Windows Installer (MSI) Packages)
Line 7: Line 7:
 
}}
 
}}
 
{{DISPLAYTITLE:Microsoft Windows}}
 
{{DISPLAYTITLE:Microsoft Windows}}
−
== Windows Installer (MSI) Packages ==
+
== Microsoft Windows Installer (MSI) Packages ==
−
The {{OOo}} setup uses Windows MSI packages. MSI is the standard for installation packages under Windows.
+
The {{OOo}} setup uses Microsoft Windows MSI packages. MSI is the standard tool for installing packages under Microsoft 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.  
 
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.  
Line 14: Line 14:
 
The Advertise option (/J{m|u}) of the Windows installer is not supported by the {{OOo}} 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 ===
+
=== Extract the {{OOo}} installation files ===
−
 
+
−
<!-- {{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
+
−
 
+
−
/D Specifies the directory to expand
+
−
 
+
−
The command line for those installations sets looks like this :
+
−
 
+
−
so8-bin-windows-en-US_<Optional languages>.exe /EXTRACTONLY=ON /D=C:\
+
−
 
+
−
Skip the rest of the steps below}}
+
−
-->
+
  
 
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.  
 
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.  
Line 35: Line 22:
 
# 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 {{OOo}} Installation Preparation Wizard appears.
 
# The {{OOo}} Installation Preparation Wizard appears.
−
# Select the folder in which to save the unpacked files.
+
# Click Next.
−
# Once all files are unpacked, the regular {{OOo}} Installation dialog appears.  
+
# Select the Destination Folder to the unpacked files.
−
# Do not follow the installation dialog. Leave the dialog open and copy the expanded files from the installation set into a different directory.
+
# Once all files are unpacked, the regular {{OOo}} Installation Wizard dialog appears. 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 {{OOo}} Installation dialog.
+
# Click Cancel in the {{OOo}} Installation Wizard, click Yes to confirm the cancellation, and click Finish to close the Installation Wizard.
  
 +
<!--
 
=== Customized installation ===
 
=== Customized installation ===
 +
 
Customized installation means to install {{OOo}} without certain packages. The Windows Installer uses 'transformation templates' to customize the normal installation package.  
 
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. -->
 
<!-- 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 expanded download installation set
 
# Start the Transformation Wizard directly from the expanded download installation set
−
# Enter the directory where the openoffice.msi packages are located.
+
# Enter the directory where the openoffice<version>.msi packages is located.
 
# Click next to specify the modules/features and the location of the {{OOo}} installation.
 
# Click next to specify the modules/features and the location of the {{OOo}} installation.
 
# Click next to make {{OOo}} 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 {{OOo}} 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 is used to suppress the User Interface and all message boxes during the installation.
−
<!--
+
 
−
  msiexec /qn /i staroffice8.msi
+
  msiexec /qn /i openofficeorg<version>.msi
−
-->
+
 
−
=== Administrative installation option. Copy the {{OOo}} installation set on a network share. ===
+
=== Administrative installation option. Copy the {{OOo}} installation set to a network share ===
−
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.
+
 
−
<!--
+
This installation type does not install {{OOo}} on single 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
+
 
−
-->
+
* Start the network Installation Wizard
 +
  msiexec /a openofficeorg<version>.msi
 +
* Click Next
 +
* Specify the network share where the installation files will be copied.  Make sure that you choose an appropriate destination directory on the network share.
 +
* Click Finish.
 +
 
 +
 
 +
 
 
=== Uninstall ===
 
=== 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 {{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.  
 
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.  
Line 95: Line 92:
 
-->
 
-->
 
{{PDL1}}
 
{{PDL1}}
 +
''Italic text''

Revision as of 11:42, 18 July 2008


Microsoft Windows Installer (MSI) Packages

The Apache OpenOffice setup uses Microsoft Windows MSI packages. MSI is the standard tool for installing packages under Microsoft 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.

Extract the Apache OpenOffice installation files

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. Click Next.
  4. Select the Destination Folder to the unpacked files.
  5. Once all files are unpacked, the regular Apache OpenOffice Installation Wizard dialog appears. Do not follow the installation dialog. Leave the dialog open and copy the expanded files from the installation set into a different directory.
  6. Click Cancel in the Apache OpenOffice Installation Wizard, click Yes to confirm the cancellation, and click Finish to close the Installation Wizard.


  1. Start the Transformation Wizard directly from the expanded download installation set
  2. Enter the directory where the openoffice<version>.msi packages is 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 
msiexec /qn /i starOffice8.msi TRANSFORMS=<transformation template>

-->

Unattended (silent) installation

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

msiexec /qn /i openofficeorg<version>.msi

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

This installation type does not install Apache OpenOffice on single 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.

  • Start the network Installation Wizard 
msiexec /a openofficeorg<version>.msi
  • Click Next
  • Specify the network share where the installation files will be copied. Make sure that you choose an appropriate destination directory on the network share.
  • Click Finish.


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



Italic text

Retrieved from "https://wiki.openoffice.org/w/index.php?title=Documentation/Administration_Guide/Windows&oldid=87076"
Personal tools