Difference between revisions of "Building on Ubuntu 18"
(Created page with "<span style="color:red">'''This page is under construction'''</span>. Building GridPACK on Ubuntu 18.04 is slightly more complicated than building it on Ubuntu 16.04. The mai...") |
|||
| Line 1: | Line 1: | ||
<span style="color:red">'''This page is under construction'''</span>. | <span style="color:red">'''This page is under construction'''</span>. | ||
| − | Building GridPACK on Ubuntu 18.04 is slightly more complicated than building it on Ubuntu 16.04. The main differences are that 1) the PPN build does not work for this version of Ubuntu and 2) the Global Arrays library must be built by hand. MPI, Boost and PETSc can all be installed using the package manager. This example was performed on a [https://www.virtualbox.org/ Virtual Box] instance running a clean install of [http://releases.ubuntu.com/ | + | Building GridPACK on Ubuntu 18.04 is slightly more complicated than building it on Ubuntu 16.04. The main differences are that 1) the PPN build does not work for this version of Ubuntu and 2) the Global Arrays library must be built by hand. MPI, Boost and PETSc can all be installed using the package manager. This example was performed on a [https://www.virtualbox.org/ Virtual Box] instance running a clean install of [http://releases.ubuntu.com/18.04/ Ubuntu Linux 18.04 (LTS)]. Virtual Box is not required and this build should work on Linux systems using the Ubuntu operating system. <span style="color:red">'''You will need super user or sudo privileges for this installation'''</span>. |
A few basic development packages will be necessary. Install them with | A few basic development packages will be necessary. Install them with | ||
| Line 18: | Line 18: | ||
== Build and Install Global Arrays == | == Build and Install Global Arrays == | ||
| − | Get the [http://hpc.pnl.gov/globalarrays/ Global Arrays] source from the [https://github.com/GlobalArrays/ga/releases/tag/v5.6.5 release page]. | + | Get the [http://hpc.pnl.gov/globalarrays/ Global Arrays] source from the [https://github.com/GlobalArrays/ga/releases/tag/v5.6.5 release page]. We recommend using version 5.6 or 5.7 but any recent version should work. Unpack GA in a convenient location. In the unpacked directory, configure, build, and install using |
| − | ./configure -- | + | ./configure --enable-i4 --without-blas --enable-cxx --with-mpi-ts --disable-f77 \ |
| − | + | --prefix=<span style="color:red">"/home/gridpack/software/ga-5.7"</span> | |
make | make | ||
make install | make install | ||
| + | |||
| + | Be sure and replace the install directory in <span style="color:red">red</span> with an appropriate directory on your local system. | ||
== Build and Test GridPACK == | == Build and Test GridPACK == | ||
| Line 39: | Line 41: | ||
Or, modify this configuration recipe to fit your needs: | Or, modify this configuration recipe to fit your needs: | ||
| − | + | rm -rf CMake* | |
| − | CXX=g++ | + | export CC=gcc |
| − | + | export CXX=g++ | |
| − | + | ||
| − | cmake \ | + | cmake \ |
| − | -D PETSC_DIR:STRING="/usr/lib/ | + | -D PETSC_DIR:STRING="/usr/lib/petsc" \ |
| − | |||
-D PARMETIS_DIR:PATH="/usr" \ | -D PARMETIS_DIR:PATH="/usr" \ | ||
| − | -D | + | -D GA_DIR:STRING=<span style="color:red">"/home/gridpack/software/ga-5.7"</span> \ |
-D MPI_CXX_COMPILER:STRING="mpicxx" \ | -D MPI_CXX_COMPILER:STRING="mpicxx" \ | ||
-D MPI_C_COMPILER:STRING="mpicc" \ | -D MPI_C_COMPILER:STRING="mpicc" \ | ||
-D MPIEXEC:STRING="mpiexec" \ | -D MPIEXEC:STRING="mpiexec" \ | ||
-D MPIEXEC_MAX_NUMPROCS:STRING="2" \ | -D MPIEXEC_MAX_NUMPROCS:STRING="2" \ | ||
| − | -D GRIDPACK_TEST_TIMEOUT:STRING= | + | -D GRIDPACK_TEST_TIMEOUT:STRING="20" \ |
-D USE_GLPK:BOOL=ON \ | -D USE_GLPK:BOOL=ON \ | ||
-D GLPK_ROOT_DIR:PATH="/usr" \ | -D GLPK_ROOT_DIR:PATH="/usr" \ | ||
-D BUILD_SHARED_LIBS:BOOL=OFF \ | -D BUILD_SHARED_LIBS:BOOL=OFF \ | ||
| − | -D CMAKE_INSTALL_PREFIX:PATH=" | + | -D CMAKE_INSTALL_PREFIX:PATH=<span style="color:red">"/home/gridpack/gridpack-3.3/src/build/install"</span> \ |
| − | + | CC=gcc CXX=g++ .. | |
| − | + | ||
| − | make</ | + | make |
| + | |||
| + | Again, be sure and modify the Global Array directory and the GridPACK installation directories in <span style="color:red">red</span> to match the appropriate locations on your local system. | ||
If compilation is successful, the [[How to Build GridPACK#Running Tests|unit tests]] and/or [[How to Build GridPACK#Running_the_Powerflow_Example.28s.29|example applications]] can be run. | If compilation is successful, the [[How to Build GridPACK#Running Tests|unit tests]] and/or [[How to Build GridPACK#Running_the_Powerflow_Example.28s.29|example applications]] can be run. | ||
Revision as of 16:38, 3 April 2019
This page is under construction.
Building GridPACK on Ubuntu 18.04 is slightly more complicated than building it on Ubuntu 16.04. The main differences are that 1) the PPN build does not work for this version of Ubuntu and 2) the Global Arrays library must be built by hand. MPI, Boost and PETSc can all be installed using the package manager. This example was performed on a Virtual Box instance running a clean install of Ubuntu Linux 18.04 (LTS). Virtual Box is not required and this build should work on Linux systems using the Ubuntu operating system. You will need super user or sudo privileges for this installation.
A few basic development packages will be necessary. Install them with
sudo apt-get install git build-essential devscripts equivs
Contents
Install Required Packages
All the GridPACK prerequisites packages can be installed using the packaging information in the source. Run this command in the top directory of the cloned repository:
sudo mk-build-deps -i
This will make and install a virtual package called gridpack-build-deps with most of the dependencies needed to build GridPACK.
Build and Install Global Arrays
Get the Global Arrays source from the release page. We recommend using version 5.6 or 5.7 but any recent version should work. Unpack GA in a convenient location. In the unpacked directory, configure, build, and install using
./configure --enable-i4 --without-blas --enable-cxx --with-mpi-ts --disable-f77 \
--prefix="/home/gridpack/software/ga-5.7"
make
make install
Be sure and replace the install directory in red with an appropriate directory on your local system.
Build and Test GridPACK
Obtain the GridPACK release or development code and put it in a convenient directory.
Configure and build GridPACK using the recipe for gridpackvm in example_configuration.sh. From the top-most GridPACK source directory, do the following:
mkdir src/build cd src/build bash ../example_configuration.sh gridpackvm make make test
Or, modify this configuration recipe to fit your needs:
rm -rf CMake* export CC=gcc export CXX=g++ cmake \ -D PETSC_DIR:STRING="/usr/lib/petsc" \ -D PARMETIS_DIR:PATH="/usr" \ -D GA_DIR:STRING="/home/gridpack/software/ga-5.7" \ -D MPI_CXX_COMPILER:STRING="mpicxx" \ -D MPI_C_COMPILER:STRING="mpicc" \ -D MPIEXEC:STRING="mpiexec" \ -D MPIEXEC_MAX_NUMPROCS:STRING="2" \ -D GRIDPACK_TEST_TIMEOUT:STRING="20" \ -D USE_GLPK:BOOL=ON \ -D GLPK_ROOT_DIR:PATH="/usr" \ -D BUILD_SHARED_LIBS:BOOL=OFF \ -D CMAKE_INSTALL_PREFIX:PATH="/home/gridpack/gridpack-3.3/src/build/install" \ CC=gcc CXX=g++ .. make
Again, be sure and modify the Global Array directory and the GridPACK installation directories in red to match the appropriate locations on your local system.
If compilation is successful, the unit tests and/or example applications can be run.
Removing Required Software
If no longer needed, the required packages can be removed using
sudo apt-get purge gridpack-build-deps sudo apt autoremove
