Difference between revisions of "Troubleshooting of the Installation Process"

From salmon
Jump to: navigation, search
 
(14 intermediate revisions by 2 users not shown)
Line 2: Line 2:
  
 
The [https://cmake.org/|CMake CMake] is a cross-platform build tool.
 
The [https://cmake.org/|CMake CMake] is a cross-platform build tool.
In order to build the SALMON from the source code, the CMake of version 3.0.2 or later is required on your system.  
+
In order to build the SALMON from the source code, the CMake of version 3.0.2 or later is required.
 +
You may install it following one of the three instructions below.
 +
 
 +
== Installation of pre-compiled binary ==
 +
 
 +
You can get the binary distribution from the [https://cmake.org/download/  download page].
 +
First, move to the directory that you installed SALMON,
 +
<pre>
 +
cd <SALMON_INSTALLATION_DIRECTORY>
 +
</pre>
 +
and download the binary distribution ( <code>cmake-<VERSION>-<PLATFORM>.tar.gz</code>) appropriate for your platform.
 +
You can do it by copy the URL of download link from the browser, and use <code>wget</code> command:
 +
<pre>
 +
wget https://cmake.org/files/v3.8/cmake-3.8.2-Linux-x86_64.tar.gz
 +
</pre>
 +
In this document, we will use version 3.8.2 as an example. You can unpack the downloaded archive
 +
<pre>
 +
tar -zxvf cmake-3.8.2-Linux-x86_64.tar.gz
 +
</pre>
 +
and you will have the binary <code>make-3.8.2-Linux-x86_64/bin/cmake</code>. 
 +
 
 +
Next, to utilize the <code>cmake</code> command, it is required that the executable are settled inside the directory specified in your <code>$PATH</code>.
 +
If you use the bash shell, edit <code>~/.bashrc</code> and append the line:
 +
<pre>
 +
export PATH=<SALMON_INSTALLATION_DIRECTORY>/cmake-3.8.2-Linux-x86_64/bin:$PATH
 +
</pre>
 +
and reload the configuration:
 +
<pre>
 +
source ~/.bashrc
 +
</pre>
  
 
== Installation by package manager ==
 
== Installation by package manager ==
  
For several UNIX/Linux environment, your system already has the built-in package manager.
+
If your system has a built-in package manager, you may conveniently install the CMake tools as below:
and it will provide the most convenient way to install the cmake tools as below:
 
  
 
=== Debian/Ubuntu Linux ===
 
=== Debian/Ubuntu Linux ===
  
<pre>sudo apt-get install cmake</pre>
+
<pre>
 +
sudo apt-get install cmake
 +
</pre>
  
 
=== Fedora Linux/CentOS ===
 
=== Fedora Linux/CentOS ===
  
<pre>sudo yum install cmake</pre>
+
<pre>
 +
sudo yum install cmake
 +
</pre>
  
 
=== openSUSE Linux ===
 
=== openSUSE Linux ===
  
<pre>sudo zypper install cmake</pre>
+
<pre>
 +
sudo zypper install cmake
 +
</pre>
  
 +
== Installation from source code ==
  
== Installation of pre-compiled binary ==
+
You can get the source code distribution from the [https://cmake.org/download/ download page].
 +
In this time, we will use the cmake version 3.8.2 as an example.
 +
Download the archive by <code>wget</code> comamnd and unpack it as below:
 +
<pre>
 +
wget https://cmake.org/files/v3.8/cmake-3.8.2.tar.gz
 +
tar -zxvf cmake-3.8.2.tar.gz
 +
</pre>
  
Download the binary appropriate for your system from the [https://cmake.org/download/ download page]. By extracting the downloaded archive,
+
And, move to the unpacked directory and build.
 +
<pre>
 +
cd cmake-3.8.2
 +
./configure --prefix=INSTALLATION_DIRECTORY
 +
make
 +
make install
 +
</pre>
 +
(replace <code>INSTALLATION_DIRECTORY</code> to your installation directory.)
  
<pre>tar xvfz cmake-&lt;VERSION_PLATFORM&gt;.tar.gz</pre>
+
Next, to utilize the <code>cmake</code> command, it is required that the executable are settled inside the directory specified in your <code>$PATH</code>.
you will have the cmake binary inside <code>bin</code> directory. To use the <code>cmake</code> command, these executables are settled inside the directory specified in your $PATH.
+
If you use the bash shell, edit <code>~/.bashrc</code> and append the line:
 +
<pre>
 +
export PATH=INSTALLATION_DIRECTORY/bin:$PATH
 +
</pre>
 +
and reload the configuration:
 +
<pre>
 +
source ~/.bashrc
 +
</pre>
  
== Installation from source code ==
+
= Installation of BLAS/LAPACK =
 
 
Download the distribution from the [https://cmake.org/download/ download page].
 
 
 
<pre>tar xvfz cmake-&lt;VERSION&gt;.tar.gz
 
cd cmake-&lt;VERSION&gt;
 
./configure
 
make
 
make install</pre>
 

Latest revision as of 15:00, 3 February 2018

Installation of CMake

The CMake is a cross-platform build tool. In order to build the SALMON from the source code, the CMake of version 3.0.2 or later is required. You may install it following one of the three instructions below.

Installation of pre-compiled binary

You can get the binary distribution from the download page. First, move to the directory that you installed SALMON,

cd <SALMON_INSTALLATION_DIRECTORY>

and download the binary distribution ( cmake-<VERSION>-<PLATFORM>.tar.gz) appropriate for your platform. You can do it by copy the URL of download link from the browser, and use wget command:

wget https://cmake.org/files/v3.8/cmake-3.8.2-Linux-x86_64.tar.gz

In this document, we will use version 3.8.2 as an example. You can unpack the downloaded archive

tar -zxvf cmake-3.8.2-Linux-x86_64.tar.gz

and you will have the binary make-3.8.2-Linux-x86_64/bin/cmake.

Next, to utilize the cmake command, it is required that the executable are settled inside the directory specified in your $PATH. If you use the bash shell, edit ~/.bashrc and append the line:

export PATH=<SALMON_INSTALLATION_DIRECTORY>/cmake-3.8.2-Linux-x86_64/bin:$PATH

and reload the configuration:

source ~/.bashrc

Installation by package manager

If your system has a built-in package manager, you may conveniently install the CMake tools as below:

Debian/Ubuntu Linux

sudo apt-get install cmake

Fedora Linux/CentOS

sudo yum install cmake

openSUSE Linux

sudo zypper install cmake

Installation from source code

You can get the source code distribution from the download page. In this time, we will use the cmake version 3.8.2 as an example. Download the archive by wget comamnd and unpack it as below:

wget https://cmake.org/files/v3.8/cmake-3.8.2.tar.gz
tar -zxvf cmake-3.8.2.tar.gz

And, move to the unpacked directory and build.

 
cd cmake-3.8.2
./configure --prefix=INSTALLATION_DIRECTORY
make
make install

(replace INSTALLATION_DIRECTORY to your installation directory.)

Next, to utilize the cmake command, it is required that the executable are settled inside the directory specified in your $PATH. If you use the bash shell, edit ~/.bashrc and append the line:

export PATH=INSTALLATION_DIRECTORY/bin:$PATH

and reload the configuration:

source ~/.bashrc

Installation of BLAS/LAPACK