Installing Midgard 1.4.1 CVS on Debian GNU/Linux

Note: this document is now outdated, and is here for reference only,
since there are Debian packages for Midgard nowadays. Use them for a
much more convenient install.

1.1. Concepts

Throughout this document, you will see either hash symbols (#) or dollar signs
($) in front of the commands. These indicate whether the command should be run
as a regular user or with superuser privileges (ie. root). Do not include these
in the commands! And by the way, copy-pasting commands is not such a great
idea.

For brevity’s sake, I will use “e.g.” as a shorthand for “for instance”, and
“i.e.” as a shorthand for “that is” or “in other words” throughout the this
how-to.

1.2. Revision history

1.3. Copyright

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled “GNU
Free Documentation License”.

1.4. Disclaimer

Use the information in this document at your own risk. I disavow any potential
liability for the contents of this document. Use of the concepts, examples,
and/or other content of this document is entirely at your own risk.

All copyrights are owned by their owners, unless specifically noted otherwise.
Use of a term in this document should not be regarded as affecting the
validity of any trademark or service mark.

Naming of particular products or brands should not be seen as endorsements.

You are strongly recommended to make a backup of your system before major
installation and should make backups at regular intervals.

2. Download software

Midgard CVS from http://nightlybuilds.midgard-project.org/
Nadmin from http://www.hklc.com/
MySQL from http://www.mysql.com/
Apache from http://httpd.apache.org/
Mod_SSL from http://www.modssl.org/
OpenSSL from http://www.openssl.org/
PHP4 from http://www.php.net/
Berkeley-DB from http://www.sleepycat.com/
Expat from http://sourceforge.net/projects/expat/
Glib from http://www.gtk.org/

I downloaded the sources to a directory called /home/user/Midgard and extracted
them there (except for Nadmin, which will be used when the Midgard install is
completed).

Next, I downloaded and installed Curses/termcap compat libs needed by MySQL,
Zlib and some compiling tools needed later on and, of course, Perl.

# apt-get update

# apt-get install ncurses3.0 ncurses3.0-altdev termcap-compat ncurses3.4 \
libncurses4-dev zlib-bin zlib1 zlib1-altdev zlib1g zlib1g-dev autoconf \
automake libtool flex perl

3. MySQL database installation

# groupadd mysql
# useradd -g mysql mysql
$ tar xfvz mysql-3.23.45.tar.gz
$ cd ~/mysql-3.23.45
$ ./configure –prefix=/usr/local/mysql –with-mysqld-user=mysql

$ make
# make install
# ./scripts/mysql_install_db
# chown -R mysql.mysql /usr/local/mysql
# /usr/local/mysql/bin/safe_mysqld –user=mysql &
# /usr/local/mysql/bin/mysqladmin -u root password myMySQLpassWord

# /usr/local/mysql/bin/mysqladmin -u root -h debian password myMySQLpassWord

I added /usr/local/mysql/lib/mysql to my /etc/ld.so.conf and ran ldconfig as
root.

4. Glib, Expat-lib and Berkeley-DB installation

$ cd /home/user/Midgard/glib-1.2.9

$ ./configure
$ make
# make install

$ cd /home/user/Midgard/expat-1.95.2
$ ./configure
$ make

# make install

$ cd /home/user/Midgard/db-3.3.11/build_unix
$ ../dist/configure –prefix=/usr
$ make
# make install

I also added /usr/local/lib to my /etc/ld.so.conf and ran ldconfig as root.

5. OpenSSL and mod_ssl installation

$ cd /home/user/Midgard/openssl-0.9.6b
$ ./config –prefix=/usr/local/ssl

$ make
# make test
# make install
$ cd /home/user/Midgard/mod_ssl-2.8.4-1.3.20
$ ./configure –with-apache=../apache_1.3.20

6. Apache httpd installation

# groupadd apache
# useradd -g apache apache
$ cd /home/user/Midgard/apache_1.3.20
$ ./configure –prefix=/usr/local/apache \

–enable-module=ssl \
–enable-module=so \
–with-perl=/usr/bin/perl \
–enable-shared=ssl \
–enable-shared=max \
–server-uid=apache \

–server-gid=apache \
–without-execstrip
$ make
# make certificate TYPE=custom
# make install
# /usr/local/apache/bin/apachectl start

7. PHP4 installation

$ cd /home/user/Midgard/php-4.3.1
$ ./configure –with-mysql=/usr/local/mysql \

–with-xml \
–with-apxs=/usr/local/apache/bin/apxs \
–enable-track-vars \
–enable-ftp
$ make
# make install

# cp php.ini-dist /usr/local/lib/php.ini
# php-config –extension-dir

I edited the /usr/local/lib/php.ini file so, that it loads midgard.so from
the proper extension dir, which I got by running php-config.

8. Midgard installation

8.1. Midgard-lib installation

$ cd /home/user/Midgard/midgard-lib-1.4.1-5
$ ./configure –prefix=/usr/local/midgard \
–with-sitegroups \
–with-mysql=/usr/local/mysql \
–with-expat

$ make
# make install

I also added /usr/local/midgard/lib to my /etc/ld.so.conf and ran ldconfig as
root.

8.2. Midgard-data installation

$ cd /home/user/Midgard/midgard-data-1.4.1-5
$ ./configure –with-db-admin=root \
–with-db-admin-password=myMySQLpassWord \
–with-db-user=midgard \
–with-db-user-password=midgard \
–with-db=midgard \

–with-lang=en \
–with-midgard=/usr/local/midgard \
–with-php=4 \
–with-blobdir=/var/www/blobs \
–with-apxs=/usr/local/apache/bin/apxs \
–with-apache-user=apache \

–with-install=new
# PATH=$PATH:/usr/local/mysql/bin
# ./dbinstall
# cp -r images/ /usr/local/apache/htdocs/ (for old admin images)
# cp midgard-data.conf /usr/local/apache/conf/

8.3. mod_midgard installation

# PATH=$PATH:/usr/local/midgard/bin/
$ cd /home/user/Midgard/mod_midgard-1.4.1-5
$ ./configure –with-midgard=/usr/local/midgard \
–with-mysql=/usr/local/mysql \

–with-expat=/usr/local \
–with-apxs=/usr/local/apache/bin/apxs
$ make
# make install
# cp midgard-root.php /usr/local/apache/libexec/

8.4. midgard-php4 installation

# PATH=$PATH:/usr/local/apache/bin/
# ./mkall /usr/local/midgard

9. Apache configuration

Added this to the last line of httpd.conf for Midgard to work:

 Include midgard-data.conf

Uncommented the following lines for PHP4 to work (needed by Midgard):

 AddType application/x-httpd-php .php
 AddType application/x-httpd-php-source .phps

I created a host called mydomain.org (my hostname) using the old admin site
and added a VirtualHost to Apache’s configuration file
(/usr/local/apache/conf/httpd.conf) like this one:

  <VirtualHost mydomain.org>
  MidgardEngine On
  ServerName mydomain.org
  DocumentRoot "/usr/local/apache/htdocs/user"
  </VirtualHost>

I restarted Apache:

# /usr/local/apache/bin/apachectl restart

10. Midgard configuration

I edited my /usr/local/apache/conf/midgard-data.conf:

Set MidgardRootFile to /usr/local/apache/libexec/midgard-root.php

11. Testing it all

Pointed my browser to http://localhost:80/asgard/ to see if it worked. It did.

Pointed my browser to http://localhost:80/admin/ to see if it worked. It did.

Pointed my browser to http://mydomain.org/ to see if it worked. It did.

12. nAdmin installation

# mv fimages.tgz /usr/local/apache/htdocs/
# tar xfvz fimages.tgz
# /usr/local/midgard/bin/repligard -c /usr/local/midgard/etc/repligard.conf \
-i /usr/local/apche/htdocs/nadmin_141_core.xmlgz

Tags: linux, midgard

This entry was posted on Saturday, October 3rd, 2009 at 11:10 and is filed under Linux/BSD Server Solutions. You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site.

devel.reinikainen.net