Notes410

Table of Contents

• Changes
• Default options
  • Windows
• Steps
  • Windows
  • Packaging
  • Installing
• TODO and Wish List

Changes

• Added additional options for:
  • SILO project is now upgradable manually when using MSVC2008 Express, if INTERACTIVE_UPGRADE is set to ON.
  • Installing the development files:
  • Set ENABLE_paraviewsdk to ON, which will install the ParaView development files into the intermediate "install" folder. This feature was adapted from the Projects/unix folder into Projects/win32.
  • Set mpi_INSTALL_DEVELOPMENT to ON, which will install the Open-MPI build into a sibling folder of the target installation.
  • (UNTESTED, inherited from the development of 3.98.0 Notes3980) Options for building with Java wrappers have been added, but might not yet be complete in VTK 6.1. You can try them for yourself, by turning on ParaView_MODULE_VTKWRAPPINGJAVA and ParaView_VTK_WRAP_JAVA.
• Had to perform a few more patches to Open-MPI 1.4.4's CMake source files, to avoid it trying to look up for a FORTRAN compiler, unless strictly requested, as well as some other issues associated to build options.
• Had to add the hack for also installing the *.lib files when installing the whole ParaView bundle, in case the SDK option is chosen.

Default options

Here is a list with the defaults used in CMake.

Windows

Even though the base folder used in this build was at P:/ParaView-4.1.0-sandbox/, it was necessary to futher trim down the path to W:/, because otherwise it would not be possible to perform the build. So here's an example for 64bit, along with the defaults:

• SuperBuild source code folder: W:/ParaViewSuperBuild
• Build folder: W:/pv64build
• Download jam.exe from http://sourceforge.net/projects/freetype/files/ftjam/2.5.2/ftjam-2.5.2-win32.zip/download and place it in the main folder: W:/
• Download the source code file http://www.paraview.org/files/v4.1/ParaView-v4.1.0-source.zip and place it in the folder W:/downloads

• CMake options:

  ~~~~~~
  CMAKE_CONFIGURATION_TYPES:STRING=Release
  CMAKE_CXX_FLAGS <- append /MP
  CMAKE_C_FLAGS <- append /MP
  CMAKE_INSTALL_PREFIX:STRING=W:/release-x64/ParaView-4.1.0-Windows-64bit

  download_location:PATH=W:/downloads

  ENABLE_qt:BOOL=ON
  USE_SYSTEM_qt:BOOL=ON
  QT_QMAKE_EXECUTABLE:PATH=Q:/4.8.2_x64/bin/qmake.exe

  ParaView_FROM_GIT:BOOL=OFF
  ParaView_URL:PATH=W:/downloads/ParaView-v4.1.0-source.zip
  ParaView_URL_MD5:STRING=efeac04858599aedf0131eb23beb249c

  qt_DISABLE_WEBKIT:BOOL=OFF

  FTJAM_EXECUTABLE:PATH=W:/jam.exe
  DEVENV_PATH:PATH=d:/PROGRA~2/MICROS~1.0/Common7/IDE/VCExpress.exe
  NMAKE_PATH:PATH=d:/PROGRA~2/MICROS~1.0/VC/bin/amd64/nmake.exe

  This one is necessary only for MSVC Express

  INTERACTIVE_UPGRADE:BOOL=ON

  ENABLE_paraviewsdk:BOOL=ON
  mpi_INSTALL_DEVELOPMENT:BOOL=ON

  ENABLE_acusolve:BOOL=OFF
  ENABLE_boost:BOOL=ON
  ENABLE_cgns:BOOL=ON
  ENABLE_freetype:BOOL=ON
  ENABLE_hdf5:BOOL=ON
  ENABLE_libxml2:BOOL=OFF
  ENABLE_manta:BOOL=OFF
  ENABLE_matplotlib:BOOL=ON
  ENABLE_mpi:BOOL=ON
  ENABLE_numpy:BOOL=ON
  ENABLE_paraview:BOOL=ON
  ENABLE_png:BOOL=ON
  ENABLE_python:BOOL=ON
  ENABLE_qt:BOOL=ON
  ENABLE_silo:BOOL=ON
  ENABLE_szip:BOOL=ON
  ENABLE_visitbridge:BOOL=ON
  ENABLE_vistrails:BOOL=OFF
  ENABLE_zlib:BOOL=ON
  ~~~~~~

