Installing MidCOM with PEAR

Midgard 8.09 "Ragnaroek"
Midgard 1.8

MidCOM installation

Layout template installation
Installing additional components

MidCOM releases are shipped as PEAR packages for better version management and control. The packages utilize a MidCOM-specific channel in ragnaroek.pear.midgard-project.org.

Midgard 8.09 "Ragnaroek"

Datagard in Midgard 8.09 performs all required steps to initialize all channels (Ragnaroek, Pearified, etc) and install all initial base packages. If you are only interested in installing PEAR packages, run datagard with desired action type:

datagard -a pear

Keep in mind, that pear action removes old midcom if found, and install new packages from new channel.

Useful informations:

Ragnaroek channel url: ragnaroek.pear.midgard-project.org
Ragnaroek channel alias: ragnaroek

If, for some reason, some package is not installed or it's not included in base packages, install it manually:

For Midgard >= 8.09.6:

datagard -a pear -p package_name

For Midgard < 8.09.6:

pear install ragnaroek/package_name
datagard -a dbupdate

Midgard 1.8

MidCOM installation

Upgrade your PEAR installation. MidCOM installation requires PEAR 1.4 or newer.
```
# pear upgrade PEAR
```

If it complains that you at least some version of PEAR to upgrade to the latest version install the requested version first with pear upgrade PEAR-<version>

Add the needed channels for package installation

# pear channel-discover pearified.com
# pear channel-discover pear.midcom-project.org

Install and configure the needed PEAR role files

# pear install pearified/Role_Web
# pear config-set web_dir /usr/share/midgard/midcom/static


# pear install midcom/Role_Mgdschema
# pear install midcom/Role_Midgardelement
# pear install midcom/Role_Midgardsql

Install MidCOM and some required packages
```
# pear install -f midcom/midcom
```

If you get a Fatal error: Allowed memory size exceeded error with any of the packages you have to increase PHP's memory limit. The file to edit is either /etc/php/php.ini or /etc/php/cli/php.ini. Memory limit is also settable with -d argument for php command ( php -d memory_limit=40M ).

Once you have installed new packages you need to stop and start Apache to get the MgdSchema files supplied with them loaded.

Layout template installation

Packaged layout templates utilize the Role_Midgardelement package for installation. To make installation work, you have to:

Create an unified Midgard configuration file to /etc/midgard/conf.d/midgard
Point the Midgardelement role to the configuration file
```
# pear config-set midgard_config_file midgard
```
Install the style template you want, for example
```
# pear install ragnaroek/template_Kubrick
```

After these steps you should have a fully functional MidCOM installation in the PEAR path.

Installing additional components

Other component packages can be installed using the PEAR command, for example:

# pear install ragnaroek/net_nehmer_blog

The list of available components can be found on the PEAR channel website

Tagged: ragnaroek; thor