Difference between revisions of "Installation of PIONE"

From EosPedia
Jump to: navigation, search
(Installation with PIONE Webclient, using a installation shell)
(The problem about install)
Line 122: Line 122:
  
 
 bundle can be installed by gem.
 
 bundle can be installed by gem.
 +
 +
=== An error and how to get around ===
 +
An error message:
 +
<pre>
 +
$ bundle install --path vender/bundle
 +
 +
Could not load OpenSSL.
 +
You must recompile Ruby with OpenSSL support or change the sources in your Gemfile from 'https' to 'http'. Instructions
 +
for compiling with OpenSSL using RVM are available at http://rvm.io/packages/openssl.
 +
</pre>
 +
<br>
 +
 +
may suggest that OpenSSL is not included in [[ruby]] that you use. Use irb command as below. (if [[Ruby TIPS#irb]])is not included, you may have to recompile [[ruby]]。<br>
 +
<br>
 +
An example when not included in [[ruby]]<br>
 +
<pre>
 +
$ irb
 +
irb(main):001:0> require 'openssl'
 +
LoadError: libssl.so.0.9.8: cannot open shared object file: No such file or directory
 +
</pre>
 +
<br>
 +
 +
When included in [[ruby], you will see "true"。<br>
 +
<pre>
 +
$ irb
 +
irb(main):001:0> require 'openssl'
 +
=> true
 +
</pre>
 +
<br>
 +
 
 
 
 

Revision as of 05:54, 23 May 2017

Installation of PIONE

Introduction

 PIONE is based on ruby, gem, bundle. Check if ruby, gem, bundle have been installed。ruby should have a version number greater than or equla to 1.9.2. Versions and installed directories of ruby, gem, bundle can be checked as bellow. If Eos has been installed previously, they may be found under the Eos directory. If the directories are not the same, PIONE may have problems in installation and execution. It is recommended that they are in the same directory.

$ which ruby
/Eos/util/X86MAC64/bin/ruby
$ which gem
/Eos/util/X86MAC64/bin/gem
$ which bundle
/Eos/util/X86MAC64/bin/bundle
$ ruby -v
ruby 1.9.3p551 (2014-11-13 revision 48407) [x86_64-darwin12.5.0]
$ gem -v
1.8.23.2
$ bundle -v
Bundler version 1.7.7

If there are more than one ruby/gem, the unused versions should be deleted or renamed like gem1.9

Installation

When ruby/gem has been installed

 gem in ruby does work in the installation。Installation is done in the same directory as gem. When /usr/local or /sw/ are destinations, the administrator must do the installation.

$ gem install pione


 On update,

$ gem update pione



Installing directly from github

 Download POINE from github.

 $ git clone https://github.com/pione/pione.git


Update by bundle. 


Firstly, check if you have "bundle". If yes, you will see a line including bundle

$ which bundle
/Eos/util/X86MAC64/bin/bundle


Secondly, update bundle, if you have it. It is to be noted that the bundle install command is run in /pione, or

set its path beforehand (Gemfile, vender/bundle and files below it are necessary). 
$ cd pione
$ bundle install --path vender/bundle


Setting environment

 Run the following for defining variables of PATH and RUBYLIB.

$ cd ${PIONE_REP}
$ export PATH=$PWD/bin:$PATH
$ export RUBYLIB=$PWD/lib

 or running pione/misc/env.sh is able to set the environment.


 You may well have this setting to be performed after your shell starts, as in Setting environment of Eos.
 Those environment variables, and commands such as bundle install, are not needed on install.


Installation with PIONE Webclient, using a installation shell

The following commands can be used to start a shell for installation.

$ wget -q -O - https://raw.githubusercontent.com/pione/pione-webclient/master/install.sh | sh

If wget is not available, using curl,

$ curl https://raw.githubusercontent.com/pione/pione-webclient/master/install.sh | sh

 However, you need ruby/gem/bundler(ruby tool)for this. Install ruby/gem, if you have not. When gem has been installed, but not bundler, you can install using gem. You input the following beforehand.

$ sudo gem install bundler


Check the install

Submit the following command commands to check if the install of PIONE was OK.

$ pione -v
pione 0.5.0


To run PIONE and PIONE Webclient、refer to PIONE starting

The problem about install

 Currently, working on LINUX/OS-X is sure. But, There is problems on Windows, in relation to implementation of Ruby's Thread.

 In some environments, git/ruby/gem/bundle it may not have been installed git/ruby/gem/bundle and etc... .

 gitcan be installed in each environment (e.g. apt-get/yum). Most packages are supported.

 Currently, about the version of ruby is 1.9.2 of higher and 1.9-generations required. It is a plan that corresponds to the 2.1 in the future. If your LINUX corresponds only version 1.9 of ruby, you need to download the source code and install. Then, ZLIB/YAML is required. First install those, and next install configure/make/make of ruby.

 About gem, install it by downloading rubygems.

 bundle can be installed by gem.

An error and how to get around

An error message:

$ bundle install --path vender/bundle

Could not load OpenSSL.
You must recompile Ruby with OpenSSL support or change the sources in your Gemfile from 'https' to 'http'. Instructions
for compiling with OpenSSL using RVM are available at http://rvm.io/packages/openssl.


may suggest that OpenSSL is not included in ruby that you use. Use irb command as below. (if Ruby TIPS#irb)is not included, you may have to recompile ruby

An example when not included in ruby

$ irb
irb(main):001:0> require 'openssl'
LoadError: libssl.so.0.9.8: cannot open shared object file: No such file or directory


When included in [[ruby], you will see "true"。

$ irb
irb(main):001:0> require 'openssl'
=> true