Steps

These steps are for recreating the official builds of ParaView, as well as turn on the additional features presented in this unofficial project.

Windows

You'll have to do these steps once per architecture (x86 and x86_64):

1. Install the MSVC 2008 version of Qt 4.8.2 (if in doubt, pick with Qt3) from http://code.google.com/p/qt-msvc-installer/.

2. Install Git for Windows: http://msysgit.github.com/

3. Download the source code for the ParaView SuperBuild using either one of the following:

   • Using git:
     git clone git://git.code.sf.net/p/unofficial-paraview-sdk/superbuild410
     cd superbuild410
     git checkout unofficial_r2

   • Or download and unpack a zip snapshot from the repository: unofficial_r2.zip - click on the "Download Snapshot" link.

4. Configure the project with the CMake GUI. For each one, you'll probably have to hit the "Configure" button.

   1. Properly define where to install by defining CMAKE_INSTALL_PREFIX.
      a. Warning: use a two level path, e.g. c:/ParaViewBuilds/ParaView-4.1.0-win32. This is because the options mpi_INSTALL_DEVELOPMENT:BOOL=ON will install the development packages in the respective subfolders at c:/ParaViewBuilds/.
   2. Notes:
      a. Always use in your paths with CMake the slash character '/', as exemplified in the previous point.
      b. If you want to spare yourself some grief, DO NOT use folder paths that have SPACES in them...
   3. The remaining configuration variables are in the previous chapter Default options
   4. When done configuring it all, hit the "Configure" and/or "Generate" buttons.

5. To build the project, open the file ParaViewSuperBuild.sln with MSVC 2008 (Express).

6. Choose the Release version, instead of the Debug version.
7. Menu Solution -> Build Solution.
8. Build as many times as necessary, since there might be missing dependencies. Check the logs for errors.
9. When all built and for installing, right click on the project INSTALL and select Project only -> Build only INSTALL.

Packaging

Creating the self-extractables:

1. Have 7zip accessible from the command line and go to the base of the SuperBuild installations.
2. Run for each respective package the following commands:
   • ParaView complete development folder:
   • 7z a -sfx -t7z -mx=9 -ms=on -mmt=on ParaView-4.1.0-win32-complete_dev-r1.exe ParaView-4.1.0-Windows-32bit
   • 7z a -sfx -t7z -mx=9 -ms=on -mmt=on ParaView-4.1.0-win64-complete_dev-r1.exe ParaView-4.1.0-Windows-64bit
   • Open-MPI:
   • 7z a -sfx -t7z -mx=9 -ms=on -mmt=on OpenMPI-1.4.4-win32-r1.exe OpenMPI-Windows-32bit
   • 7z a -sfx -t7z -mx=9 -ms=on -mmt=on OpenMPI-1.4.4-win64-r1.exe OpenMPI-Windows-64bit

Installing

Currently they are self-extractable, not installers themselves. Either run where they are and place the resulting folder where you want... Or run each self-extractable like this:

 ParaView-4.1.0-win32-complete_dev-r1.exe -o"C:\ParaViewDevs\"
 ParaView-4.1.0-win64-complete_dev-r1.exe -o"C:\ParaViewDevs\"

TODO and Wish List

• Add additional options for:

  • installing ParaView at the end of the SuperBuild process.

  • Actually, need something like this (source):

        ADD_CUSTOM_COMMAND(
            TARGET crysfml
            POST_BUILD
            COMMAND ${CMAKE_COMMAND} -E make_directory my_dir2
            COMMAND ${CMAKE_COMMAND} -E copy_directory my_dir1 my_dir2)
    

  • packaging with NSIS and/or ZIP the development version of ParaView.