Difference between revisions of "Creating an EPrints MSI"

From EPrints Documentation
Jump to: navigation, search
(Requirements)
(Requirements)
 
(3 intermediate revisions by the same user not shown)
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]
To build the Zip source package:
 
 
 
 
* [http://subversion.apache.org/ Subversion]
 
* [http://subversion.apache.org/ Subversion]
* Perl + XML::LibXML (see [[Installing EPrints 3 on Win32]])
+
* 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/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:
 +
 
 +
C:\Program Files\Windows Installer XML v3\bin
  
=== Srvany.exe ===
+
== Building the MSI ==
  
Download and install the [http://www.microsoft.com/downloads/details.aspx?FamilyID=9D467A69-57FF-4AE7-96EE-B18C4790CFFD&displaylang=en. Windows Server 2003 Resource Kit Tools].
+
Start a command-prompt.
  
Once installed copy the srvany.exe file to a convenient location (you can now uninstall the resource kit if you wish to).
+
Retrieve the EPrints release build tool (requires valid EPrints.org account):
  
=== EPrints MSI Package ===
+
svn co https://svn.eprints.org/eprints/tools/release
  
Download the EPrints Win32 installation builder file (eprints-XXX-win32.zip) and unpack it to somewhere convenient. Copy srvany.exe to the unpacked directory (the same location as eprints.wsx).
+
Copy <code>srvany.exe</code> from the Windows 2003 Toolkit into the new release folder.
  
To build the Zip file from EPrints source:
+
cd release
 +
copy "C:\Program Files\Windows Resource Kits\Tools\srvany.exe" srvany.exe
  
  svn co https://svn.eprints.org/eprints/tools/release
+
Build the .msi package:
  perl makepackage.pl --win32 --zip nightly
 
  
== Building the MSI ==
+
perl makepackage.pl --win32 nightly
  
Start a command-prompt and change to the directory you unpacked eprints-XXX-win32.zip to.
+
The .msi file will be written to the <code>packages\</code> sub-folder.
  
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>
+
To continue installing EPrints follow the instructions at [[Installing EPrints 3 on Win32]].
  
  candle eprints.wsx
+
== WiX Notes ==
  light -ext WixUIExtension eprints.wixobj
 
  
You should now have a "eprints.msi" installation package.
+
These are the WiX commands executed by the package builder:
  
To continue installing EPrints follow the instructions at [[Installing EPrints 3 on Win32]].
+
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