System Installation
From DISMARC Help
(→Other resources) |
|||
| Line 1: | Line 1: | ||
| - | This Help guides | + | This Help section guides you through the installation of the MDM ('''Metadata Manager''') on a Debin system. |
| - | Our Sticks ship with [http://www.ubuntu.com/ Ubuntu] 8.04 | + | Our Sticks ship with [http://www.ubuntu.com/ Ubuntu] 8.04 which is used throughout this help. |
== OS Settings == | == OS Settings == | ||
| - | + | It is advised to define a standard IP address because this installation will be a server. In order to make the installation accessible through the internet, you need to define a NAT on your router. Please read the [http://www.xlightftpd.com/tutorial/setup_behind_firewall.html documentation for your router to map the default HTTP port 80 to the IP address of the the new installation]. | |
| - | In case you don't use X I'm sure you know to change the IP address of your computer. In all other cases, hit ''<ALT>+<F2>'' and type ''network-admin''. You can change the settings there. | + | In case you don't use X I'm sure you know how to change the IP address of your computer. In all other cases, hit ''<ALT>+<F2>'' and type ''network-admin''. You can change the settings there. |
== Zebra installtion == | == Zebra installtion == | ||
| - | For an MDM Instance, you need a Zebra Index Server by Indexdata. The | + | For an MDM Instance, you need a Zebra Index Server by Indexdata. The installation is pretty easy. |
| - | + | Ubuntu does not have a dedicated root user. Instead, you just have to type ''sudo'' in front of a command and enter the password of the installation user. | |
| - | + | First you need a terminal. Hit ''<ALT>+<F2>'' and enter ''gnome-terminal'' to open a shell.<br> | |
| - | Now type in or | + | Now type in or copy the following comamnds: |
sudo bash | sudo bash | ||
| - | this opens the root shell and | + | this opens the root shell and you don't have to type sudo all the time. |
gedit /etc/apt/sources.list | gedit /etc/apt/sources.list | ||
Now add these lines to the bottom of the file | Now add these lines to the bottom of the file | ||
| Line 22: | Line 22: | ||
deb http://ftp.indexdata.dk/debian etch main | deb http://ftp.indexdata.dk/debian etch main | ||
deb-src http://ftp.indexdata.dk/debian etch main | deb-src http://ftp.indexdata.dk/debian etch main | ||
| - | + | Save and close the file. | |
| - | In order for apt (which is the | + | In order for apt (which is the installation tool on debian systems) to work with the Zebra packages, you need to install a key. |
Just type these lines into the console | Just type these lines into the console | ||
wget http://ftp.indexdata.dk/debian/indexdata.asc | wget http://ftp.indexdata.dk/debian/indexdata.asc | ||
| Line 30: | Line 30: | ||
apt-get update | apt-get update | ||
| - | + | For Ubuntu 8.04 and higher, you need to install some additional packages for zebra to work properly. These commands will help here. | |
wget http://launchpadlibrarian.net/10470097/libicu36-dev_3.6-10_i386.deb | wget http://launchpadlibrarian.net/10470097/libicu36-dev_3.6-10_i386.deb | ||
dpkg -i libicu36-dev_3.6-10_i386.deb | dpkg -i libicu36-dev_3.6-10_i386.deb | ||
| Line 38: | Line 38: | ||
apt-get -f install | apt-get -f install | ||
| - | + | Don't mind the error messages which eventually will pop up. The last command should have fixed everything. | |
Now it's time to install zebra. In one line, we install some more stuff. | Now it's time to install zebra. In one line, we install some more stuff. | ||
| Line 63: | Line 63: | ||
Now we need some mysql too | Now we need some mysql too | ||
apt-get install yaz libyaz2-dev libyaz2 yaz-icu libicu36 libicu36-dev idzebra-2.0 libidzebra-2.0-modules libidzebra-2.0-mod-grs-xml libidzebra-2.0-mod-grs-regx libidzebra-2.0 | apt-get install yaz libyaz2-dev libyaz2 yaz-icu libicu36 libicu36-dev idzebra-2.0 libidzebra-2.0-modules libidzebra-2.0-mod-grs-xml libidzebra-2.0-mod-grs-regx libidzebra-2.0 | ||
| - | + | Some additional GUI tools are installed with that one. | |
| - | + | You have prepared the system for MDM to run. | |
It's time to install the MDM itself now. | It's time to install the MDM itself now. | ||
== MDM installation == | == MDM installation == | ||
First, you need to obtain the lastest package from '''!!CSV!!''' | First, you need to obtain the lastest package from '''!!CSV!!''' | ||
| - | Extract it to your | + | Extract it to your webserver's directory which would be ''/srv/www/htdocs'' first, delete everything that is in this folder. |
sudo rm -rf /srv/www/htdocs/* | sudo rm -rf /srv/www/htdocs/* | ||
cd /srv/www/htdocs | cd /srv/www/htdocs | ||
tar -xzf $HOME/Desktop/mdmDismarc.tar.gz | tar -xzf $HOME/Desktop/mdmDismarc.tar.gz | ||
chown -R www-data:www-data /srv/www/htdocs | chown -R www-data:www-data /srv/www/htdocs | ||
Revision as of 16:05, 23 June 2008
This Help section guides you through the installation of the MDM (Metadata Manager) on a Debin system.
Our Sticks ship with Ubuntu 8.04 which is used throughout this help.
Contents |
OS Settings
It is advised to define a standard IP address because this installation will be a server. In order to make the installation accessible through the internet, you need to define a NAT on your router. Please read the documentation for your router to map the default HTTP port 80 to the IP address of the the new installation.
In case you don't use X I'm sure you know how to change the IP address of your computer. In all other cases, hit <ALT>+<F2> and type network-admin. You can change the settings there.
Zebra installtion
For an MDM Instance, you need a Zebra Index Server by Indexdata. The installation is pretty easy.
Ubuntu does not have a dedicated root user. Instead, you just have to type sudo in front of a command and enter the password of the installation user.
First you need a terminal. Hit <ALT>+<F2> and enter gnome-terminal to open a shell.
Now type in or copy the following comamnds:
sudo bash
this opens the root shell and you don't have to type sudo all the time.
gedit /etc/apt/sources.list
Now add these lines to the bottom of the file
# Zebra deb http://ftp.indexdata.dk/debian etch main deb-src http://ftp.indexdata.dk/debian etch main
Save and close the file.
In order for apt (which is the installation tool on debian systems) to work with the Zebra packages, you need to install a key. Just type these lines into the console
wget http://ftp.indexdata.dk/debian/indexdata.asc apt-key add indexdata.asc apt-get update
For Ubuntu 8.04 and higher, you need to install some additional packages for zebra to work properly. These commands will help here.
wget http://launchpadlibrarian.net/10470097/libicu36-dev_3.6-10_i386.deb dpkg -i libicu36-dev_3.6-10_i386.deb wget http://launchpadlibrarian.net/10470096/libicu36_3.6-10_i386.deb dpkg -i libicu36_3.6-10_i386.deb apt-get -f install
Don't mind the error messages which eventually will pop up. The last command should have fixed everything.
Now it's time to install zebra. In one line, we install some more stuff.
apt-get install yaz libyaz2-dev libyaz2 yaz-icu libicu36 libicu36-dev idzebra-2.0 libidzebra-2.0-modules libidzebra-2.0-mod-grs-xml libidzebra-2.0-mod-grs-regx libidzebra-2.0
That's it, zebra is installed.
The nice thing about that is, that Zebra will be updated throuth Ubuntus update routine now.
You can now close the terminal window.
Other resources
Ok, first we need a terminal. Hit <ALT>+<F2> and enter gnome-terminal to open a shell.
sudo bash
this will open a shell as root.
apt-get install apache2 php5 php5-sqlite php5-pgsql php5-mysql php5-yaz php5-xsl php5-curl php5-curl php5-gd php5-cli apt-get install subversion cvs proftpd
That's it! proftp should be installed as server from Inetd
apt-get install postfix
postfix is a satellite server
Now we need some mysql too
apt-get install yaz libyaz2-dev libyaz2 yaz-icu libicu36 libicu36-dev idzebra-2.0 libidzebra-2.0-modules libidzebra-2.0-mod-grs-xml libidzebra-2.0-mod-grs-regx libidzebra-2.0
Some additional GUI tools are installed with that one.
You have prepared the system for MDM to run. It's time to install the MDM itself now.
MDM installation
First, you need to obtain the lastest package from !!CSV!! Extract it to your webserver's directory which would be /srv/www/htdocs first, delete everything that is in this folder.
sudo rm -rf /srv/www/htdocs/* cd /srv/www/htdocs tar -xzf $HOME/Desktop/mdmDismarc.tar.gz chown -R www-data:www-data /srv/www/htdocs
