Difference between revisions of "Building on Ubuntu"
(16 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | This | + | GridPACK is relatively easy to build on Ubuntu Linux systems. This example was performed on a [https://www.virtualbox.org/ Virtual Box] instance running a clean install of [http://releases.ubuntu.com/16.04/ Ubuntu Linux 16.04 (LTS)]. Virtual Box is not required and this build should work on Linux systems using the Ubuntu operating system. If you have no need to modify the GridPACK library itself, consider [[Ubuntu_Installation| installing the binary package]]. <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 | |
− | + | <pre>sudo apt-get install git build-essential devscripts equivs</pre> | |
− | |||
− | + | == Install Required Packages == | |
− | + | Before installing the remaining packages, you ''must'' first download GridPACK onto your computer and put it in a convenient directory. Instructions for downloading GridPACK can be found [[Download_GridPACK| here]]. | |
− | + | All the [https://www.gridpack.org/wiki/index.php/Software_Required_to_Build_GridPACK GridPACK prerequisites] packages can be installed using the packaging information in the source. Run this command in the top directory of the GridPACK repository: | |
+ | <pre>sudo mk-build-deps -i</pre> | ||
− | + | This will make and install a virtual package called <code>gridpack-build-deps</code> with all the dependencies needed to build GridPACK. | |
− | + | Alternatively, all required packages will be installed by [[Ubuntu_Installation| installing the GridPACK binary package]]. | |
− | + | == Build and Test GridPACK == | |
− | |||
+ | Configure and build GridPACK using the recipe for <code>gridpackvm</code> in <code>example_configuration.sh</code>. From the top-most GridPACK source directory, do the following: | ||
− | + | <pre>mkdir src/build | |
+ | cd src/build | ||
+ | bash ../example_configuration.sh gridpackvm | ||
+ | make | ||
+ | make test</pre> | ||
− | + | Or, modify this configuration recipe to fit your needs: | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | <pre>CC=gcc | |
+ | CXX=g++ | ||
+ | export CC CXX | ||
− | == | + | cmake \ |
+ | -D PETSC_DIR:STRING="/usr/lib/petscdir/3.6.2" \ | ||
+ | -D PETSC_ARCH:STRING="x86_64-linux-gnu-real" \ | ||
+ | -D PARMETIS_DIR:PATH="/usr" \ | ||
+ | -D GA_EXTRA_LIBS:STRING="-lscalapack-openmpi -lblacsCinit-openmpi -lblacs-openmpi -llapack -lblas -lgfortran" \ | ||
+ | -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=60 \ | ||
+ | -D USE_GLPK:BOOL=ON \ | ||
+ | -D GLPK_ROOT_DIR:PATH="/usr" \ | ||
+ | -D BUILD_SHARED_LIBS:BOOL=OFF \ | ||
+ | -D CMAKE_INSTALL_PREFIX:PATH="$HOME/gridpack" \ | ||
+ | -D CMAKE_VERBOSE_MAKEFILE:BOOL=TRUE \ | ||
+ | .. | ||
+ | make</pre> | ||
− | [ | + | 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. |
− | + | == Removing Required Software == | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
+ | If no longer needed, the required packages can be removed using | ||
− | |||
− | + | <pre>sudo apt-get purge gridpack-build-deps | |
− | + | sudo apt autoremove</pre> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Latest revision as of 15:09, 9 May 2019
GridPACK is relatively easy to build on Ubuntu Linux systems. This example was performed on a Virtual Box instance running a clean install of Ubuntu Linux 16.04 (LTS). Virtual Box is not required and this build should work on Linux systems using the Ubuntu operating system. If you have no need to modify the GridPACK library itself, consider installing the binary package. 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
Install Required Packages
Before installing the remaining packages, you must first download GridPACK onto your computer and put it in a convenient directory. Instructions for downloading GridPACK can be found here.
All the GridPACK prerequisites packages can be installed using the packaging information in the source. Run this command in the top directory of the GridPACK repository:
sudo mk-build-deps -i
This will make and install a virtual package called gridpack-build-deps
with all the dependencies needed to build GridPACK.
Alternatively, all required packages will be installed by installing the GridPACK binary package.
Build and Test GridPACK
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:
CC=gcc CXX=g++ export CC CXX cmake \ -D PETSC_DIR:STRING="/usr/lib/petscdir/3.6.2" \ -D PETSC_ARCH:STRING="x86_64-linux-gnu-real" \ -D PARMETIS_DIR:PATH="/usr" \ -D GA_EXTRA_LIBS:STRING="-lscalapack-openmpi -lblacsCinit-openmpi -lblacs-openmpi -llapack -lblas -lgfortran" \ -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=60 \ -D USE_GLPK:BOOL=ON \ -D GLPK_ROOT_DIR:PATH="/usr" \ -D BUILD_SHARED_LIBS:BOOL=OFF \ -D CMAKE_INSTALL_PREFIX:PATH="$HOME/gridpack" \ -D CMAKE_VERBOSE_MAKEFILE:BOOL=TRUE \ .. make
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