wiki:InstallFromRPM

Version 23 (modified by bphamhuu, 4 weeks ago) (diff)

--

Important: starting from v9.2.0 we are hosting the RPM packages ourselves. The repository URL as well as the structure of the packages has changed a little bit. If you have installed the packages from the Copr repository, please first sudo service rasdaman stop && sudo yum erase rasdaman*, and then continue with installing rasdaman below. Your data and configuration will not be affected by this, and rasdaman will continue to work as before after installing the package from the new repository.

rasdaman RPM installation

This page describes installation of rasdaman RPM packages. Currently, CentOS 7 is supported.

During generation of these packages, some configuration decisions have been made (which can be chosen freely when compiling from source. Most importantly, the rasdaman engine in the RPMs does not rely on PostgreSQL, but uses embedded SQLite for managing its array metadata. (Notice, though, that the geo service component, petascope, currently still does need a PostgreSQL database; this is planned to be changed in the near future.)

Installation

  1. Add the rasdaman repository to yum. There are two types of packages:
    • stable: these are only updated on stable releases of rasdaman.
      sudo curl "http://download.rasdaman.org/packages/rpm/stable/CentOS/7/x86_64/rasdaman.repo" -o /etc/yum.repos.d/rasdaman.repo
      
    • nightly: updated nightly, so that they have the latest patches. It is not recommended to use these packages in a production installation as things could sometimes break.
      sudo curl "http://download.rasdaman.org/packages/rpm/nightly/CentOS/7/x86_64/rasdaman.repo" -o /etc/yum.repos.d/rasdaman.repo
      
  2. rasdaman packages should be available now via yum:
    yum clean all
    yum update
    yum search rasdaman
    
    Output:
    rasdaman.x86_64 : Rasdaman extends standard relational database systems with the ability to store and retrieve multi-dimensional raster data
    
  3. Add the EPEL repository to yum (official page):
    sudo yum install epel-release
    
  4. Install packages (add more packages as necessary), and turn services on:
    sudo yum install rasdaman
    source /etc/profile.d/rasdaman.sh
    

Note: if PostgreSQL has been newly installed (as opposed to having it installed before executing the commands on this page) then it is registered as a dependency of the rasdaman package.

Configuration

  1. Check that everything is fine:
    rasql -q 'select c from RAS_COLLECTIONNAMES as c' --out string
    
    Typical output:
    rasql: rasdaman query tool v1.0, rasdaman v9.0.0 -- generated on 02.07.2015 08:44:56.
    opening database RASBASE at localhost:7001...ok
    Executing retrieval query...ok
    Query result collection has 0 element(s):
    rasql done.
    
  1. Check that petascope is initialized properly, typically at this URL:
    http://localhost:8080/rasdaman/ows
    
  1. You will find the rasdaman installation under /opt/rasdaman/

Updating

The RPMs are updated whenever a new version of rasdaman is released. To download an update perform these steps:

sudo service rasdaman stop
sudo yum clean all
sudo yum update
sudo service rasdaman start
# Optional if using petascope
sudo service tomcat restart

After successfully completing the above steps, your rasdaman installation has been updated and is ready for use.

Administration

Once all above actions are copmleted, the rasdaman installation (or update) has been accomplished. This section provides additional background information for administrators.

A rasdaman service script allows to start/stop rasdaman, e.g.

service rasdaman start
service rasdaman stop
service rasdaman status

Similarly, the tomcat/tomcat6 and postgresql services can be started and stopped.

See also the dedicated wiki pages on configuration and log files, as well as the general documentation.