Linux Instructions
(Created page with "KRC Build Instructions for Linux (and Mac) System Last updated: 31 July 2018; KRC version 3.5.6 Notes: These build instructions are the steps that Robin Fergason, Sylvain P...") |
|||
| Line 5: | Line 5: | ||
Notes: These build instructions are the steps that Robin Fergason, Sylvain Piqueux, and Christopher Edwards perform to compile new versions of KRC. Robin works in a Bash environment, and has no issues with the below instructions. | Notes: These build instructions are the steps that Robin Fergason, Sylvain Piqueux, and Christopher Edwards perform to compile new versions of KRC. Robin works in a Bash environment, and has no issues with the below instructions. | ||
| − | There are more detailed build instructions included in the KRC distribution in aaa/AAinstall. The below instructions do not build the IDL scripts. | + | There are more detailed build instructions included in the KRC distribution in aaa/AAinstall. |
| + | The below instructions do not build the IDL scripts. | ||
| + | If you are interested in access the IDL scripts that accompany KRC, then please see the build instructions provided in the KRC distribution. | ||
| − | Step 1: Create a build directory and untar the KRC distribution | + | '''Step 1: Create a build directory and untar the KRC distribution''' |
• Create a clean (new) directory (e.g. “mkdir KRC_356” for KRC Version 3.5.6) | • Create a clean (new) directory (e.g. “mkdir KRC_356” for KRC Version 3.5.6) | ||
| + | |||
• Copy or move the KRC distribution file into the new directory | • Copy or move the KRC distribution file into the new directory | ||
| + | |||
• Untar the distribution file (tar –xvf or tar –xzf). This action should create five sub-directories: aaa, doc, idl, run and src | • Untar the distribution file (tar –xvf or tar –xzf). This action should create five sub-directories: aaa, doc, idl, run and src | ||
| − | |||
| + | • Older distribution files might have two tar files, one of which will contain the "big" directory. In this case, untarring the distribution will create six directories. 3.2.1 onward the distribution hasn’t had the "big" directory) | ||
| + | |||
| + | |||
| + | |||
| + | '''Step 2: Compile all programs associated with the KRC build''' | ||
| − | |||
• Cd into the src/cfiles directory to make it the current working directory (cd src/cfiles/). Type the following command to compile the C programs in that directory. | • Cd into the src/cfiles directory to make it the current working directory (cd src/cfiles/). Type the following command to compile the C programs in that directory. | ||
| − | make all | + | make all |
| + | |||
• Cd back into src to make it the current working directory (cd ../src). Type the following commands to build krc and porbmn, which use the specifications in the Makefile located in that same directory. | • Cd back into src to make it the current working directory (cd ../src). Type the following commands to build krc and porbmn, which use the specifications in the Makefile located in that same directory. | ||
| − | make krc | + | make krc |
| − | make porbmn | + | make porbmn |
| − | • If desired, cd into run to make it the current working directory (cd ../../run) and create a couple of soft links for the KRC executable. Alternatively, you can simply copy the KRC executable that you created in the src directory to where every you will be working. | + | |
| − | ln –s ../src/krc | + | • If desired, cd into run to make it the current working directory (cd ../../run) and create a couple of soft links for the KRC executable. |
| − | ln –s ../src/porbmn | + | Alternatively, you can simply copy the KRC executable that you created in the src directory to where every you will be working. |
| + | ln –s ../src/krc | ||
| + | ln –s ../src/porbmn | ||
Caution: Sometimes krc will have a slightly different name. If errors result, look in the Makefile in the src directory to check the appropriate name. | Caution: Sometimes krc will have a slightly different name. If errors result, look in the Makefile in the src directory to check the appropriate name. | ||
| − | Step 3: Test the newly built KRC | + | '''Step 3: Test the newly built KRC''' |
• Execute krc (./krc) and test that the compiled version of KRC works on your system | • Execute krc (./krc) and test that the compiled version of KRC works on your system | ||
| + | |||
• The run directory has example input files which will help verify that krc has been installed correctly. Type in an appropriate name for the output file. This output file will be created in the “run” directory with ‘.prt’ extension | • The run directory has example input files which will help verify that krc has been installed correctly. Type in an appropriate name for the output file. This output file will be created in the “run” directory with ‘.prt’ extension | ||
Latest revision as of 21:21, 8 January 2019
KRC Build Instructions for Linux (and Mac) System Last updated: 31 July 2018; KRC version 3.5.6
Notes: These build instructions are the steps that Robin Fergason, Sylvain Piqueux, and Christopher Edwards perform to compile new versions of KRC. Robin works in a Bash environment, and has no issues with the below instructions.
There are more detailed build instructions included in the KRC distribution in aaa/AAinstall. The below instructions do not build the IDL scripts. If you are interested in access the IDL scripts that accompany KRC, then please see the build instructions provided in the KRC distribution.
Step 1: Create a build directory and untar the KRC distribution
• Create a clean (new) directory (e.g. “mkdir KRC_356” for KRC Version 3.5.6)
• Copy or move the KRC distribution file into the new directory
• Untar the distribution file (tar –xvf or tar –xzf). This action should create five sub-directories: aaa, doc, idl, run and src
• Older distribution files might have two tar files, one of which will contain the "big" directory. In this case, untarring the distribution will create six directories. 3.2.1 onward the distribution hasn’t had the "big" directory)
Step 2: Compile all programs associated with the KRC build
• Cd into the src/cfiles directory to make it the current working directory (cd src/cfiles/). Type the following command to compile the C programs in that directory.
make all
• Cd back into src to make it the current working directory (cd ../src). Type the following commands to build krc and porbmn, which use the specifications in the Makefile located in that same directory.
make krc make porbmn
• If desired, cd into run to make it the current working directory (cd ../../run) and create a couple of soft links for the KRC executable. Alternatively, you can simply copy the KRC executable that you created in the src directory to where every you will be working.
ln –s ../src/krc ln –s ../src/porbmn
Caution: Sometimes krc will have a slightly different name. If errors result, look in the Makefile in the src directory to check the appropriate name.
Step 3: Test the newly built KRC
• Execute krc (./krc) and test that the compiled version of KRC works on your system
• The run directory has example input files which will help verify that krc has been installed correctly. Type in an appropriate name for the output file. This output file will be created in the “run” directory with ‘.prt’ extension
