Combo Setup

It doesn't take long to get Deveo up and running with Combo deployment after the hardware, firewall and operating system prerequisites are met.

Login to Customer portal and download the Deveo Combo package specific to the host operating system. After uploading the package to the server, install the dependencies and the package itself:

Step 1: Installing Packages

RHEL and CentOS

yum install python-devel gettext python-docutils pam-devel cronie postfix libidn libidn-devel
rpm -ivh deveo-X.X.X-stable.el6.x86_64.rpm

Debian and Ubuntu

apt-get install python-dev python-docutils gettext sudo libpam0g-dev postfix libidn11 libidn11-dev cron
dpkg -i deveo_X.X.X_amd64.deb

Step 2: Configuring Deveo

Every installation, upgrade, or configuration change in Deveo will require the Deveo Control utility to reconfigure Deveo for changes to take effect. To enable all required services after installation, run the following command:

sudo deveo-ctl reconfigure

Step 3: Bootstrapping

At this stage Deveo is installed and running, and can be accessed using deveo as Company ID and admin as user ID and password (change them in company and user settings):

http://IP_ADDRESS_OF_YOUR_SERVER/login

Deveo Admin can be used to further configure the instance (at minimum, configuring hostname and mail settings are recommended), see Bootstrap for more information.

Enable MongoDB Authentication (Optional)

By default MongoDB listens only on localhost on Combo installations and does not use authentication. For added security, authentication can also be configured on Combo installations.

  1. Run the following command to create MongoDB admin and application users:

    sudo su - deveo
    create_mongodb_users.sh
    
  2. Update Deveo Configuration file at /var/opt/deveo/shared/deveo.json with MongoDB application user credentials by replacing values in square brackets ([]):

    "backend": {
      ...
      "db_username": "[Enter MongoDB application user configured with create_mongodb_users.sh]",
      "db_password": "[Enter MongoDB application password configured with create_mongodb_users.sh]"
      ...
    }
    ...
    "mongodb": {
      ...
      "username": "[Enter MongoDB application user configured with create_mongodb_users.sh]",
      "password": "[Enter MongoDB application password configured with create_mongodb_users.sh]"
      ...
    }
    
  3. Finally, apply the changes by reconfiguring Deveo:

    sudo deveo-ctl reconfigure
    
Updated on: 28 April 2017