Editing Windows Installer

Jump to navigation Jump to search
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
:''This article is about how to make the Microsoft Windows installer; if you'd like just to use the installer, see [[Octave for Microsoft Windows]].''
GNU Octave is primarily developed on GNU/Linux and other POSIX conformal systems. There have been many efforts in the past to build ports of GNU Octave for Windows. Take a look at the various ports of Octave available for Windows [http://wiki.octave.org/Octave_for_Windows here].
GNU Octave is primarily developed on GNU/Linux and other POSIX compliant systems. There have been many efforts in the past to build ports of GNU Octave for Microsoft Windows.
This page contains instructions about creating a MS Windows installer using [[MXE|mxe-octave]] (a fork of [http://mxe.cc/ MXE]).
This means, '''the MS Windows installer is [https://en.wikipedia.org/wiki/Cross_compiler cross-compiled] using a GNU/Linux system'''.


==Creating the MS Windows Installer==
Recently some work has been done in maintaining a unified build system mxe-octave (a fork of [http://mxe.cc/ MXE]) which anyone can use to produce cross as well as native builds of GNU Octave for Windows and Mac OS X platforms. This page contains instructions about creating a Windows installer using mxe-octave.


===General steps===
==Installing requirements of MXE Octave==
# Reassure you have the package libffi-dev installed or the Python build will silently be incomplete
MXE Octave requires a recent Unix system where all components as stated below are installed.
# Install the MXE build requirements.<ref>The requirements for each system are listed in the repository https://hg.octave.org/mxe-octave/file/tip/index.html.  Start with the second step to read the {{Path|index.html}} file on your local machine.</ref>
# <code>hg clone https://hg.octave.org/mxe-octave</code><ref>Use <code>hg clone https://hg.octave.org/mxe-octave <name of mxe-octave build dir></code> to choose another directory.</ref>
# <code>cd mxe-octave</code>
# <code>./bootstrap</code> (Among other things, the <code>bootstrap</code> script creates the <code>configure</code> script for the next step.)
# <code>./configure</code>
# <code>make all nsis-installer</code>


===Step details===
===Debian (GNU/kFreeBSD & GNU/Linux)===
aptitude install -R autoconf automake bash bison bzip2 \
                    cmake flex gettext git g++ intltool \
                    libffi-dev libtool libltdl-dev openssl libssl-dev \
                    libxml-parser-perl make patch perl \
                    pkg-config scons sed unzip wget \
                    xz-utils yasm


====<code>./configure</code>====
On 64-bit Debian, install also:


The current Microsoft Windows installers are build in three "flavors": for common 64- and 32-bit systems ('''"w64"''' and '''"w32"''') and for 64-bit systems exceeding 32 GB of main memory to store large data structures ('''"w64-64"''').
aptitude install -R g++-multilib libc6-dev-i386


{| class="wikitable"
If you are using Ubuntu, then you can do
! "w64" (recommended)
apt-get install foo
! "w64-64"
instead of
! "w32"
aptitude install -R foo
|-style="vertical-align:top;"
| <pre style="min-width:330px;">
./configure                        \
  --enable-devel-tools            \
  --enable-binary-packages        \
  --with-ccache                    \
  --enable-octave=<octave version>
</pre>
| <pre style="min-width:330px;">
./configure                        \
  --enable-devel-tools            \
  --enable-binary-packages        \
  --with-ccache                    \
  --enable-octave=<octave version> \
  --enable-fortran-int64
</pre>
| <pre style="min-width:330px;">
./configure                        \
  --enable-devel-tools            \
  --enable-binary-packages        \
  --with-ccache                    \
  --enable-octave=<octave version> \
  --disable-windows-64
</pre>
|}


The individual options have the following meaning (see also <code>./configure --help</code>):
===Fedora===
yum install autoconf automake bash bison bzip2 cmake \
            flex gcc-c++ gettext git intltool make sed \
            libffi-devel libtool openssl-devel patch perl pkgconfig \
            scons yasm unzip wget xz


* <code>--enable-devel-tools</code>: Include gdb and an MSYS shell in the binary.
===FreeBSD===
** If you seriously want to work with gdb, you need <code>--disable-strip-dist-files</code> as configure option to keep debug symbols in the installed binaries for debugging on MS Windows. Beware as the total Octave distribution will be > 2 GB, the max. size for an NSIS installer. Your only options are to make 7z-dist, zip-dist or tar-dist installers.
  pkg_add -r automake111 autoconf268 bash bison cmake \
* <code>--enable-binary-packages</code>: Cross-compile binary modules in [[Octave Forge]] packages. This saves time when installing them once the installation runs on Microsoft Windows. Furthermore, some packages require patches to cross-compile successfully (or with current Octave versions). Those additional patches would be missing when compiling the original packages from Octave Forge on Windows later on. Some Octave Forge packages require a working Octave during compilation. Therefore, the correct version(!) of Octave must be installed on the host system.
            flex gettext git gmake gsed intltool libffi libtool \
* <code>--with-ccache</code>: The usage of [https://ccache.dev/ ccache] may speed up repetitive compilation drastically.
            openssl patch perl p5-XML-Parser pkg-config \
* <code>--enable-octave=<octave version></code>: Build a specific version of GNU Octave, which can be one of:
            scons unzip wget yasm
** <code>release</code> use {{Path|src/release-octave.mk}}, download and build the latest GNU Octave release.
** <code>stable</code> or <code>default</code> uses {{Path|src/stable-octave.mk}} or {{Path|src/default-octave.mk}}, respectively. This builds from a self-created distribution tarball from the "stable" or "default" development branch of GNU Octave.  See [[#Build installers for Octave development versions|below]] for details.
* <code>--disable-windows-64</code>: Build for 32-bit MS Windows.
* <code>--enable-fortran-int64</code>: Use 64-bit integers in Fortran code and especially in numerical library code.  This option only affects the size of integers used in Fortran code like the BLAS and LAPACK libraries. On 64-bit systems, Octave always uses 64-bit integers for indexing and basic array operations.  See [[Enable large arrays: Build octave such that it can use arrays larger than 2Gb.|Enable large arrays]] for details.
* <code>--disable-system-opengl</code>: Include software OpenGL libraries. This might help when working with buggy graphics card drivers, but might be slower than hardware accelerated rendering.
* <code>--with-pkg-dir=../mxe-octave-pkg</code>: If you are working with several build trees, you can share a common package directory.


====<code>make</code>====
===Frugalware===
pacman-g2 -S autoconf automake bash bzip2 bison cmake \
              flex gcc gettext git intltool make sed libffi libtool \
              openssl patch perl perl-xml-parser pkgconfig \
              scons unzip wget xz xz-lzma yasm


* Use <code>make all 7z-dist</code>, <code>make all tar-dist</code> or <code>make all zip-dist</code> instead of <code>make all nsis-installer</code> if you want to build just an archive of the files to install on MS Windows instead of an installer wizard.
===Gentoo===
* By default, packages will be built one at a time '''without parallelization'''. You may use <code>make JOBS=4</code> (choose a number other than 4 that is appropriate for your system) to build each individual package in parallel.
emerge sys-devel/autoconf sys-devel/automake \
** '''Avoid using the <code>-j</code> option for <code>make</code>:''' Using <code>-j</code> enables building packages in parallel, which can mess up the mxe build system.  Use this option with care!  Another pitfall is the example <code>make -j4 JOBS=4</code>, which can result in as many as 16 jobs running at once.
        app-shells/bash sys-devel/bison app-arch/bzip2 \
* Include gdb in the installer by running <code>make gdb</code> before making the <code>nsis-installer</code> target.
        dev-util/cmake sys-devel/flex sys-devel/gcc \
        sys-devel/gettext dev-vcs/git \
        dev-util/intltool sys-devel/make sys-apps/sed \
        dev-libs/libffi sys-devel/libtool dev-libs/openssl sys-devel/patch \
        dev-lang/perl dev-perl/XML-Parser \
        dev-util/pkgconfig dev-util/scons app-arch/unzip \
        net-misc/wget app-arch/xz-utils dev-lang/yasm


===Build installers for Octave development versions===
===Mac OS X===
Install Xcode 4 and MacPorts, then run:


# Build the "stable" or "default" Octave development branch on Linux (in separate source and build trees) including your favorite modifications and patches. Octave must be configured with Java support.  How to do this depends on your Linux distribution, see [[Building]].
  sudo port install autoconf automake bison cmake flex \
# Verify that Octave runs fine in Linux (for example using <code>make check</code> and by trying to run your build <code>./run-octave --gui</code>).
                  gettext git-core gsed intltool libffi libtool \
# Create a distribution archive called '''"octave-<version>.tar.lz"''' in the top build directory with <code>make dist-lzip DIST_IGNORE_HG_STATE=1</code>. <code>lzip</code> needs to be available for this step. (On Debian-like systems, it can be installed with <code>apt-get install lzip</code>).
                  openssl p5-xml-parser pkgconfig scons \
# Move or copy '''"octave-<version>.tar.lz"''' to the {{Path|<mxe-octave build>/pkg}} folder (or create a symbolic link to it).
                  wget xz yasm
# Follow the [[#General steps|general steps]] and ensure the configuration with either of <code>--enable-octave=stable</code> or <code>--enable-octave=default</code>.
# Move the final installer in {{Path|<mxe-octave build>/dist}} to some Microsoft Windows machine (USB thumb drive, LAN copy, whatever) and install it "as usual".  If you created an archive, using <code>make all 7z-dist</code> for example, you'll have to manually create the desktop and start menu shortcuts (for GNU Octave and the MSYS-shell).


For next builds, mxe-octave is already configured and all dependencies have been built so the only thing to do is to create a new '''"octave-<version>.tar.lz"''' and repeating the steps above.  This should be much faster than the first run.  If the new '''"octave-<version>.tar.lz"''' is not build and ignored, try the following:
Mac OS X versions ≤ 10.6 are no longer supported.


touch src/default-octave.mk
===MingW===
Make sure to update and upgrade packages as some of the default versions of packages are too old to work correctly.


If you've renamed '''"octave-<version>.tar.lz"''', be sure it matches with the package name in {{Path|src/default-octave.mk}}.
mingw-get update


===Remarks===
mingw-get upgrade


* If you have several MXE-Octave build dirs (for e.g., stable and several development versions, or build trees for 32bit and 64bit Windows targets), it is possible to point to a common {{Path|pkg}} directory using the configure flag <code>--with-pkg-dir=path_to_common_pkg_directory</code>. That way downloading the packages for each build tree can be avoided. Thus, potentially saving a lot of downloading bandwidth.
And then get required packages.
* As of late December 2015, [https://hg.octave.org/mxe-octave/rev/0962acdde3be MXE-Octave allows out-of-tree builds]. This makes it easier to build separate Octave versions with the same MXE-Octave tree.
* To keep MXE-Octave up-to-date, from time to time run the following commands in the MXE-Octave repository:
hg -v pull
hg -v update
* However, some package updates might need a clean build tree. If an incremental build fails after an update, consider running <code>make clean</code> or starting with a fresh clone, see [[#General steps|General steps]].
* In the mean time, you might want to regularly clean up {{Path|<mxe-octave build dir>/log}} to save disk space. The logs are of informational value only and are not needed after the build completes. They can safely be deleted.
* It can happen that you meet problems with Java. To build Octave with Java support built-in, MXE-Octave needs:
** A Java JDK (Java Development Kit) on the '''build''' system. In other words, the javac (Java compiler) and jar (Java archiver) executables should be in the PATH-system-variable.
** Java include files for MS Windows. They should reside in {{Path|<mxe-octave build dir>/usr/x86_64-w64-mingw32/include/java/win32}} or {{Path|<mxe-octave build dir>/usr/i686-w64-mingw32/include/java/win32}}, respectively. If they are not present, MXE-Octave downloads them automatically. However, this might fail occasionally (e.g. if the server cannot be reached). On a multi-boot system, a solution (note: dirty hack warning!) is symlinking to the MS Windows include files on the MS Windows partition from the MXE-Octave location. (Don't do this unless you are sure what you are doing.)


===Troubleshooting===
mingw-get install autoconf bash msys-bison msys-flex gcc gcc-c++ \
                gcc-fortran gettext msys-m4 msys-make msys-sed \
          libiconv msys-openssl msys-patch msys-perl \
                  msys-libarchive msys-unzip msys-wget msys-bsdtar
   
You will also need to install Windows versions of Python and Ghostscript and ensure they are in visible in the PATH.


* The error message displayed by <code>make</code> is simply the last lines of the log file. This may truncate the actual error message.  Find the full error messages in the {{Path|<mxe-octave build>/log}} directory.
===OpenSUSE===
* Sometimes running <code>make</code> a second time without changing anything will fix the problem.  In particular, <code>autotools</code> rebuilds some files in the first call <code>make</code>, which may cause the second call of <code>make</code> to succeed.
  zypper install -R autoconf automake bash bison bzip2 \
* If it is building Octave that failed, the source will be left in {{Path|<mxe-octave build>/tmp-default-octave}} and it is possible to run "configure && make" in that directory.
                  cmake flex gcc-c++ gettext-tools git \
* The configuration will be for the target system, not your own.  In particular, if you have not installed all of the packages that mxe-octave installs, then your configuration will be different.  However, some configuration variables will differ even if you have the same packages, and some compiler features may be available on the host system that are not available in cross-compile mode.
                  intltool libffi-devel libtool make openssl \
* A possible causes for build failure is having files in your local source or build directory that are not listed in the {{Path|module.mk}} files; these are not copied into the dist archive.
                  libopenssl-devel patch perl \
* Sometimes mxe-octave builds fail at "libmng".  This may be due to a race condition related to disk I/O when using a fast SSD harddisk. A way to get past this is by specifying "make nsis-installer JOBS=1", if required repeatedly (sometimes 5 or 6 times), interrupting the build in the next step/dependency once "libmng" has been built fine, and restarting with "make nsis-installer JOBS=<higher number>". As of December 2015 it is only libmng that has this issue.
                  perl-XML-Parser pkg-config scons \
                  sed unzip wget xz yasm


==Testing using virtual machines==
On 64-bit openSUSE, install also:
zypper install -R gcc-32bit glibc-devel-32bit \
                  libgcc46-32bit libgomp46-32bit \
                  libstdc++46-devel-32bit


Microsoft provides several virtual machine (e.g. VirtualBox) disk images of MS Windows for about one month of testing
Steps to create Windows Installer
* https://developer.microsoft.com/en-us/windows/downloads/virtual-machines
* https://developer.microsoft.com/en-us/microsoft-edge/tools/vms (primarily meant for testing the MS-Edge browser)
The license (given on that page) for these images does not limit the use of these images. So it is perfectly possible to also test GNU Octave.


The key idea is to create a shared folder inside the virtual machine to the mxe-octave build directory. It is advised to make it read-only. Either install (or unpack) Octave into MS Windows 10, or create a shortcut to {{Path|octave.vbs}} in the {{Path|<mxe-octave build dir>/dist/octave}} subdirectory on the Linux side.
# Install all requirements for compiling GNU Octave. (Some help for [[Debian]] users)
 
# hg clone http://hg.octave.org/mxe-octave/
Some advantages:
# cd mxe-octave
* No dedicated MS Windows machine or rebooting from Linux is needed;
# autoconf
* The <strike>latest</strike> MS Windows 10 version is always available;
# ./configure
* Building the installer archives (zip, 7z, ...) isn't needed. One can interrupt the build process after the local installation of Octave has been made in the dist/octave subdirectory of mxe-octave, i.e., when the message "generating installer" (or "zip...") is shown. This saves about 10-15 minutes. Of course one can also use the common distribution formats for the virtual MS Windows machine.
# ./mk-dist --installer
 
Hints:
* It is possible to adapt {{Path|mxe-octave/binary-dist-rules.mk}} to have a consistent name for the {{Path|<mxe-octave build dir>/dist/octave}} subdirectory (i.e., without time/date/bitwidth suffixes). This way, in MS Windows the shortcut doesn't need adaptation after each cross-build action. Maybe it would be better if {{Path|mxe-octave/binary-dist-rules.mk}} had a rule to create a symlink {{Path|<mxe-octave build dir>/dist/octave}} pointing to the latest cross-build.
* The image expires after 30 days. But if you make a VirtualBox snapshot before starting the VM the first time, you can revert to that snapshot (essentially, the image will last longer). This way, you also won't need to uninstall Octave each time before installing a new build.
 
==Footnotes==
 
<references/>
 
[[Category:Building]]
[[Category:Microsoft Windows]]
Please note that all contributions to Octave may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see Octave:Copyrights for details). Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel Editing help (opens in new window)

Template used on this page: