Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info

Liquibase Business was formerly known as Datical DB.


Table of Contents


Installation Scenarios

Where are you in your adoption of Liquibase Business? 

Evaluation: Evaluation of Liquibase Business on the way to automation

Installation for a User - install on a system (typically Windows) that an individual will use to define release pipelines and move database changes through them. Typically used in contexts where some of the following conditions are true: 

  • Smaller or less-demanding volumes of changes
  • Manual operations
  • May or may not be synchronized with application changes
  • Has access to the internet - during installation of Liquibase Business, can use an Update Site Repository

Automation System: Testing and usage of Liquibase Business in an automation environment

Installation for an Automation System - install on a system (typically Linux).  An automation system (Jenkins or other) runs scripts to perform operations.  Typically used in contexts where some of the following conditions are true: 

  • Automated or scheduled operations, although manual operations may also be available.
  • Synchronized with application changes - the automation system controls both.
  • Does not have access to the internet - during installation of Liquibase Business, must use a local resource - Requires placement of a Liquibase Business Composite Repository.

Expansion: Large-scale expansion of Liquibase Business Usage

Automated Installation of Liquibase Business - Use an automation system to install Liquibase Business on many systems (either user installations or automation installations).

Delivers Liquibase Business for either or both: 

  • Multiple individual users
  • Multiple automation systems 

What You Need from Datical Before Starting

You need to set up accounts on Datical web sites

Get access to these sites:

See Activating Your Datical Accounts

Database clients
  • Install the database client for each database type you will manage from the system where you install Liquibase Business.
  • Make sure the database client is on the PATH

See the client page for your database platform:

Installation Resources

Datical provides the following resources for installation.

All Software

The Datical Electronic Software Distribution site (software.datical.com) contains installation files and PDF documentation files for each release. 

  • Windows executable installation images (.exe)
  • Linux executable installation images (.jar)
  • Composite installation repository (all installation files in a zip file)

Repositories

Repositories are used to install or update Liquibase Business. 

  • Update Site Repository: update.datical.com - Available as a repository to be used to perform installation and updates.
    • For updates: Once Liquibase Business is set up to use it, you can use a Check for Updates feature to determine when a new version is available. 


What You Install

Liquibase Business Components
  1. Liquibase Business Clients - The Liquibase Business application contains GUI and CLI clients.
  2. Database Drivers (JDBC) - used to connect to managed databases.    
  3. SCM Plug-ins - allow you to interact with your source control management system through the Liquibase Business GUI
    • The capability is optional. You can also work with SCMs directly. 

What Directories are Created on a System

  • Installation directory
  • Project Workspace directory

Installation Directory - DaticalDB

This directory contains all executables and support files.

  • Clients (GUI and CLI)
  • JDBC Drivers for the database types you manage
  • SCM Plug-ins for the Source Control Management system you use (typically the same one used by your application development organization)
  • Eclipse infrastructure files

Location: You can choose the installation directory during installation. The default locations are the following directories:

  • Windows - C:\Users\<username>\DaticalDB
  • Linux - <home-directory>/DaticalDB

Project Workspace directory - datical

The project workspace contains files for each project you create in Liquibase Business. 

Info
titleNote

The workspace directory is not removed or changed when you upgrade or re-install Liquibase Business

When you create a project, the project definition is stored in the workspace.

As you perform operations on the project (package, forecast, deploy, rollback), files in the workspace are created, updated, moved, and removed. 

Location: This is a fixed location. 

  • Windows - C:\Users\<username>\datical
  • Linux - /<home-directory>/datical

...