Download and install solBCN

In this section you will find different ways to install and run solBCN. To do this, there are several ways to download the software:

Downloading source code from subversion

The source code of solBCN is hosted in the project's subversion repository. The latest stable release can be downloaded from the tags directory:

svn export http://floss.lsi.upc.edu/svn/soft/solBCN/tags/release-0.1/ solBCN-0.1

Alternatively, the latest development version can be downloaded from the trunk directory:

svn export http://floss.lsi.upc.edu/svn/soft/solBCN/trunk/ solBCN-unstable

The current parallel development branches can be found in the `branches` directory.

Installing release 0.1

Note: This installation does not work for the stable version, perform the steps in the Installing the latest development version section.

  1. Change to the directory where the source code has been downloaded.
    cd solBCN-0.1
    
  2. Compile. GNU Make is required.
    make jar
    
    If in execute, it returns an error likes:
    make: *** No rule to make target `/usr/share/java/jdom1.jar', needed by `compile'.  Stop.
    
    or
    
    make: *** No rule to make target `/usr/share/java/junit.jar', needed by `compile'.  Stop.
    
    or
    
    make: *** No rule to make target `/usr/share/java/commons-cli.jar', needed by `compile'.  Stop.
    
    You have a library path problem. You can solve it in the last section of this page. To see Problem Solving.
  3. Check the unit tests.
    make check
    
  4. Run run_xUI.
    ./run_xUI
    
    or
    ./run_xUI 1
    

for additional information in the user interface.

Installing the latest development version

  1. Change to the directory where the source code has been downloaded.
    cd solBCN-unstable
    
  2. Compile. GNU Make is required.
    make jar
    
    If in execute, it returns an error likes:
    make: *** No rule to make target `/usr/share/java/jdom1.jar', needed by `compile'.  Stop.
    
    or
    
    make: *** No rule to make target `/usr/share/java/junit.jar', needed by `compile'.  Stop.
    
    or
    
    make: *** No rule to make target `/usr/share/java/commons-cli.jar', needed by `compile'.  Stop.
    
    You have a library path problem. You can solve it in the last section of this page. To see Problem Solving.
  3. Check the unit tests.
    make check
    
  4. Run solBCN.
    ./run_xUI
    
    or
    ./run_xUI 1
    
    to get additional information in the user interface.

Creating Debian package and install

  1. Change to the project directory name from solBCN-unestable to solbcn-1.0
    mv solBCN-unstable solbcn-1.0
    
  1. Change to the directory where the source code has been downloaded.
    cd solbcn-1.0
    
  2. Inside the directory solbcn-1.0, create the Debian Package. This command create a package in the top directory of solbcn-1.0. See Requeriments for the creation of Debian Packages
    dpkg-buildpackage -sgpg -rfakeroot
    
    If in execute, it returns an error likes:
    make: *** No rule to make target `/usr/share/java/jdom1.jar', needed by `compile'.  Stop.
    
    or
    
    make: *** No rule to make target `/usr/share/java/junit.jar', needed by `compile'.  Stop.
    
    or
    
    make: *** No rule to make target `/usr/share/java/commons-cli.jar', needed by `compile'.  Stop.
    
    You have a library path problem. You can solve it in the last section of this page. To see Problem Solving.
  3. Installing the package.
    sudo dpkg -i solbcn_1.0_all.deb
    
  4. We can to run the program with solbcn command or click in the Applications/Graphical/solBCN from menu.

Installing Debian Package

  1. Download the Debian Package here.
  2. Intalling the package.
    sudo dpkg -i solbcn_1.0_all.deb
    
  3. Set the environment varible JDOM_LIB point to its corresponding jar file. The solbcn debian package depends on jdom so that it should be installed in its standard place. For example (assuming a bash shell),
    export JDOM_LIB=/usr/share/java/jdom1.jar
    
  4. We can to run the program with solbcn command or click in the Applications/Graphical/solBCN from menu.

Problem Solving

  1. Make error: No rule to make target `/usr/share/java/jdom1.jar`, needed by !`compile'.STOP
    SOLUTION: The Makefile doesn't find the jdom1 library in the default path. The reasons may be two:
    1. You haven't the jdom1 library installed, then:
      sudo apt-get install libjdom1-java
      
    2. You have the jdom library in other path or with other name. You must to set the following environment variable to point to their corresponding jar file stored in your system. For example (assuming a bash shell),
      export JDOM_LIB=/usr/share/java/jdom1.jar
      
  2. Make error: No rule to make target `/usr/share/java/junit.jar`, needed by !`compile'.STOP
    SOLUTION: The Makefile doesn't find the jdom1 library in the default path. The reasons may be two:
    1. You haven't the junit library installed, then:
      sudo apt-get install junit
      
    2. You have the junit library in other path or with other name. You must to set the following environment variable to point to their corresponding jar file stored in your system. For example (assuming a bash shell),
      export JUNIT_LIB=/usr/share/java/junit.jar
      
  3. Make error: No rule to make target `/usr/share/java/commons-cli.jar', needed by !`compile'.STOP
    SOLUTION: The Makefile doesn't find the jdom1 library in the default path. The reasons may be two:
    1. You haven't the jdom1 library installed, then:
      sudo apt-get install libcommons-cli-java
      
    2. You have the commons-cli.jar library in other path or with other name. You must to set the following environment variable to point to their corresponding jar file stored in your system. For example (assuming a bash shell),
      export CLI_LIB=/usr/share/java/commons-cli.jar
      

Attachments