en‎ > ‎home‎ > ‎

Installation

NYSOL package supports the following operating system. 

  • Mac OS X 10.9.2 (Marvericks) or later

  • Ubuntu Linux 12.04 (32bit, 64bit)

  • SUSE Linux12.3 (64bit)

Installation packages are available for Mac OS X and Linux operating systems listed above, and users would be able to install MCMD on systems with slight variation of the OS versions listed above. In addition, for installation in other OS, the software can be compiled and installed from the source code.

Installation instructions for corresponding OS are as follows: 

  1. Mac OS X
  2. Ubuntu Linux
  3. Suse Linux
  4. Install from source code
  5. Virtual Box
  6. Cygwin

1) Mac OS X

Download the latest dmg package from the top page of http://www.nysol.jp/. The file name follows the format "nysol-1.0.dmg" ("1.0" could be replaced with the latest release version). Double click on the dmg file downloaded, nysol-1.0.pkg will be shown in Finder.  Double-click on the package and follow the instructions for installation. The commands contained in the package are installed in /usr/local/bin, and the libraries are installed in /usr/local/lib. The libraries and commands written in Ruby will be installed at the location specified by the gem command. This package works with Ruby version  2.0.0p247. However, note that rvm is incompatible with NYSOL package, thus RUBY   cannot be installed through rvm. Therefore, it must be installed from the source when using the rvm environment. It is easy to verify the installation of the package, start the terminal and type the command as follows, if the package is installed successfully, the command help information will be displayed. 

$ mcut --help
mcut select column 
==================

Extract the specified column(s). 
The specified column is removed with -r option.

Format
------
mcut f= [-r] [i=] [o=] [-nfn] [-nfno] [-x] [--help] [--version]  
               :
$ mitemset.rb --help
----------------------------
mitemset.rb version 1.1
----------------------------
Overview ) Enumerate frequent itemsets by LCM 
Features) 1) Handling of classification hierarchy 
      2) Enumerate 3 distinct patterns: Frequent pattern, closed frequent pattern, maximal frequent pattern 
      3) When class is specified, emerging patterns based on the above 3 patterns is enumerated 
Format) mitemset.rb i= [x=] [c=] [O=] [tid=] [item=] [taxo=] [class=] [type=] [s=] [S=] [l=] [u=] [top=] [-replaceTaxo] [T=] [--help]

Example) mitemset.rb i=basket.csv tid=traID item=product
               :
 


2) Ubuntu Linux

Download the latest deb package from the top page of http://www.nysol.jp/. The file name follow the format ("1.0-0" could be replaced with the latest release version).  

  • 32 bit environment: nysol_1.0-0_i386.deb

  • 64 bit environment: nysol_1.0-0_amd64.deb

Install the downloaded file following the steps below. The system requirements is the same as 1) Mac OSX.  

$ sudo dpkg -i nysol_1.1-0_i386.deb

Preparing to replace nysol 1.0-0 (using nysol_1.0-0_amd64.deb) ...

Unpacking replacement nysol ...

Setting up nysol (1.0-0) ...

Successfully installed nysol-1.3-x86_64-linux

          :


3) SUSE Linux

Download the latest rpm package from the top page of http://www.nysol.jp/. The file name follow the format ("1.0-0" could be replaced with the latest release version)。

  • 32 bit environment: nysol_1.0-0.i386.rpm

  • 64 bit environment: nysol_1.0-0.x86_64.rpm

Install the downloaded file following the steps below. The system requirements is the same as 1) Mac OSX.  

$ sudo rpm -i nysol_1.1-0_i386.rpm

          :


4) Install from source code

Follow the steps below to compile and install the program from source code.

4-1) Development environment
In Mac environment, development tools such as g++ and automake are not installed with the system, therefore, Xcode is required prior to the installation of nysol. 
Download and install xcode from the following URL. 

After installing xcode, install the Command Line Tools from xcode. Latest version of Xcode can also be installed through App Store. Please refer to Apple's latest documentation. 

To confirm the installation of command line tools, type "gcc" at the command prompt. 

In Linux environment, ensure g++、autotools、libtool are installed in the system. 
Please refer to the references related to corresponding OS for the installation of the required tools. 

4-2) Install C++ boost library 

