Difference between revisions of "Creating an EPrints MSI"

From EPrints Documentation
Jump to: navigation, search
(Created page with 'Category:Installing {{Template:version|since=3.2.1}} Note: this page is only for those wishing to build a Win32 installer of the EPrints package. If you wish to install EPr…')
 
(Requirements)
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Category:Installing]]
+
[[Category:Installation]]
  
 
{{Template:version|since=3.2.1}}
 
{{Template:version|since=3.2.1}}
Line 7: Line 7:
 
== Requirements ==
 
== Requirements ==
  
Microsoft Windows XP SP3 or later with .NET.
+
* Microsoft Windows XP SP3 or later with .NET
 +
* [http://www.microsoft.com/downloads/details.aspx?FamilyID=9D467A69-57FF-4AE7-96EE-B18C4790CFFD&displaylang=en. Windows Server 2003 Resource Kit Tools]
 +
* [http://subversion.apache.org/ Subversion]
 +
* Perl with XML::LibXML (see [[Installing EPrints 3 on Win32]])
 +
* [http://gnuwin32.sourceforge.net/packages/zip.htm gnuwin32 zip tool]
 +
* [http://gnuwin32.sourceforge.net/packages/unzip.htm gnuwin32 unzip tool]
 +
 
 +
Make sure svn, perl and zip are in your working path.
  
 
=== WiX ===
 
=== WiX ===
  
Download and install the latest stable version of WiX (3.0 as of writing) from http://wix.sourceforge.net/.
+
Download and install the 3.0 or later version of [http://wix.sourceforge.net/ WiX].
  
 
Ignore any errors reported due to missing Visual Studio (we don't need it).
 
Ignore any errors reported due to missing Visual Studio (we don't need it).
  
Note: you will need to use the command-line tools from WiX so you may wish to relocate it to somewhere more convenient than <em>Program Files</em>.
+
Add the WiX bin path to your working path:
  
=== Srvany.exe ===
+
C:\Program Files\Windows Installer XML v3\bin
  
Download and install the Windows Server 2003 Resource Kit Tools from http://www.microsoft.com/downloads/details.aspx?FamilyID=9D467A69-57FF-4AE7-96EE-B18C4790CFFD&displaylang=en.
+
== Building the MSI ==
  
Once installed copy the srvany.exe file to a convenient location (you can now uninstall the resource kit if you wish to).
+
Start a command-prompt.
  
=== EPrints MSI Package ===
+
Retrieve the EPrints release build tool (requires valid EPrints.org account):
  
Download the EPrints MSI package ZIP file (eprints-XXX-win32.zip) and unpack it to somewhere convenient. Copy srvany.exe to the unpacked directory (the same location as eprints.wsx).
+
svn co https://svn.eprints.org/eprints/tools/release
  
== Building the MSI ==
+
Copy <code>srvany.exe</code> from the Windows 2003 Toolkit into the new release folder.
  
Start a command-prompt and change to the directory you unpacked eprints-XXX-win32.zip to.
+
cd release
 +
copy "C:\Program Files\Windows Resource Kits\Tools\srvany.exe" srvany.exe
  
If you do not have the WiX tools in your path you will need to prepend the full path to the WiX command-line tools for <code>candle</code> and <code>light</code>
+
Build the .msi package:
  
  candle eprints.wsx
+
perl makepackage.pl --win32 nightly
  light -ext WixUIExtension eprints.wixobj
 
  
You should now have a "eprints.msi" installation package.
+
The .msi file will be written to the <code>packages\</code> sub-folder.
  
 
To continue installing EPrints follow the instructions at [[Installing EPrints 3 on Win32]].
 
To continue installing EPrints follow the instructions at [[Installing EPrints 3 on Win32]].
 +
 +
== WiX Notes ==
 +
 +
These are the WiX commands executed by the package builder:
 +
 +
candle eprints.wsx
 +
light -ext WixUIExtension eprints.wixobj

Latest revision as of 12:05, 10 January 2011


Warning This feature requires EPrints version 3.2.1 or later

Note: this page is only for those wishing to build a Win32 installer of the EPrints package. If you wish to install EPrints on Windows see Installing EPrints 3 on Win32.

Requirements

Make sure svn, perl and zip are in your working path.

WiX

Download and install the 3.0 or later version of WiX.

Ignore any errors reported due to missing Visual Studio (we don't need it).

Add the WiX bin path to your working path:

C:\Program Files\Windows Installer XML v3\bin

Building the MSI

Start a command-prompt.

Retrieve the EPrints release build tool (requires valid EPrints.org account):

svn co https://svn.eprints.org/eprints/tools/release

Copy srvany.exe from the Windows 2003 Toolkit into the new release folder.

cd release
copy "C:\Program Files\Windows Resource Kits\Tools\srvany.exe" srvany.exe

Build the .msi package:

perl makepackage.pl --win32 nightly

The .msi file will be written to the packages\ sub-folder.

To continue installing EPrints follow the instructions at Installing EPrints 3 on Win32.

WiX Notes

These are the WiX commands executed by the package builder:

candle eprints.wsx
light -ext WixUIExtension eprints.wixobj