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

From Apache OpenOffice Wiki
Jump to: navigation, search
 
Line 8: Line 8:
 
{{DISPLAYTITLE:Microsoft Windows}}
 
{{DISPLAYTITLE:Microsoft Windows}}
 
__NOTOC__  
 
__NOTOC__  
The {{OOo}} setup for Microsoft Windows uses MSI packages. MSI is the standard tool for installing software packages under Microsoft Windows.
+
The {{AOo}} setup for Microsoft Windows uses MSI packages. MSI is the standard tool for installing software packages under Microsoft Windows.
  
{{Note|The Advertise option (<tt><nowiki>/J{m|u}</nowiki></tt>) of the Microsoft Software Installer is not supported by the {{OOo}} installation package.}}
+
{{Note|The Advertise option (<tt><nowiki>/J{m|u}</nowiki></tt>) of the Microsoft Software Installer is not supported by the {{AOo}} installation package.}}
  
=== Extract the {{OOo}} installation files ===
+
=== Extract the {{AOo}} installation files ===
  
All files of the {{OOo}} installation set are packed into a single file in the download version of the {{OOo}} installation set. This file must be unpacked before the MSI package is accessible.  
+
All files of the {{AOo}} installation set are packed into a single file in the download version of the {{AOo}} installation set. This file must be unpacked 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 file from the download install set or start the file from the command line.
# The {{OOo}} Installation Preparation Wizard appears.
+
# The {{AOo}} Installation Preparation Wizard appears.
# Click Next.
+
# Click {{button|Next}}.
 
# Select the Destination Folder for the unpacked files.
 
# Select the Destination Folder for the unpacked files.
# 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.
+
# Once all files are unpacked, the regular {{AOo}} 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.
# Click Cancel in the {{OOo}} Installation Wizard, click Yes to confirm the cancellation, and click Finish to close the Installation Wizard.
+
# Click {{button|Cancel}} in the {{AOo}} Installation Wizard, click Yes to confirm the cancellation, and click {{button|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 {{AOo}} 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<version>.msi packages is located.
+
# Enter the directory where the openoffice<version>.msi package is located.
# Click next to specify the modules/features and the location of the {{OOo}} installation.
+
# Click {{button|Next}} to specify the modules/features and the location of the {{AOo}} installation.
# Click next to make {{OOo}} or another Office suite to the preferred suite for editing of Microsoft Office documents.
+
# Click {{button|Next}} to make {{AOo}} 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 {{button|Create}}.
# To install {{OOo}} with the transformation template
+
# To install {{AOo}} with the transformation template
 
+
<syntaxhighlight lang="text">
<nowiki>msiexec /qn /i starOffice8.msi TRANSFORMS=<transformation template></nowiki>
+
  msiexec /qn /i starOffice8.msi TRANSFORMS=<transformation template>
 +
</syntaxhighlight>
 
-->
 
-->
  
 
=== Unattended (silent) installation ===
 
=== Unattended (silent) installation ===
 
The parameter /qn is used to 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.
 
+
<syntaxhighlight lang="text">
 
  msiexec /qn /i openofficeorg<version>.msi
 
  msiexec /qn /i openofficeorg<version>.msi
 +
</syntaxhighlight>
 +
=== Copy the {{AOo}} installation set to a network share ===
  
=== Copy the {{OOo}} installation set to a network share ===
+
This installation type does not install {{AOo}} on single machine, instead it copies the installation files, ready for a future {{AOo}} installation, into a directory. The user could later start the {{AOo}} setup from this directory for a local installation.
 
+
This installation type does not install {{OOo}} on single machine, instead it copies the installation files, ready for a future {{OOo}} installation, into a directory. The user could later start the {{OOo}} setup from this directory for a local installation.
+
 
<ol>
 
<ol>
 
<li>Start the network Installation Wizard
 
<li>Start the network Installation Wizard
<source lang="text">
+
<syntaxhighlight lang="text">
 
  msiexec /a openofficeorg<version>.msi
 
  msiexec /a openofficeorg<version>.msi
</source>
+
</syntaxhighlight>
 
</li>
 
</li>
<li>Click Next</li>
+
<li>Click {{button|Next}}</li>
 
<li>Specify the network share where the installation files will be copied.</li>
 
<li>Specify the network share where the installation files will be copied.</li>
<li>Click Install.</li>
+
<li>Click {{button|Install}}.</li>
<li>Click Finish when the installer is finished copying the files to the network share.</li>
+
<li>Click {{button|Finish}} when the installer is finished copying the files to the network share.</li>
 
</ol>
 
