Versions Compared

Key

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

...

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 Liquibase/Datical Before Starting

You need to set up accounts on Datical web sites

Get access to these sites:

See Activating Your Liquibase Business/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

Installation Resources

Datical provides the following resources for installation.

All Software

The Datical The Liquibase/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. of third party drivers and plugins.


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

...

  1. Download the Liquibase Business installer for Windows (.exe)
  2. Run the GUI installation to install the clients (GUI and CLI)
  3. Start the GUI.
  4. Configure the GUI to add Update Site repositoriesthird party repository
  5. Install the JDBC drivers
  6. Install the SCM plugins (optional) 

...