Installing the SDK for DX

November 11, 2022

1 Introduction

This document intends to help users and developers to do a first and fast install of Jahia Digital Experience Manager, mainly for a first discovery.

1.1 What's in this documentation?

This document presents the simplest installation process for Digital Experience Manager SDK.

Subscription customers using the Enterprise Distribution should refer to the Configuration and Fine Tuning Guide, available in the extranet (https://www.jahia.com/customer-extranet) to have a complete understanding of all installation options.

1.2 What this guide is not

This guide is not a complete installation guide, explaining all available options (DB, OS, Application Servers, external libs, production environments, etc.) or advanced configurations, some of which are only available to our subscription customers.

2 Community and Enterprise Distributions

2.1 Content and Main differences

The Community Distribution is the 100% free and open source distribution of Digital Experience Manager , under GPLv3 license. The Enterprise Distribution is available through a business-friendly license (JSEL) and is designed to meet the needs of the most demanding mission-critical projects.

The Enterprise Distribution differentiates from the Community Distribution by the Digital Industrialization tools it embarks:

  • The Private App Store software
  • Roles and advanced workflows
  • User directories and SSO (LDAP, AD etc.)
  • Distant publishing
  • Clustering
  • Complex environments support (WebSphere, Oracle…)
  • The possibility ton install specific packages like Portal Factory providing features like the Esigate or CMIS integration.

The Community Distribution shares the exact same code base as the Enterprise Distribution (we do not want to provide unstable versions to our community) but users of the Community Distribution cannot access monthly hotfixes and are not supported by Jahia expert from Jahia Solutions Group or any of its partners.

The Enterprise Distribution is available through annual subscriptions that encompass the additional Digital Industrialization tools, unlimited bug fixes, Online Technical Assistance and specific SLAs for both development and production environments.

Prices for subscriptions can be found on the Pricing page from the website.

3 Installing SDK

The following procedure applies to both the Community Distribution and the Enterprise Distribution of the SDK.

3.1 What is the SDK package?

The SDK package is the fastest way to discover and start coding on Digital Experience Manager for developers. The SDK contains:

  • A pre-installed Digital Experience Manager instance
  • The Digitall demo web site already deployed
  • Maven binaries
  • Pre-downloaded sources of templates and modules

3.2 The SDK archive

Download the SDK

These packages work for Windows, Linux and Mac OS X.

 Unzip the archive on your PC or Mac. On PC, please unzip it on C:/ or similar, NOT on your desktop.

3.3 Maven repository

Before building DX modules, you need to gather all the libraries dependencies needed to build a DX module.

The default configuration will create a repository folder under the directory .m2 in your home folder (HOME/.m2/repository). If you want to create a distributable repository, please edit the file settings_DX_SDK.xml to uncomment the following line:

<localRepository>${local.repo}</localRepository>

it will create a repository m2repo at the root level of the SDK. Once done, you should merge this repository with the maven repository on the targeted computer (by default HOME/.m2/repository).

From the SDK archive, execute the script ./fillRepository.sh or fillRepository.bat on Windows.

This operation can take time, depending of your bandwidth.

3.4 Procedure

  1. Launch your instance using the ./start.sh command on Mac or Linux or start.bat on Windows
  2. Open a browser, go to http://localhost:8080/, you should see our Digitall demo. Click on "Login".
  3. ROOT credentials are:
    • user: root
    • password: root
  4. Click on the root name (top - right) and switch edit mode or select the new user dashboard interface.
  5. To access the Jahia Studio, in the Edit Mode or in the new dashboard interface, click on the "Mode" dropdown menu and select "Studio"

NB: to stop you Digital Experience Manager instance, use the ./stop.sh command on Mac or Linux or stop.bat on Windows

3.5 Going further

If you're completely new with Digital Experience Manager, you should read the following documents

Discover Digital Experience Manager

Technical overview