Datagard

1. Documentation
1. Advanced usage
1. Midgard 8.09

Datagard is the command-line tool for managing Midgard installations.

Basic and easiest setup can be done by just running datagard command. In both Midgard series: 1.8 and 8.09, datagard will ask you questions, and guide you step by step through setup process.

Documentation

Main datagard routines include:

• Setting Up a Midgard Database
• Creating a New Virtual Host
• Installing MidCOM with PEAR

Advanced usage

Midgard 8.09

Command line switches:

• -t type of the setup

  • quick, datagard tries to determine sensible defaults for all configurations (this is usually a good choise for upgrades as then datagard reads the settings from the configuration file)
  • wizard (the default if you don't specify type), datagard asks about every single configuration option

• -c specifies user defined configuration file name (the default is midgard if you leave out -c)

• -a action type selection. Possible actions are:

  • install (the default if you don't specify action - installs the database and the Midgard PEAR packages, and then creates a virtual host)
  • upgrade (upgrades the database and the Midgard PEAR packages)
  • vhost (creates a new virtual host - this operation requires that the database contains a style template for the vhost - style templates are imported to the db during the install action)
  • midcom3vhost (creates a new virtual host for MidCOM3 - not recommended for end users)
  • dbinstall (installs a new database and its configuration file - remember to specify the database name using the -c option if you already have a database called "midgard" - keep in mind that this action doesn't import style templates to the db like the install action does)
  • dbupdate (updates the database structure)
  • pear (installs/upgrades Midgard PEAR package(s) - needs Midgard version to be at least the same as the version of the PEAR packages, because the database structure isn't updated beforehand)
  • sitegroup (creates a new domain/sitegroup)
  • config-set (sets configuration setting value - datagard's internal action - not recommended for end users because you can edit the configuration manually which is much easier :))

• -p package (application/component) name(s) (when installing a new site with application like OpenPSA: datagard -a install -p openpsa) (when installing/updating (a) new component(s) like midcom_helper_search to an existing Midgard CMS installation: datagard -a pear -p midcom_helper_search)

• -s setting and its value for the config-set action (datagard's internal option - not recommended for end users)

• -v sets verbose level, numeric option (the default value is 0)

Tagged for Datagard

Datagard

Tagged

Datagard