Page tree
Skip to end of metadata
Go to start of metadata

Datameer Installation Guide

To install Datameer you need to do the following:

  1. Specify an installation folder and unzip the files.
  2. Download and install the database drivers. (Not required for evaluation purposes.)
  3. Configure Datameer required and optional settings and initialize the database.
  4. Install the license.
  5. Run the application.
  6. Login and change the default admin password following the instructions in: Managing User Accounts

Note: The default username and password are admin and admin.

Each of these steps is documented in the sections that follow. If you are upgrading from a previous version, see the Upgrade Instructions.

Downloading and unzipping the software

  • Specify a location to install software to such as: /usr/local/das-<version>

  • Expand the archive to that location.

  • Change the working directory to the newly created directory.

After unzipping, create a new group datameer and user datameer. Go back and change the folder permissions from user root to the newly created user datameer.

  • Add new group
  • Add new user
  • Change owner and group of folder as well as all child folders


As of Datameer v4.4 this will be completed automatically when installing from a distribution package (RPM/Debian).


Configuring Datameer

  • Configure Datameer by editing etc/ The configuration file is well documented.

  • Depending on what value is used in the etc/ for "DAS_DEPLOY_MODE", you will need to edit the corresponding properties file to update the IP/host. I.e., If using "export DAS_DEPLOY_MODE=live", update the <DAS HOME>/conf/ Change the key "" to reflect the IP/host & port of the server Datameer is installed on.

  • Workgroup and Enterprise edition users may want to consider allocating additional memory in etc/ Datameer recommends updating from 1GB to 2GB ( Xmx1024m ----> -Xmx2048m). This is especially needed for the 64 bit environment.

    # Adjust max available memory (-Xmx) according to your needs
    # WARNING: Path variables that may contain blanks should be added to start_das() method (see DAP-6342)
    export JAVA_OPTIONS="-Xmx1024m -XX:MaxPermSize=384m -Xms256m -XX:MaxNewSize=448m -XX:SurvivorRatio=6 -XX:+UseConcMarkSweepGC -XX:CMSInitiatingOccupancyFraction=80 -XX:+HeapDumpOnOutOfMemoryError -XX:+CMSClassUnloadingEnabled -XX:+CMSPermGenSweepingEnabled"
    export JAVA_OPTIONS="$JAVA_OPTIONS -Dfile.encoding=utf-8"


When configuring etc/, the DAS_DEPLOY_MODE is defaulted to "trial".  If you are using MySQL please change "trial" to "live".

Change your stored data directory

It is recommended to use a path that is not depending on a Datameer installation directory. Since the 'das-data' folder is stored inside of your installation directory by default, you'll have to make a backup of your stored data, every time you create a new distribution or upgrade.


Setting up a MySQL database (optional)

If you are evaluating Datameer

You can use an HSQL database on your local filesystem and there is no need to set up an external database. If you are setting up Datameer for production use, we recommend using MySQL.

Migrating from HSQL to MySQL

Datameer provides a tool to migrate data from an HSQL file database to a MySQL database:

  1. Configure Datameer for MySQL (see below)
  2. Migrate HSQL database to MySQL:

    The default path to the hsql database is <Datameer user path>/Datameer/<version>/das-data/database/...

    * If your hsql database has been moved from the default location, the path will need to be specified.

    bin/ hsql-file:<file path of hsql database> mysql

    * Ensure this script is being run from root Datameer installation folder.

Configuring Datameer for MySQL
  • By default, the application runs with the HSQL file database that is created on the local filesystem (under das-data/database/hsql-db). If you want to run the application in MySQL mode, change the DAS_DEPLOY_MODE property in the as follows:

  • To specify different database credentials make the following two changes:
    • Change the MySQL database credentials in the create database script:

    • Change the MySQL database credentials in the file. Update the properties for,,, and

    • Change the following properties:

      Default credentials for MySQL are user: dap, password: dap.

  • Initialize the database with the following commands:

    You will be prompted to enter the password to access the database.

  • Downgrading Datameer versions

Installing the MySQL JDBC database drivers

Installing the license

If you have already received a license from Datameer, copy the license file to: $INSTALL_LOCATION/das-<version>/etc/license

If you do not have a license, email

Note: The file must be named license.lic or it will not work.

If you attempt to launch the application without a license you will receive an error message asking you to contact Datameer for a license file. Please include the MAC address listed in this error message when contacting Datameer for a license. License information and usage can be viewed at any time by clicking the Administration tab and clicking Licenses.

See License Information for information on how to update the license and for details about volume-based licensing.

Running the application

You can start, stop, and restart the application by going to the /bin folder and entering commands.

Note: The log file is written to logs/conductor.log using log4j.

To change log behavior, edit conf/ or write your own log property file. (Tip: When you define settings in conf/ use customized as the log4jConf start parameter).

Starting the application

(Recommended as the new user datameer previously created rather than as user root)

  • To start the application, enter the following command :

  • Optionally, to start the application using example data and workbooks, enter the following command. You need to edit the injected SCP connection "example_scp_connection" and enter the SSH credentials of the application.

Stopping the application
  • To stop the application, enter the following command:

Restarting the application
  • To restart the application, enter the following command:

Installing Custom Database Drivers
  • Optional: You can install custom database drivers to connect to other types of databases. This step allows you to import your existing data into Datameer and Hadoop. 
    For a listing of supported databases and other details, see How to Install Database Drivers.

Special settings

The following settings should only be used in exceptional cases.





export DAS_DB_MODE=mysql|hsql-file

Choose the db type that should be used. Default is hsql-file.


Specific distribution instillation instructions


MySQL Installation Guide

MySQL is used for the Datameer metastore--where Datameer stores its metadata.

Installing MySQL on Fedora

  • To install the MySQL server, enter the following command.

    yum install mysql-server
  • To start MySQL, enter the following command.

    /etc/init.d/mysqld start

Installing MySQL on Debian

  • To install MySQL server, enter the following command.

    apt-get install mysql-server

Installing MySQL on Solaris and OpenSolaris

  • To install MySQL server in Solaris use solaris PKG
  • To install MySQL server in OpenSolaris use IPS 

Installing MySQL on CentOS

  • To install the MySQL server, enter the following command.

    yum install mysql-server
  • To start MySQL, enter the following command.

    service mysql start

Where to go from here

If you are a Datameer system administrator, see the Administrator's Guide.