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

From Apache OpenOffice Wiki
Jump to: navigation, search
(New page: {{Documentation/AdminGuideTOC/v2 |OS_type=block |ShowPrevNext=block |ShowPrevPage=none |NextPage=Documentation/Administration Guide/Using Custom Macros and Libraries }} {{DISPLAYTITLE:Micr...)
 
m (→‎Copy the {{AOo}} installation set to a network share)
 
(39 intermediate revisions by 4 users not shown)
Line 2: Line 2:
 
|OS_type=block
 
|OS_type=block
 
|ShowPrevNext=block
 
|ShowPrevNext=block
−
|ShowPrevPage=none
+
|ShowPrevPage=block
−
|NextPage=Documentation/Administration Guide/Using Custom Macros and Libraries
+
|PrevPage=Documentation/Administration Guide/Linux
−
}}
+
|NextPage=Documentation/Administration Guide/Mac OS X
 +
}}  
 
{{DISPLAYTITLE:Microsoft Windows}}
 
{{DISPLAYTITLE:Microsoft Windows}}
 +
__NOTOC__
 +
The {{AOo}} setup for Microsoft Windows uses MSI packages. MSI is the standard tool for installing software packages under Microsoft Windows.
  
−
== Windows Installer (MSI) Packages ==
+
{{Note|The Advertise option (<tt><nowiki>/J{m|u}</nowiki></tt>) of the Microsoft Software Installer is not supported by the {{AOo}} installation package.}}
−
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.]
+
  
−
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.
+
=== Extract the {{AOo}} installation files ===
  
−
The Advertise option (/J{m|u}) of the Windows installer is not supported by the StarOffice installation package.
+
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.  
−
 
+
−
=== 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.
+
−
 
+
−
/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 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.  
+
  
 
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 StarOffice 8 Installation Preparation Wizard appears.
+
# The {{AOo}} Installation Preparation Wizard appears.
−
# Select the folder in which to save the unpacked files.
+
# Click {{button|Next}}.
−
# Once all files are unpacked, the regular StarOffice 8 Installation dialog appears.  
+
# Select the Destination Folder for the unpacked files.
−
# Do not follow the installation dialog. Leave the dialog open and copy the expanded files from the installation set in 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.
−
# Cancel the StarOffice Installation dialog now.
+
# 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 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.
 
  
−
# Start the Transformation Wizard directly from the Enterprise CD or expanded download installation set
+
Customized installation means to install {{AOo}} without certain packages. The Windows Installer uses 'transformation templates' to customize the normal installation package.  
−
# 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)
+
The StarOffice Enterprise CD, which is part of the Enterprise Edition, includes a Wizard to create those transformation templates.
−
# Click next to specify the modules/features and the location of the StarOffice installation.
+
−
# Click next to make StarOffice or another Office suite to the preferred suite for editing of Microsoft Office documents.
+
−
# Choose a location for the transformation template and click create.
+
−
# To install StarOffice with the transformation template
+
  
−
<nowiki>msiexec /qn /i starOffice8.msi TRANSFORMS=<transformation template></nowiki>
+
# Start the Transformation Wizard directly from the expanded download installation set
 +
# Enter the directory where the openoffice<version>.msi package is located.
 +
# Click {{button|Next}} to specify the modules/features and the location of the {{AOo}} installation.
 +
# 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 {{button|Create}}.
 +
# To install {{AOo}} with the transformation template
 +
<syntaxhighlight lang="text">
 +
  msiexec /qn /i starOffice8.msi TRANSFORMS=<transformation template>
 +
</syntaxhighlight>
 +
-->
  
 
=== 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.
 +
<syntaxhighlight lang="text">
 +
msiexec /qn /i openofficeorg<version>.msi
 +
</syntaxhighlight>
 +
=== Copy the {{AOo}} installation set to a network share ===
  
−
  msiexec /qn /i staroffice8.msi
+
This type of installation does not install {{AOo}} on a single machine, instead it copies the installationfiles, ready for a future {{AOo}} installation, into a directory. The user could later start the {{AOo}} setup from this directory for a local installation.
 +
<ol>
 +
<li>Start the network Installation Wizard
 +
<syntaxhighlight lang="text">
 +
  msiexec /a openofficeorg<version>.msi
 +
</syntaxhighlight>
 +
</li>
 +
<li>Click {{button|Next}}</li>
 +
<li>Specify the network share where the installation files will be copied.</li>
 +
<li>Click {{button|Install}}.</li>
 +
<li>Click {{button|Finish}} when the installer is finished copying the files to the network share.</li>
 +
</ol>
 +
Users can install {{AOo}} from this shared network location by browsing to the shared directory and double-clicking on <tt>openofficeorg<version>.msi</tt>.
  
−
=== Administrative installation option. Copy the StarOffice installation set on a network share. ===
+
{{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
−
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.
+
<code>xcopy /v /y /e /z '''template-dir''' "%APPDATA%\OpenOffice.org\4\"</code>}}
  
−
msiexec /a starOffice8.msi
+
If you want to install addons, then you can use the command:
 +
<code>echo yes | "c:\program files\openoffice.org 4\program\unopkg.com" add <specificaddon>.oxt</code>
  
−
=== 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 {{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.  
  
−
  msiexec /qn- /x {4BC1CB2B-FDCE-4DB4-A557-BA8127569B0D}
+
<ol>
 +
<li>Open a filemanager and browse to <openoffice-install-dir>/program.</li>
 +
<li>Open setup.ini and locate the ProductCode.</li>
 +
<li>Uninstall {{AOo}} with:
 +
<syntaxhighlight lang="text">
 +
  msiexec /qn /x {4BC1CB2B-FDCE-4DB4-A557-BA8127569B0D}
 +
</syntaxhighlight>
 +
</li>
 +
</ol>
  
−
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.
+
{{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 StarOffice installation ===
+
−
Existing StarOffice installations could also be repaired. The MSI installation provides a rich set of options
+
−
 
+
−
<nowiki>msiexec /f [p|o|e|d|c|a|u|m|s|v] /x {Product Code}</nowiki>
+
−
 
+
−
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 http://msdn.microsoft.com/library/default.asp?url=/library/en-us/msi/setup/command_line_options.asp]
+
−
 
+
−
The Product Code is described above.
+
−
 
+
−
=== Installing StarOffice 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.
+
−
 
+
−
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.
+
=== Repairing an {{AOo}} installation ===
−
# The StarOffice Patch Installation Wizard appears
+
Existing {{AOo}} installations can also be repaired using <tt>msiexec</tt>.
−
# Select the folder in which to save the unpacked files.
+
<syntaxhighlight lang="text">
−
# Do not continue with the patch installation and click on the cancel button to patch Installation
+
msiexec /f [p|o|e|d|c|a|u|m|s|v] /x {ProductCode}
−
# Open a command prompt and go to the directory where the expanded patch installation files are located
+
</syntaxhighlight>
−
# Enter following command:
+
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]
−
  setup /qn
+
−
# The patch get installed now.
+
  
 +
{{InterWiki Languages AdminGuide|articletitle=Documentation/Administration Guide/Windows}}
 
{{PDL1}}
 
{{PDL1}}

Latest revision as of 15:57, 27 May 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 type of installation does not install Apache OpenOffice on a single machine, instead it copies the installationfiles, 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 filemanager 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).
Retrieved from "https://wiki.openoffice.org/w/index.php?title=Documentation/Administration_Guide/Windows&oldid=248437"
Personal tools
In other languages