Quick Start Guide

There are different ways to get started with EJBCA:

Quick Setup Script

To install EJBCA using the quick setup script located in bin/extra/ejbca-setup on a Linux machine (Ubuntu or RedHat is recommended), do the following:

  1. Download and unpack the EJBCA distribution.

  2. Install dependencies:
    Ubuntu:

    sudo apt-get update
    sudo apt-get install unzip openjdk-8-jdk-headless ant ant-optional psmisc mariadb-client bc patch curl

    RedHat:

    sudo yum install tar unzip java-1.8.0-openjdk-devel ant psmisc mariadb bc patch
  3. Install a MariaDB database and create a database for EJBCA:

    $ sudo mysql -u root -p
    mysql> CREATE DATABASE ejbcatest CHARACTER SET utf8 COLLATE utf8_general_ci;
    mysql> GRANT ALL PRIVILEGES ON ejbcatest.* TO 'ejbca'@'localhost' IDENTIFIED BY 'ejbca';
  4. Get the latest ejbca enterprise edition (example: ejbca_ee_6_12_0_1.zip) from file server, unzip it in ejbca folder.

  5. Configure the script in ejbca/bin/extra/ejbca-setup with your database user and password.

  6. Run the script with ./<ejbca-install-directory>/bin/extra/ejbca-setup.
    For example:

    ./ejbca_ce_6_10_1_2/bin/extra/ejbca-setup.sh

    Do not run the ejbca-setup script from inside the EJBCA directory. The script creates new directories and links and is thus dependent on being run from just outside the EJBCA directory itself.

    The script will download WildFly 10 and the MariaDB database connector and install everything, resulting in a usable EJBCA installation.

  7. Import superadmin.p12 in your web browser and open the EJBCA Administration pages at https://localhost:8443/ejbca/adminweb/. The password for importing superadmin.p12 was printed on the last line after running the script.

Feedback and improvements to the ejbca-setup script are appreciated.