Open Source Content Management System

Red Hat Enterprise Linux

  1. Supported Red Hat Enterprise Linux releases
  2. Installing Midgard with up2date
  3. Installing Midgard with yum
  4. Installing Midgard with apt
  5. Upgrading Midgard on Red Hat Enterprise Linux
    1. Installing additional Midgard applications
    2. Installing your own Midgard application
    3. Listing available packages

Our Red Hat Enterprise Linux repositories can be used with up2date, yum or apt. Choose your method below and follow the instructions.

Supported Red Hat Enterprise Linux releases

Actively maintained (supported) Red Hat Enterprise Linux releases:

  • Red Hat Enterprise Linux 4

    • Newest stable Midgard version: 1.7.6
    • Newest testing Midgard version: NA
    • Newest unstable Midgard version: NA

Midgard is not working on Red Hat Enterprise Linux when it has selinux enabled (default in RHEL4)! This is due to Apache HTTP Server selinux policy which doesn't allow httpd to write under the /var directory. In the mean time: If you have selinux disabled, Midgard works as usual. If you know how to fix this issue, please inform the Midgard developers on the Midgard IRC channel or send mail to the Midgard dev mailing list.

Installing Midgard with up2date

Import the GPG key.

  • For Red Hat Enterprise Linux 4:

    rpm --import http://www.puv.fi/download/midgard/rhel/4/i386/RPM-GPG-KEY
    

If you don't have Java RPM packages installed (MidCOM's default indexer backend requires Java), add this entry to the configuration file /etc/sysconfig/rhn/sources:

  • For Red Hat Enterprise Linux 4:

    yum sun-stable-rhel4 http://www.puv.fi/download/sun/rhel/4/i386/RPMS.stable
    

Add this entry to the configuration file /etc/sysconfig/rhn/sources:

  • For Red Hat Enterprise Linux 4:

    yum midgard-stable-rhel4 http://www.puv.fi/download/midgard/rhel/4/i386/RPMS.stable
    

If you're going to install midcom-indexer-lucene (this package requires lucene from the jpackage-generic repository), set up up2date to use the generic free repository. Instructions: http://www.jpackage.org/repos.php

If you don't have MySQL server running at local or remote host, install and start it: up2date mysql-server && service mysqld start

Install Midgard 1.7.x with the command up2date midgard-cms *. (You can update Midgard 1.7.x with the command up2date midgard-cms.)

Run datagard for setting up a new Midgard database and virtual host.

up2date is a great tool for automatic package updates, but it seems to work poorly when installing new packages. It may end up doing "Testing package set / solving RPM inter-dependencies..." for ages. Sometimes it works like a charm, but if you get this problem, install midgard with yum (follow the instructions) or download the RPMS and install them by hand running the command rpm -ivh _filename_ (filename can be an URL too) for each package (if you do this, please set the repository in your up2date sources anyway for getting updates in the future)

Installing Midgard with yum

Import the GPG key.

  • For Red Hat Enterprise Linux 4:

    rpm --import http://www.puv.fi/download/midgard/rhel/4/i386/RPM-GPG-KEY
    

Configure yum repository sources.

  • For Red Hat Enterprise Linux 4:

    cd /etc/yum.repos.d  
    wget http://www.puv.fi/download/midgard/rhel/4/i386/midgard-stable.repo  
    # If you don't have Java RPM packages installed (MidCOM's default indexer backend requires Java):  
    wget    http://www.puv.fi/download/sun/rhel/4/i386/sun-stable.repo
    

If you're going to install midcom-indexer-lucene (this package requires lucene from the jpackage-generic repository):

    cd /etc/yum.repos.d/ && wget http://www.jpackage.org/jpackage.repo

If you don't have MySQL server running at local or remote host, install and start it: up2date mysql-server && service mysqld start

Install Midgard 1.7.x with the command yum install midgard-cms. (You can update Midgard 1.7.x with the command yum upgrade midgard-cms.)

Run datagard for setting up a new Midgard database and virtual host.

Installing Midgard with apt

Import the GPG key.

  • For Red Hat Enterprise Linux 4:

    cd /etc/apt/gpg  
    wget -O MIDGARD-RPM-GPG-KEY http://www.puv.fi/download/midgard/rhel/4/i386/RPM-GPG-KEY  
    rpm --import MIDGARD-RPM-GPG-KEY
    

Configure apt repository sources.

  • For Red Hat Enterprise Linux 4:

    cd /etc/apt/sources.list.d  
    wget http://www.puv.fi/download/midgard/rhel/4/i386/midgard.list  
    # If you don't have Java RPM packages installed (MidCOM's     default indexer backend requires Java):  
    wget http://www.puv.fi/download/sun/rhel/4/i386/sun.list
    

Run apt-get update midgard for updating the apt database (this adds our repository into your apt).

If you're going to install midcom-indexer-lucene (this package requires lucene from the jpackage-generic repository), set up apt to use the generic free repository. Instructions: http://www.jpackage.org/repos.php

If you don't have MySQL server running at local or remote host, install and start it: up2date mysql-server && service mysqld start

Install Midgard 1.7.x with the command apt-get install midgard-cms. (You can update Midgard 1.7.x with the command apt-get update midgard && apt-get dist-upgrade midgard-cms.)

Run datagard for setting up a new Midgard database and virtual host.

Upgrading Midgard on Red Hat Enterprise Linux

The Midgard CMS package is now named as midgard-cms. You have now all the control you need. Every Midgard application is now packaged as RPM and installed by RPM (no need to run Datagard for importing the package - RPM does this for you).

Installing additional Midgard applications

If you just want to use SpiderAdmin and nothing else, install the spider package (up2date spider, yum install spider or apt-get install spider).

Installing your own Midgard application

If you are a developer and want to test the development versions of the appications, install only the Midgard Framework package (called midgard-framework) and run the Datagard DB installation.

Then place your application (.tar* or .xml*) under /usr/share/midgard/pkgs/ and run datagard's import to install your own package.

Listing available packages

To see which packages are available, use the search functions available in the install tools (up2date --show-available | grep <pkgname>, yum search <pkgname> or apt-cache search <pkgname>) or browse the PUV RHEL4 repository:

If you are using other repository than stable, please note that you must enable also the stable repository (and testing if you are using unstable) to be able to have access to all available packages. The packages walk through the repository by entering unstable and exiting stable (older packages for the same major Midgard version are usually removed when a new bugfix release is published).

Do not use the unstable repository in production systems as it contains usually CVS snapshots or packages that were "just built". The testing repository is often a good choise as this enables newer versions like beta releases. But for serious production, please use the stable repository which contains the official stable Midgard release versions of the packages.

Designed by Nemein, hosted by Anykey