Difference between revisions of "Troubleshooting of the Installation Process"

From salmon
Jump to: navigation, search
 
(8 intermediate revisions by the same user 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 ==
 
== Installation of pre-compiled binary ==
 
  
 
You can get the binary distribution from the [https://cmake.org/download/  download page].  
 
You can get the binary distribution from the [https://cmake.org/download/  download page].  
First, move to the installation directory of salmon,
+
First, move to the directory that you installed SALMON,
 
<pre>
 
<pre>
 
cd <SALMON_INSTALLATION_DIRECTORY>
 
cd <SALMON_INSTALLATION_DIRECTORY>
Line 18: Line 17:
 
wget https://cmake.org/files/v3.8/cmake-3.8.2-Linux-x86_64.tar.gz
 
wget https://cmake.org/files/v3.8/cmake-3.8.2-Linux-x86_64.tar.gz
 
</pre>
 
</pre>
In this document, we will use version 3.8.2 as an example. You can unpack the archive
+
In this document, we will use version 3.8.2 as an example. You can unpack the downloaded archive
 
<pre>
 
<pre>
 
tar -zxvf cmake-3.8.2-Linux-x86_64.tar.gz
 
tar -zxvf cmake-3.8.2-Linux-x86_64.tar.gz
 
</pre>
 
</pre>
 
and you will have the binary <code>make-3.8.2-Linux-x86_64/bin/cmake</code>.   
 
and you will have the binary <code>make-3.8.2-Linux-x86_64/bin/cmake</code>.   
To utilize the <code>cmake</code> command,  the executable are settled inside the directory specified in your <code>$PATH</code>.
 
  
If you use the bash shell, you edit <code>~/.bashrc</code> and append the line:
+
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>
 
<pre>
 
export PATH=<SALMON_INSTALLATION_DIRECTORY>/cmake-3.8.2-Linux-x86_64/bin:$PATH
 
export PATH=<SALMON_INSTALLATION_DIRECTORY>/cmake-3.8.2-Linux-x86_64/bin:$PATH
 
</pre>
 
</pre>
, and reload the configuration <code>source ~/.bashrc</code>.
+
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 from source code ==
Line 71: Line 74:
 
(replace <code>INSTALLATION_DIRECTORY</code> to your installation directory.)
 
(replace <code>INSTALLATION_DIRECTORY</code> to your installation directory.)
  
To utilize the <code>cmake</code> command, the executable are settled inside the directory specified in your <code>$PATH</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:
If you use the bash shell, you edit <code>~/.bashrc</code> and append the line:
 
 
<pre>
 
<pre>
 
export PATH=INSTALLATION_DIRECTORY/bin:$PATH
 
export PATH=INSTALLATION_DIRECTORY/bin:$PATH
 
</pre>
 
</pre>
, and reload the configuration <code>source ~/.bashrc</code>.
+
and reload the configuration:
 
+
<pre>
 
+
source ~/.bashrc
 +
</pre>
  
 
= Installation of BLAS/LAPACK =
 
= Installation of BLAS/LAPACK =

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