Download and install C++ boost library version 1.52 (later version is not supported) from the website (http://www.boost.org/)1. For Mac and Linux 32 bit OS environment, follow the installation steps below. It takes about 30 minutes to install the boost library. 

$ wget http://sourceforge.net/projects/boost/files/boost/1.52.0/boost_1_52_0.tar.gz/download

$ tar zxvf boost_1_52_0.tar.gz

$ cd boost_1_52_0

$ ./bootstrap.sh

$ ./bjam

$ sudo ./bjam install


For Linux 64 bit OS environment, follow the steps below. 

$ wget http://sourceforge.net/projects/boost/files/boost/1.52.0/boost_1_52_0.tar.gz/download

$ tar zxvf boost_1_52_0.tar.gz

$ cd boost_1_52_0

$ ./bootstrap.sh

$ ./bjam cflags=-fPIC

$ sudo ./bjam install cflags=-fPIC


4-3) Install libxml2 and libxslt (only for users upgrading from 10.8 or earlier versions to 10.9 or later)

Since Mac Mavericks and Yosemite OS contains libxml2 and libxslt libraries installed in the stock Mac machine, this installation procedure can be omitted. 

However, if your system is upgraded to Mavericks version 10.9 or Yosemite version 10.10 from version 10.8 or earlier OS X, the following installation is required. Check if libxml2.dylib and libxslt.dylib exists in /usr/lib folder, if not, it is necessary to install the libraries. 

libxml2 and libxslt source packages can be downloaded from the xmlsoft website. 
 http://xmlsoft.org/

Install libxml2:

$ tar zxvf libxml2-2.9.2.tar.gz

$ cd libxml2-2.9.2

$ ./configure

$ make

$ sudo make install


# if libxml2 is installed in /usr/local/include directory, link the directory to /usr/include as follows:

$ sudo ln -s /usr/local/include/libxml2 /usr/include/libxml2


Install libxslt:

$ tar zxvf libxslt-1.1.28.tar.gz

$ cd libxslt-1.1.28

$ ./configure

$ make

$ sudo make install


# if libxslt cannot be found, add the library path to the last line of .bash_profile as follows:

export PATH=$PATH:/usr/lib


4-4) Compile and install nysol

After all required software have been installed, extract nysol package into a desired directory, and follow the steps below to compile and install nysol. The makefile describes the compilation and installation of all nysol ruby libraries and commands contained with the nysol package. 

$ aclocal ; autoreconf -i ; automake --add-missing
$ ./configure
$ make
$ sudo make install



5) Install from VirtualBox Image (for Windows environment)

 Run NYSOL in Linux virtual environment on Windows. 

  • First, install VirtualBox, a cross-platform virtualization application, on your computer.  Download the executable (exe) file from VirtualBox's site Download, and click on the platform package for windows. The installation method is shown below. 

Install VirtualBox by executing the exe file downloaded. 

  • Next, go to the NYSOL Download site, and select VirutalBox, within the folder, CentOS7_Nysol2.1_3.ova and Ubuntu14.04_Nysol2.1_3.ova images are available for download. 
  • The ova image file allows import of virtual environment in VirtualBox. Select File ? Import appliance from the manager window in VirtualBox. The import process takes about 10 minutes depending on users' environment. 

The construction of virtual environment is completed. 

  • After installation, start VirtualBox OS to test run NYSOL command. 

  • Select nysol as user account, input password as Mining2015. 
  • After you have logged in, change the system language to your desired language. Go to System menu, select Administration, and then click Language Support. Then click Install / Remove Languages to add the desired language. Move it to first priority and click on apply changes.  
  • Now, start the terminal application. At the command prompt, type "mcut -help" to check if NYSOL environment is running. 


6) Install from Cygwin (for Windows environment)

 Run NYSOL from Cygwin on Windows environment. 
 NYSOL can be operated on Windows through Cygwin. The installation instructions are as follows. 

  • From the Cygwin website, select Cygwin install, select either 32-bit or 64 bit versions of Windows for download. 

  • To install Cygwin, double click on the downloaded exe setup file. Next, select install from Internet, and choose a download site closest to your location from one of the Download Sites. For example, ftp://ftp.jaist.ac.jp is selected as it is closest to Japan. 
  • Next, setup will display a list of packages at the next screen. Please select install all packages which is required for NYSOL to run. The download takes approximately 24 hours depending on the network connection. Click next to begin the download process. If the selected ftp site does not connect, proceed by selecting another ftp site. 
  • Download nysol-2.1.tar.gz from the NYSOL Download site. 
  • Double click on the Cygwin icon to start Cygwin. Unzip the nysol-2.1.tar.gz archive file by using the command tar zxvf nysol-2.1.tar.gz. 
  • Afterwards, to install nysol package, follow the instructions from 4-4) Install from Source Code .
Comments