</ol>
Users can install {{OOo}} from this shared network location by browsing to the shared directory and double clicking on <tt>openofficeorg<version>.msi</tt>.
+
Users can install {{AOo}} from this shared network location by browsing to the shared directory and double-clicking on <tt>openofficeorg<version>.msi</tt>.
  
 
{{Note|If you choose to include specific configuration files for a specific environment, you can copy them from a template directory you created into the users' application data directory using the command
 
{{Note|If you choose to include specific configuration files for a specific environment, you can copy them from a template directory you created into the users' application data directory using the command
<tt>xcopy /v /y /e /z '''template-dir''' "%APPDATA%\OpenOffice.org\3\"</tt>}}
+
<tt>xcopy /v /y /e /z '''template-dir''' "%APPDATA%\OpenOffice.org\4\"</tt>}}
  
 
If you want to install addons, then you can use the command:
 
If you want to install addons, then you can use the command:
  echo yes | "c:\program files\openoffice.org 3\program\unopkg.com" add <specificaddon>.oxt
+
  echo yes | "c:\program files\openoffice.org 4\program\unopkg.com" add <specificaddon>.oxt
  
 
=== 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 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 {{AOo}} installation set is different to the product code for a German or Italian installation set. {{AOo}} saves this ProductCode into the setup.ini that is located in the program directory of {{AOo}}. The parameter for the uninstall is /x and the /qn parameter for a silent uninstall.  
  
 
<ol>
 
<ol>
<li>Open a file manager and browse to <openoffice.org-install-dir>/program.</li>
+
<li>Open a file manager and browse to <openoffice-install-dir>/program.</li>
 
<li>Open setup.ini and locate the ProductCode.</li>
 
<li>Open setup.ini and locate the ProductCode.</li>
<li>Uninstall {{OOo}} with:
+
<li>Uninstall {{AOo}} with:
<source lang="text">
+
<syntaxhighlight lang="text">
 
  msiexec /qn /x {4BC1CB2B-FDCE-4DB4-A557-BA8127569B0D}
 
  msiexec /qn /x {4BC1CB2B-FDCE-4DB4-A557-BA8127569B0D}
</source>
+
</syntaxhighlight>
 
</li>
 
</li>
 
</ol>
 
</ol>
  
{{Note|The ProductCode <tt>{4BC1CB2B-FDCE-4DB4-A557-BA8127569B0D}</tt> is an example. You must find the correct product code for your specific {{OOo}} installation.}}
+
{{Note|The ProductCode <tt>{4BC1CB2B-FDCE-4DB4-A557-BA8127569B0D}</tt> is an example. You must find the correct product code for your specific {{AOo}} installation.}}
 
+
=== Repairing an {{OOo}} installation ===
+
Existing {{OOo}} installations can also be repaired using <tt>msiexec</tt>.
+
 
+
<nowiki>msiexec /f [p|o|e|d|c|a|u|m|s|v] /x {ProductCode}</nowiki>
+
  
A description of all repair options is available online in the Microsoft Developer Network: [http://msdn.microsoft.com/en-us/library/Aa367988 http://msdn.microsoft.com/en-us/library/Aa367988]
+
=== Repairing an {{AOo}} installation ===
 +
Existing {{AOo}} installations can also be repaired using <tt>msiexec</tt>.
 +
<syntaxhighlight lang="text">
 +
msiexec /f [p|o|e|d|c|a|u|m|s|v] /x {ProductCode}
 +
</syntaxhighlight>
 +
A description of all repair options is available online in the Microsoft Developer Network: [https://docs.microsoft.com/en-us/windows/win32/msi/command-line-options https://docs.microsoft.com/en-us/windows/win32/msi/command-line-options]
  
 
{{InterWiki Languages AdminGuide|articletitle=Documentation/Administration Guide/Windows}}
 
{{InterWiki Languages AdminGuide|articletitle=Documentation/Administration Guide/Windows}}
 
{{PDL1}}
 
{{PDL1}}

Latest revision as of 14:24, 1 February 2021


The Apache OpenOffice setup for Microsoft Windows uses MSI packages. MSI is the standard tool for installing software packages under Microsoft Windows.

Documentation note.png The Advertise option (/J{m|u}) of the Microsoft Software 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 into a single file in the download version of the Apache OpenOffice installation set. This file must be unpacked before the MSI package is accessible.

To expand the download installation set :

  1. Double-click on 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 for 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.

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

Copy the Apache OpenOffice installation set to a network share

This installation type does not install Apache OpenOffice on single machine, instead it copies the installation files, ready for a future Apache OpenOffice installation, into a directory. The user could later start the Apache OpenOffice setup from this directory for a local installation.

  1. Start the network Installation Wizard
     msiexec /a openofficeorg<version>.msi
  2. Click  Next 
  3. Specify the network share where the installation files will be copied.
  4. Click  Install .
  5. Click  Finish  when the installer is finished copying the files to the network share.

Users can install Apache OpenOffice from this shared network location by browsing to the shared directory and double-clicking on openofficeorg<version>.msi.

Documentation note.png If you choose to include specific configuration files for a specific environment, you can copy them from a template directory you created into the users' application data directory using the command

xcopy /v /y /e /z template-dir "%APPDATA%\OpenOffice.org\4\"

If you want to install addons, then you can use the command:

echo yes | "c:\program files\openoffice.org 4\program\unopkg.com" add <specificaddon>.oxt

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

  1. Open a file manager and browse to <openoffice-install-dir>/program.
  2. Open setup.ini and locate the ProductCode.
  3. Uninstall Apache OpenOffice with:
     msiexec /qn /x {4BC1CB2B-FDCE-4DB4-A557-BA8127569B0D}
Documentation note.png The ProductCode {4BC1CB2B-FDCE-4DB4-A557-BA8127569B0D} is an example. You must find the correct product code for your specific Apache OpenOffice installation.

Repairing an Apache OpenOffice installation

Existing Apache OpenOffice installations can also be repaired using msiexec.

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

A description of all repair options is available online in the Microsoft Developer Network: https://docs.microsoft.com/en-us/windows/win32/msi/command-line-options

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