Archivematica - User contributions [en]

Improvements/CentOS-RedHat support/Installation

2017-02-15T22:31:49Z

Hakamine: /* Installing Archivematica MCP Client */

'''IMPORTANT NOTE''' These instructions will create an installation of a QA version of Archivematica and is not recommended for production use yet.

= Quick install using [https://www.vagrantup.com/ Vagrant] =

This method will have you up and running in no time, using a virtual machine provisioned with vagrant.

<ul>
<li>First, clone the am-packbuild repo:
<pre>git clone https://github.com/artefactual-labs/am-packbuild/</pre></li>
<li>cd into the rpm-testing directory
<pre>cd am-packbuild/rpm-testing/</pre></li>
<li>run vagrant
<pre>vagrant up</pre></li></ul>

After the install, the Archivematica Dashboard will be avaliable on port 81 of the vagrant deployed box, and the Storage Service, in port 8001.

You can log in the vm over ssh running <code>vagrant ssh</code>

= Step by step Install =

== Prerequisites ==

=== Extra repos ===

Some repositories need to be installed in order to fullfill the installation procedure:

<ul>
<li>Extra packages for enterprise linux
<pre>sudo yum install -y epel-release</pre></li>
<li>Elasticsearch
<pre>sudo -u root rpm --import https://packages.elastic.co/GPG-KEY-elasticsearch
sudo -u root bash -c 'cat << EOF > /etc/yum.repos.d/elasticsearch.repo
[elasticsearch-1.7]
name=Elasticsearch repository for 1.7 packages
baseurl=https://packages.elastic.co/elasticsearch/1.7/centos
gpgcheck=1
gpgkey=https://packages.elastic.co/GPG-KEY-elasticsearch
enabled=1
EOF'</pre></li>
<li>Archivematica
<pre>sudo -u root bash -c 'cat << EOF > /etc/yum.repos.d/archivematica.repo
[archivematica]
name=archivematica
baseurl=https://packages.archivematica.org/1.5.x/centos
gpgcheck=0
enabled=1
EOF'</pre></li></ul>

=== Service depencencies. ===

Common services like elasticsearch, mariadb and gearmand should be installed and enabled before the archivematica install. It can be done with:

<pre>sudo -u root yum install -y java-1.8.0-openjdk-headless elasticsearch mariadb-server gearmand
sudo -u root systemctl enable elasticsearch
sudo -u root systemctl start elasticsearch
sudo -u root systemctl enable mariadb
sudo -u root systemctl start mariadb
sudo -u root systemctl enable gearmand
sudo -u root systemctl start gearmand</pre>
== Installing Archivematica Storage Service ==

<ul>
<li>First, we install the packages:
<pre>sudo -u root yum install -y python-pip archivematica-storage-service</pre></li>
<li>After the package is installed, we need to populate the sqlite database, and collect some static files used by django. Those tasks must be run as “archivematica” user.
<pre>sudo -u archivematica bash -c " \
set -a -e -x
source /etc/sysconfig/archivematica-storage-service
cd /usr/share/archivematica/storage-service
/usr/lib/python2.7/archivematica/storage-service/bin/python manage.py migrate
/usr/lib/python2.7/archivematica/storage-service/bin/python manage.py collectstatic --noinput
";</pre></li>
<li>And now, we enable and start the archivematica-storage-service and it’s nginx frontend
<pre>sudo -u root systemctl enable archivematica-storage-service
sudo -u root systemctl start archivematica-storage-service
sudo -u root systemctl enable nginx
sudo -u root systemctl start nginx</pre></li></ul>

The storage service will be avaliable at http://<ip>:8001

== Installing Archivematica Dashboard and MCP Server ==

<ul>
<li>First, install the pacakges:
<pre>sudo -u root yum install -y archivematica-common archivematica-mcp-server archivematica-dashboard</pre></li>
<li>Create user and mysql database with:
<pre>sudo -H -u root mysql -hlocalhost -uroot -e "DROP DATABASE IF EXISTS MCP; CREATE DATABASE MCP CHARACTER SET utf8 COLLATE utf8_unicode_ci;"
sudo -H -u root mysql -hlocalhost -uroot -e "CREATE USER 'archivematica'@'localhost' IDENTIFIED BY 'demo';"
sudo -H -u root mysql -hlocalhost -uroot -e "GRANT ALL ON MCP.* TO 'archivematica'@'localhost';"</pre></li>
<li>And as archivematica user, run migrations:
<pre>sudo -u archivematica bash -c " \
set -a -e -x
source /etc/sysconfig/archivematica-dashboard
cd /usr/share/archivematica/dashboard
/usr/lib/python2.7/archivematica/dashboard/bin/python manage.py syncdb --noinput
";
</pre></li>
<li>Start and enable services:
<pre>sudo -u root systemctl enable archivematica-mcp-server
sudo -u root systemctl start archivematica-mcp-server
sudo -u root systemctl enable archivematica-dashboard
sudo -u root systemctl start archivematica-dashboard</pre></li>
<li>Reload nginx in order to load the dashboard config file: 
<pre>
sudo -u root systemctl reload nginx
</pre>
</li></ul>

The dashboard will be avaliable at http://ip:81

== Installing Archivematica MCP Client ==

<ul>
<li>First, we need to add some extra repos with the MCP Client dependencies:</li>
<li>Archivematica supplied external packages:
<pre>sudo -u root bash -c 'cat << EOF > /etc/yum.repos.d/archivematica-extras.repo
[archivematica-extras]
name=archivematica-extras
baseurl=https://packages.archivematica.org/1.5.x/centos-extras
gpgcheck=0
enabled=1
EOF'
</pre></li>
<li>Nux multimedia repo
<pre>sudo rpm -Uvh https://li.nux.ro/download/nux/dextop/el7/x86_64/nux-dextop-release-0-5.el7.nux.noarch.rpm</pre></li>
<li>Forensic tools repo
<pre>sudo rpm -Uvh https://forensics.cert.org/cert-forensics-tools-release-el7.rpm</pre></li>
<li>clamAV ( tested with version 0.99.2.01.el7 ) 
archivematica uses clamdscan (with "d"). Note that Clamd is a daemon that runs in the background and is called by clamdscan. This saves lots of time on scanning. Clamscan (without "d") is the "one off" version of this. It doesn't use clamd and therefore must load the virus database every time it runs. Also note that clamAV requires certain amount of RAM to run, in our tests it didn't run on a VM with 512M (check /var/log/messages if suspecting low memory, the OOM killer will log messages there when killing clamAV
<ul>
<li>Install EPEL repo
<pre># yum install epel-release</pre>
<li>Install clamAV packages
<pre># yum install clamav-server clamav-data clamav-update clamav-filesystem clamav clamav-scanner-systemd clamav-devel clamav-lib clamav-server-systemd</pre>
<li>edit /etc/freshclam.conf to comment out/remove "Example" line
<li>Run freshclam to retrieve virus database
<pre># freshclam</pre>
<li>edit /etc/sysconfig/freshclam to comment out the FRESHCLAM_DELAY=disabled-warn (to allow /etc/cron.d/clamav-update update the virus database)
<li>edit etc/clamd.d/scan.conf to comment out/remove "Example" line (add a "#" to comment out), and uncomment the "TCPSocket 3310" and "TCPAddr 127.0.0.1" lines (remove the "#")
<li>enable clamdscan@service
<pre>systemctl enable clamd@scan</pre>
<li>start clamdscan@service
<pre>systemctl start clamd@scan</pre>
<li> symlink /etc/clamd.d/scan.conf to /etc/clamd.conf (clamdscan expects the config file there)
<pre># ln -s /etc/clamd.d/scan.conf /etc/clamd.conf</pre>
<li> Check that clamdscan is working with user archivematica
<pre># sudo -u archivematica clamdscan - < /var/archivematica/sharedDirectory/currentlyProcessing/.gitignore
stream: OK

----------- SCAN SUMMARY -----------
Infected files: 0
Time: 0.003 sec (0 m 0 s)</pre>
(If the archivematica user does not have access to the socket will get an error "ERROR: Could not lookup : Servname not supported for ai_socktype")
</ul>
<li>Then, install the package:
<pre>sudo -u root yum install -y archivematica-mcp-client</pre></li>
<li>The MCP Client expect some programs in certain paths, so we put things in place:
<pre>
sudo ln -s /usr/bin/7za /usr/bin/7z</pre></li>
<li>After that, we can enable and start services
<pre>sudo -u root systemctl enable archivematica-mcp-client
sudo -u root systemctl start archivematica-mcp-client
sudo -u root systemctl enable fits-nailgun
sudo -u root systemctl start fits-nailgun</pre></li></ul>

== Finalizing Installation ==

The dashboard will be available on port 81, and the storage service on port 8001. You will need to complete the installation by opening up the dashboard in a web browser, and filling in the form you are presented with. On the 2nd page of the installer, you are asked for information about the storage service. You will need to log into the storage service and find the api key that was generated for your user (in admin->users).

== Configuration ==

Each service have a configuration file in /etc/sysconfig/archivematica-''packagename''

== Known bugs / Caveats ==

* If IPv6 is disabled, Nginx may refuse to start. If that is the case make sure that the listen directives used under /etc/nginx are not using IPv6 addresses like [::]:80.
* In RHEL 7 , you might need to enable repo rhel-7-server-eus-optional-rpms with
<pre>
sudo subscription-manager repos --enable rhel-7-server-eus-optional-rpms
</pre>
* If you find a bug, please let us know [https://github.com/artefactual-labs/am-packbuild/issues here]

Improvements/CentOS-RedHat support/Installation

2017-02-14T01:12:15Z

Hakamine: /* Installing Archivematica MCP Client */

'''IMPORTANT NOTE''' These instructions will create an installation of a QA version of Archivematica and is not recommended for production use yet.

= Quick install using [https://www.vagrantup.com/ Vagrant] =

This method will have you up and running in no time, using a virtual machine provisioned with vagrant.

<ul>
<li>First, clone the am-packbuild repo:
<pre>git clone https://github.com/artefactual-labs/am-packbuild/</pre></li>
<li>cd into the rpm-testing directory
<pre>cd am-packbuild/rpm-testing/</pre></li>
<li>run vagrant
<pre>vagrant up</pre></li></ul>

After the install, the Archivematica Dashboard will be avaliable on port 81 of the vagrant deployed box, and the Storage Service, in port 8001.

You can log in the vm over ssh running <code>vagrant ssh</code>

= Step by step Install =

== Prerequisites ==

=== Extra repos ===

Some repositories need to be installed in order to fullfill the installation procedure:

<ul>
<li>Extra packages for enterprise linux
<pre>sudo yum install -y epel-release</pre></li>
<li>Elasticsearch
<pre>sudo -u root rpm --import https://packages.elastic.co/GPG-KEY-elasticsearch
sudo -u root bash -c 'cat << EOF > /etc/yum.repos.d/elasticsearch.repo
[elasticsearch-1.7]
name=Elasticsearch repository for 1.7 packages
baseurl=https://packages.elastic.co/elasticsearch/1.7/centos
gpgcheck=1
gpgkey=https://packages.elastic.co/GPG-KEY-elasticsearch
enabled=1
EOF'</pre></li>
<li>Archivematica
<pre>sudo -u root bash -c 'cat << EOF > /etc/yum.repos.d/archivematica.repo
[archivematica]
name=archivematica
baseurl=https://packages.archivematica.org/1.5.x/centos
gpgcheck=0
enabled=1
EOF'</pre></li></ul>

=== Service depencencies. ===

Common services like elasticsearch, mariadb and gearmand should be installed and enabled before the archivematica install. It can be done with:

<pre>sudo -u root yum install -y java-1.8.0-openjdk-headless elasticsearch mariadb-server gearmand
sudo -u root systemctl enable elasticsearch
sudo -u root systemctl start elasticsearch
sudo -u root systemctl enable mariadb
sudo -u root systemctl start mariadb
sudo -u root systemctl enable gearmand
sudo -u root systemctl start gearmand</pre>
== Installing Archivematica Storage Service ==

<ul>
<li>First, we install the packages:
<pre>sudo -u root yum install -y python-pip archivematica-storage-service</pre></li>
<li>After the package is installed, we need to populate the sqlite database, and collect some static files used by django. Those tasks must be run as “archivematica” user.
<pre>sudo -u archivematica bash -c " \
set -a -e -x
source /etc/sysconfig/archivematica-storage-service
cd /usr/share/archivematica/storage-service
/usr/lib/python2.7/archivematica/storage-service/bin/python manage.py migrate
/usr/lib/python2.7/archivematica/storage-service/bin/python manage.py collectstatic --noinput
";</pre></li>
<li>And now, we enable and start the archivematica-storage-service and it’s nginx frontend
<pre>sudo -u root systemctl enable archivematica-storage-service
sudo -u root systemctl start archivematica-storage-service
sudo -u root systemctl enable nginx
sudo -u root systemctl start nginx</pre></li></ul>

The storage service will be avaliable at http://<ip>:8001

== Installing Archivematica Dashboard and MCP Server ==

<ul>
<li>First, install the pacakges:
<pre>sudo -u root yum install -y archivematica-common archivematica-mcp-server archivematica-dashboard</pre></li>
<li>Create user and mysql database with:
<pre>sudo -H -u root mysql -hlocalhost -uroot -e "DROP DATABASE IF EXISTS MCP; CREATE DATABASE MCP CHARACTER SET utf8 COLLATE utf8_unicode_ci;"
sudo -H -u root mysql -hlocalhost -uroot -e "CREATE USER 'archivematica'@'localhost' IDENTIFIED BY 'demo';"
sudo -H -u root mysql -hlocalhost -uroot -e "GRANT ALL ON MCP.* TO 'archivematica'@'localhost';"</pre></li>
<li>And as archivematica user, run migrations:
<pre>sudo -u archivematica bash -c " \
set -a -e -x
source /etc/sysconfig/archivematica-dashboard
cd /usr/share/archivematica/dashboard
/usr/lib/python2.7/archivematica/dashboard/bin/python manage.py syncdb --noinput
";
</pre></li>
<li>Start and enable services:
<pre>sudo -u root systemctl enable archivematica-mcp-server
sudo -u root systemctl start archivematica-mcp-server
sudo -u root systemctl enable archivematica-dashboard
sudo -u root systemctl start archivematica-dashboard</pre></li>
<li>Reload nginx in order to load the dashboard config file: 
<pre>
sudo -u root systemctl reload nginx
</pre>
</li></ul>

The dashboard will be avaliable at http://ip:81

== Installing Archivematica MCP Client ==

<ul>
<li>First, we need to add some extra repos with the MCP Client dependencies:</li>
<li>Archivematica supplied external packages:
<pre>sudo -u root bash -c 'cat << EOF > /etc/yum.repos.d/archivematica-extras.repo
[archivematica-extras]
name=archivematica-extras
baseurl=https://packages.archivematica.org/1.5.x/centos-extras
gpgcheck=0
enabled=1
EOF'
</pre></li>
<li>Nux multimedia repo
<pre>sudo rpm -Uvh https://li.nux.ro/download/nux/dextop/el7/x86_64/nux-dextop-release-0-5.el7.nux.noarch.rpm</pre></li>
<li>Forensic tools repo
<pre>sudo rpm -Uvh https://forensics.cert.org/cert-forensics-tools-release-el7.rpm</pre></li>
<li>clamAV ( tested with version 0.99.2.01.el7 ) 
archivematica uses clamdscan (with "d"). Note that Clamd is a daemon that runs in the background and is called by clamdscan. This saves lots of time on scanning. Clamscan (without "d") is the "one off" version of this. It doesn't use clamd and therefore must load the virus database every time it runs. Also note that clamAV requires certain amount of RAM to run, in our tests it didn't run on a VM with 512M (check /var/log/messages if suspecting low memory, the OOM killer will log messages there when killing clamAV
<ul>
<li>Install EPEL repo
<pre># yum install epel-release</pre>
<li>Install clamAV packages
<pre># yum install clamav-server clamav-data clamav-update clamav-filesystem clamav clamav-scanner-systemd clamav-devel clamav-lib clamav-server-systemd</pre>
<li>edit /etc/freshclam.conf to comment out/remove "Example" line
<li>Run freshclam to retrieve virus database
<pre># freshclam</pre>
<li>edit /etc/sysconfig/freshclam to comment out the FRESHCLAM_DELAY=disabled-warn (to allow /etc/cron.d/clamav-update update the virus database)
<li>edit etc/clamd.d/scan.conf to comment out/remove "Example" line, and uncomment the "#LocalSocket /var/run/clamd.scan/clamd.sock" line (remove the "#")
<li>enable clamdscan@service
<pre>systemctl enable clamd@scan</pre>
<li>start clamdscan@service
<pre>systemctl start clamd@scan</pre>
<li> symlink /etc/clamd.d/scan.conf to /etc/clamd.conf (clamdscan expects the config file there)
<pre># ln -s /etc/clamd.d/scan.conf /etc/clamd.conf</pre>
<li>Add user archivematica to clamscan group (so that it can have access to clamdscan unix socket
<pre># usermod -a -G clamscan archivematica </pre>
<li> Check that clamdscan is working with user archivematica
<pre># sudo -u archivematica clamdscan - < /var/archivematica/sharedDirectory/currentlyProcessing/.gitignore
fd[10]: OK

----------- SCAN SUMMARY -----------
Infected files: 0
Time: 0.001 sec (0 m 0 s)</pre>
(If the archivematica user does not have access to the socket will get an error "ERROR: Could not lookup : Servname not supported for ai_socktype")
</ul>
<li>Then, install the package:
<pre>sudo -u root yum install -y archivematica-mcp-client</pre></li>
<li>The MCP Client expect some programs in certain paths, so we put things in place:
<pre>
sudo ln -s /usr/bin/7za /usr/bin/7z</pre></li>
<li>After that, we can enable and start services
<pre>sudo -u root systemctl enable archivematica-mcp-client
sudo -u root systemctl start archivematica-mcp-client
sudo -u root systemctl enable fits-nailgun
sudo -u root systemctl start fits-nailgun</pre></li></ul>

== Finalizing Installation ==

The dashboard will be available on port 81, and the storage service on port 8001. You will need to complete the installation by opening up the dashboard in a web browser, and filling in the form you are presented with. On the 2nd page of the installer, you are asked for information about the storage service. You will need to log into the storage service and find the api key that was generated for your user (in admin->users).

== Configuration ==

Each service have a configuration file in /etc/sysconfig/archivematica-''packagename''

== Known bugs / Caveats ==

* If IPv6 is disabled, Nginx may refuse to start. If that is the case make sure that the listen directives used under /etc/nginx are not using IPv6 addresses like [::]:80.
* In RHEL 7 , you might need to enable repo rhel-7-server-eus-optional-rpms with
<pre>
sudo subscription-manager repos --enable rhel-7-server-eus-optional-rpms
</pre>
* If you find a bug, please let us know [https://github.com/artefactual-labs/am-packbuild/issues here]

Improvements/CentOS-RedHat support/Installation

2016-12-13T19:54:44Z

Hakamine: /* clamAV install instructions */

'''IMPORTANT NOTE''' These instructions will create an installation of a QA version of Archivematica and is not recommended for production use yet.

= Quick install using [https://www.vagrantup.com/ Vagrant] =

This method will have you up and running in no time, using a virtual machine provisioned with vagrant.

<ul>
<li>First, clone the am-packbuild repo:
<pre>git clone https://github.com/artefactual-labs/am-packbuild/</pre></li>
<li>cd into the rpm-testing directory
<pre>cd am-packbuild/rpm-testing/</pre></li>
<li>run vagrant
<pre>vagrant up</pre></li></ul>

After the install, the Archivematica Dashboard will be avaliable on port 81 of the vagrant deployed box, and the Storage Service, in port 8001.

You can log in the vm over ssh running <code>vagrant ssh</code>

= Step by step Install =

== Prerequisites ==

=== Extra repos ===

Some repositories need to be installed in order to fullfill the installation procedure:

<ul>
<li>Extra packages for enterprise linux
<pre>sudo yum install -y epel-release</pre></li>
<li>Elasticsearch
<pre>sudo -u root rpm --import https://packages.elastic.co/GPG-KEY-elasticsearch
sudo -u root bash -c 'cat << EOF > /etc/yum.repos.d/elasticsearch.repo
[elasticsearch-1.7]
name=Elasticsearch repository for 1.7 packages
baseurl=https://packages.elastic.co/elasticsearch/1.7/centos
gpgcheck=1
gpgkey=https://packages.elastic.co/GPG-KEY-elasticsearch
enabled=1
EOF'</pre></li>
<li>Archivematica
<pre>sudo -u root bash -c 'cat << EOF > /etc/yum.repos.d/archivematica.repo
[archivematica]
name=archivematica
baseurl=https://packages.archivematica.org/1.5.x/centos
gpgcheck=0
enabled=1
EOF'</pre></li></ul>

=== Service depencencies. ===

Common services like elasticsearch, mariadb and gearmand should be installed and enabled before the archivematica install. It can be done with:

<pre>sudo -u root yum install -y java-1.8.0-openjdk-headless elasticsearch mariadb-server gearmand
sudo -u root systemctl enable elasticsearch
sudo -u root systemctl start elasticsearch
sudo -u root systemctl enable mariadb
sudo -u root systemctl start mariadb
sudo -u root systemctl enable gearmand
sudo -u root systemctl start gearmand</pre>
== Installing Archivematica Storage Service ==

<ul>
<li>First, we install the packages:
<pre>sudo -u root yum install -y python-pip archivematica-storage-service</pre></li>
<li>After the package is installed, we need to populate the sqlite database, and collect some static files used by django. Those tasks must be run as “archivematica” user.
<pre>sudo -u archivematica bash -c " \
set -a -e -x
source /etc/sysconfig/archivematica-storage-service
cd /usr/share/archivematica/storage-service
/usr/lib/python2.7/archivematica/storage-service/bin/python manage.py migrate
/usr/lib/python2.7/archivematica/storage-service/bin/python manage.py collectstatic --noinput
";</pre></li>
<li>And now, we enable and start the archivematica-storage-service and it’s nginx frontend
<pre>sudo -u root systemctl enable archivematica-storage-service
sudo -u root systemctl start archivematica-storage-service
sudo -u root systemctl enable nginx
sudo -u root systemctl start nginx</pre></li></ul>

The storage service will be avaliable at http://<ip>:8001

== Installing Archivematica Dashboard and MCP Server ==

<ul>
<li>First, install the pacakges:
<pre>sudo -u root yum install -y archivematica-common archivematica-mcp-server archivematica-dashboard</pre></li>
<li>Create user and mysql database with:
<pre>sudo -H -u root mysql -hlocalhost -uroot -e "DROP DATABASE IF EXISTS MCP; CREATE DATABASE MCP CHARACTER SET utf8 COLLATE utf8_unicode_ci;"
sudo -H -u root mysql -hlocalhost -uroot -e "CREATE USER 'archivematica'@'localhost' IDENTIFIED BY 'demo';"
sudo -H -u root mysql -hlocalhost -uroot -e "GRANT ALL ON MCP.* TO 'archivematica'@'localhost';"</pre></li>
<li>And as archivematica user, run migrations:
<pre>sudo -u archivematica bash -c " \
set -a -e -x
source /etc/sysconfig/archivematica-dashboard
cd /usr/share/archivematica/dashboard
/usr/lib/python2.7/archivematica/dashboard/bin/python manage.py syncdb --noinput
";
</pre></li>
<li>Start and enable services:
<pre>sudo -u root systemctl enable archivematica-mcp-server
sudo -u root systemctl start archivematica-mcp-server
sudo -u root systemctl enable archivematica-dashboard
sudo -u root systemctl start archivematica-dashboard</pre></li>
<li>Reload nginx in order to load the dashboard config file: 
<pre>
sudo -u root systemctl reload nginx
</pre>
</li></ul>

The dashboard will be avaliable at http://ip:81

== Installing Archivematica MCP Client ==

<ul>
<li>First, we need to add some extra repos with the MCP Client dependencies:</li>
<li>Archivematica supplied external packages:
<pre>sudo -u root bash -c 'cat << EOF > /etc/yum.repos.d/archivematica-extras.repo
[archivematica-extras]
name=archivematica-extras
baseurl=https://packages.archivematica.org/1.5.x/centos-extras
gpgcheck=0
enabled=1
EOF'
</pre></li>
<li>Nux multimedia repo
<pre>sudo rpm -Uvh https://li.nux.ro/download/nux/dextop/el7/x86_64/nux-dextop-release-0-5.el7.nux.noarch.rpm</pre></li>
<li>Forensic tools repo
<pre>sudo rpm -Uvh https://forensics.cert.org/cert-forensics-tools-release-el7.rpm</pre></li>
<li>clamAV ( tested with version 0.99.2.01.el7 ) 
archivematica uses clamdscan (with "d"). Note that Clamd is a daemon that runs in the background and is called by clamdscan. This saves lots of time on scanning. Clamscan (without "d") is the "one off" version of this. It doesn't use clamd and therefore must load the virus database every time it runs. Also note that clamAV requires certain amount of RAM to run, in our tests it didn't run on a VM with 512M (check /var/log/messages if suspecting low memory, the OOM killer will log messages there when killing clamAV
<ul>
<li>Install EPEL repo
<pre># yum install epel-release</pre>
<li>Install clamAV packages
<pre># yum install clamav-server clamav-data clamav-update clamav-filesystem clamav clamav-scanner-systemd clamav-devel clamav-lib clamav-server-systemd</pre>
<li>edit /etc/freshclam.conf to comment out/remove "Example" line
<li>Run freshclam to retrieve virus database
<pre># freshclam</pre>
<li>edit /etc/sysconfig/freshclam to comment out the FRESHCLAM_DELAY=disabled-warn (to allow /etc/cron.d/clamav-update update the virus database)
<li>edit etc/clamd.d/scan.conf to comment out/remove "Example" line, and uncomment the "#LocalSocket /var/run/clamd.scan/clamd.sock" line (remove the "#")
<li>enable clamdscan@service
<pre>systemctl enable clamd@scan</pre>
<li>start clamdscan@service
<pre>systemctl start clamd@scan</pre>
<li> symlink /etc/clamd.d/scan.conf to /etc/clamd.conf (clamdscan expects the config file there)
<pre> ln -s /etc/clamd.d/scan.conf /etc/clamd.conf</pre>
</ul>
<li>Then, install the package:
<pre>sudo -u root yum install -y archivematica-mcp-client</pre></li>
<li>The MCP Client expect some programs in certain paths, so we put things in place:
<pre>
sudo ln -s /usr/bin/7za /usr/bin/7z</pre></li>
<li>After that, we can enable and start services
<pre>sudo -u root systemctl enable archivematica-mcp-client
sudo -u root systemctl start archivematica-mcp-client
sudo -u root systemctl enable fits-nailgun
sudo -u root systemctl start fits-nailgun</pre></li></ul>

== Finalizing Installation ==

The dashboard will be available on port 81, and the storage service on port 8001. You will need to complete the installation by opening up the dashboard in a web browser, and filling in the form you are presented with. On the 2nd page of the installer, you are asked for information about the storage service. You will need to log into the storage service and find the api key that was generated for your user (in admin->users).

== Configuration ==

Each service have a configuration file in /etc/sysconfig/archivematica-''packagename''

== Known bugs / Caveats ==

* If IPv6 is disabled, Nginx may refuse to start. If that is the case make sure that the listen directives used under /etc/nginx are not using IPv6 addresses like [::]:80.
* In RHEL 7 , you might need to enable repo rhel-7-server-eus-optional-rpms with
<pre>
sudo subscription-manager repos --enable rhel-7-server-eus-optional-rpms
</pre>
* If you find a bug, please let us know [https://github.com/artefactual-labs/am-packbuild/issues here]

Improvements/CentOS-RedHat support

2016-01-31T16:39:25Z

Hakamine: /* Pipeline (dashboard, MCP Server, MCP Client) */

== User Story ==

As a systems administrator, I would like to be able to run Archivematica on an rpm based version of linux like CentOS or RedHat.

== Status ==

Discussion/Analysis. No code has yet been written to support this improvement.

== Interest ==

Please feel free to add your organizations name to this list, if you have an interest in this improvement.

Artefactual would like to see this improvement developed. We are able to do the development work, for a fee. We are also willing to assist others to complete all or part of the work required, in order to reduce the scope down to a level where Artefactual can complete the process as part of our existing commitment to provide new packages with each release.

== Analysis: ==

=== The Current Situation ===

Currently, Archivematica only works on LTS versions of Ubuntu (14.04 and 12.04). This is not due to any specific limitations in the Archivematica codebase, it is entirely a matter of packaging and bundling the large number of dependencies required in an Archivematica installation.

Archivematica is comprised of a set of 5 separate packages, written primarily in python. Artefactual currently builds .deb packages for Ubuntu of all 5 packages, and makes them available via launchpad (e.g, the most current stable version is at https://launchpad.net/~archivematica/+archive/ubuntu/1.4).

It is not necessary to use those .deb packages to install Archivematica. For example see these instructions for installing Archivematica using Ansible and Vagrant (https://wiki.archivematica.org/Getting_started#Installation). In that example, the 5 Archivematica packages are installed directly from github, as source, not from .deb packages. However, the longer list of external dependencies are still installed from .deb packages.

Some of those .deb packages are available in the standard Ubuntu repositories, like apache and mysql. Others, like jhove, are in the Ubuntu multiverse repository, which is not always enabled by default in Ubuntu, but is easy to enable. Others are either not available from Ubuntu repositories, or the versions available there are too old to work in Archivematica. For these packages, Artefactual has taken on the responsibility for building .deb packages, and hosting them on launchpad. There are several listed here for example https://launchpad.net/~archivematica/+archive/ubuntu/1.4, like bagit, bulk_extractor, ffmpeg and others.

==== List of Archivematica's Ubuntu Package Dependencies ====

This list is based on the packages installed by the Ansible role ( https://github.com/artefactual-labs/ansible-role-archivematica-src )

Note that it is planned to move some package based dependencies to pip ( https://github.com/artefactual/archivematica/pull/398 )

===== Installed Using Packages =====

====== Storage Service ======

- "python-lxml"
- "nginx"
- "unar"
- "uwsgi"
- "uwsgi-plugin-python"
- "python-virtualenv"
- "python-dev"
- "libxml2-dev"
- "libxslt1-dev"
- "libz-dev"
- "libffi-dev"
- "libssl-dev"

====== Pipeline (dashboard, MCP Server, MCP Client) ======

- "python"
- "python-pip"
- "python2.7-elementtree"
- "python-mimeparse"
- "python-dateutil"

- "apache2-mpm-prefork"
- "libapache2-mod-wsgi"
- "python-pip"
- "python-gearman"
- "python-simplejson"

- "dbconfig-common"
- "logapp"
- "python-pyinotify"
- "python-gearman"
- "python-mysqldb"
- "python-lxml"
- "uuid"

- "atool"
- "bagit" (*)
- "bulk-extractor" (*)
- "clamav"
- "clamav-daemon"
- "ffmpeg" (*)
- "fits" (*)
- "gearman"
- "imagemagick"
- "inkscape"
- "jhove"
- "libimage-exiftool-perl" (*)
- "libxml2-utils"
- "logapp"
- "md5deep"
- "mediainfo"
- "nfs-common"
- "openjdk-7-jre-headless"
- "p7zip-full"
- "pbzip2"
- "postfix"
- "python-fido" (*)
- "python-gearman"
- "python-lxml"
- "python-mysqldb"
- "python-pyicu"
- "python-unidecode"
- "readpst"
- "rsync"
- "siegfried" (*)
- "sleuthkit" (*)
- "tesseract-ocr"
- "tika" (*)
- "tree"
- "ufraw"
- "unrar-free"
- "uuid"

Packages with an (*) have been built by Artefactual, as they do not exist in the public Ubuntu repositories, or the versions found in the public repositories were not recent enough for Archivematica to work properly.

=== RPM Support ===

This analysis is based on the use of CentOS/Redhat 7, for a port to CentOS 6, there would be more work than is outlined here.

In order to get Archivematica running on an rpm based linux distribution, a set of 5 rpm packages for the different Archivematica applications would need to be created. RPM's for about 30 different dependencies would also have to be created.

Archivematica Packages:

Archivematica Common
Dashboard
MCP Server
MCP Client
Archivematica Storage Service

optional (not all of these are currently being packaged as .debs):
MCP rpc Client
automation-tools
archivematica-devtools

Other Open Source applications required in rpm packages for Archivematica:

* atool
* bagit
* bulk_extractor
* exiftool (repoforge has this, but we want to package a specific version)
* ffmpeg
** libasound2
** jack
** openjpeg - 1.5.x is packaged, might be new enough to avoid packaging
** libraw1394 - we might be able to live without this
** libvpx
* fido
* fits
* gearman / python-gearman
* jhove
* mediainfo
* nailgun / nailgun-client
* nfs - should work without extra packages, but requires testing
* python-elementtree
* python-mimeparse
* siegfried
** go 1.4
* sleuthkit
** afflib
** libbfio
** libewf (version in repoforge is 3 years older)
* tika
* ufraw
* unar
* unidecode
* unrar-free

All of the remaining required dependencies are either included in the stock RHEL/CentOS 7 repositories, or in the third-party Repoforge repository.
(TODO: list which repo each dependency is maintained in).

Artefactual already produces Ubuntu packages for most of the packages listed here, and we have some tooling in place to automate some of this process.
See: https://github.com/artefactual-labs/am-packbuild for an example set of python scripts used to create Ubuntu packages for the 5 Archivematica packages.
(TODO: move ubuntu packaging scripts to github).

== Scope ==

Artefactual has done some analysis of the effort required, and provided quotes for this work to some institutions, at their request. Feel free to add additional comments or another piece to this section if you have more information about the possible scope of work required.

=== Proposed Approach ===

# Check if the Ubuntu package dependencies have equivalent RPMs in CentOS. We estimate that Ubuntu packages provided by standard Ubuntu repositories have a CentOS equivalent in the standard CentOS repos, and that all the Ubuntu packages built by Artefactual are missing in CentOS and require to be built as well
# Build missing CentOS RPMs package dependencies
# Fix the ansible role in https://github.com/artefactual-labs/ansible-role-archivematica-src to be able to install Archivematica / Storage Service in CentOS
# Repeat steps above as required until we obtain a working CentOS installation

=== Artefactual Estimate ===

We have estimated that it would take about 16-20 hours to create an initial set of packages for all of the required applications.

Another 12-16 hours of testing would be required, at a minimum, to confirm that all the packages are working properly, and to do very basic tests of Archivematica on CentOS 7. Further testing would be desirable, any testing that could be done by the community would help improve the outcome of this work.

We would probably need another 8 hours of work for project administration and documentation.

Based on these estimates, it would probably take about 40 hours of work to create the required packages and test and document the CentOS 7 installation procedure.

Artefactual provides development services on either a fixed fee or a time and materials basis. We offer a less expensive rate for time and materials contracts. Our rates are listed here:

https://www.artefactual.com/services/

== Alternative approaches ==

It's also possible to ship the Archivematica packages and its dependencies as container images. Docker has donated its container format and runtime to the [https://www.opencontainers.org/ Open Container Initiative]. These images are composable and they can run via the Docker or rkt container runtimes or independently via [https://github.com/opencontainers/runc runC]. Images are easily distributed via services like [https://hub.docker.com/ Docker Hub] or [https://github.com/docker/distribution Docker Distribution].

A first attempt at this approach has been published [https://hub.docker.com/r/sevein/archivematica-mcp-client-base/]. This is a docker image containing all of the dependencies of the Archivematica MCP Client package. The image is built on top of an ubuntu base image, but it can be deployed on any linux distribution, not just CentOS. Docker images can also be run on a windows host, via virtualbox on windows 8/10, and via Windows Containers on Windows Server 2016.

It is possible to produce rpm packages, that contain docker images, for example: [https://github.com/alanfranz/docker-rpm-builder].

More on Docker from RedHat: [http://developerblog.redhat.com/2014/05/15/practical-introduction-to-docker-containers/]

Improvements/CentOS-RedHat support

2016-01-31T16:33:43Z

Hakamine: /* Scope */

== User Story ==

As a systems administrator, I would like to be able to run Archivematica on an rpm based version of linux like CentOS or RedHat.

== Status ==

Discussion/Analysis. No code has yet been written to support this improvement.

== Interest ==

Please feel free to add your organizations name to this list, if you have an interest in this improvement.

Artefactual would like to see this improvement developed. We are able to do the development work, for a fee. We are also willing to assist others to complete all or part of the work required, in order to reduce the scope down to a level where Artefactual can complete the process as part of our existing commitment to provide new packages with each release.

== Analysis: ==

=== The Current Situation ===

Currently, Archivematica only works on LTS versions of Ubuntu (14.04 and 12.04). This is not due to any specific limitations in the Archivematica codebase, it is entirely a matter of packaging and bundling the large number of dependencies required in an Archivematica installation.

Archivematica is comprised of a set of 5 separate packages, written primarily in python. Artefactual currently builds .deb packages for Ubuntu of all 5 packages, and makes them available via launchpad (e.g, the most current stable version is at https://launchpad.net/~archivematica/+archive/ubuntu/1.4).

It is not necessary to use those .deb packages to install Archivematica. For example see these instructions for installing Archivematica using Ansible and Vagrant (https://wiki.archivematica.org/Getting_started#Installation). In that example, the 5 Archivematica packages are installed directly from github, as source, not from .deb packages. However, the longer list of external dependencies are still installed from .deb packages.

Some of those .deb packages are available in the standard Ubuntu repositories, like apache and mysql. Others, like jhove, are in the Ubuntu multiverse repository, which is not always enabled by default in Ubuntu, but is easy to enable. Others are either not available from Ubuntu repositories, or the versions available there are too old to work in Archivematica. For these packages, Artefactual has taken on the responsibility for building .deb packages, and hosting them on launchpad. There are several listed here for example https://launchpad.net/~archivematica/+archive/ubuntu/1.4, like bagit, bulk_extractor, ffmpeg and others.

==== List of Archivematica's Ubuntu Package Dependencies ====

This list is based on the packages installed by the Ansible role ( https://github.com/artefactual-labs/ansible-role-archivematica-src )

Note that it is planned to move some package based dependencies to pip ( https://github.com/artefactual/archivematica/pull/398 )

===== Installed Using Packages =====

====== Storage Service ======

- "python-lxml"
- "nginx"
- "unar"
- "uwsgi"
- "uwsgi-plugin-python"
- "python-virtualenv"
- "python-dev"
- "libxml2-dev"
- "libxslt1-dev"
- "libz-dev"
- "libffi-dev"
- "libssl-dev"

====== Pipeline (dashboard, MCP Server, MCP Client) ======

- "python"
- "python-pip"
- "python2.7-elementtree"
- "python-mimeparse"
- "python-dateutil"

- "apache2-mpm-prefork"
- "libapache2-mod-wsgi"
- "python-pip"
- "python-gearman"
- "python-simplejson"

- "dbconfig-common"
- "logapp"
- "python-pyinotify"
- "python-gearman"
- "python-mysqldb"
- "python-lxml"
- "uuid"

- "atool"
- "bagit"
- "bulk-extractor"
- "clamav"
- "clamav-daemon"
- "ffmpeg"
- "fits"
- "gearman"
- "imagemagick"
- "inkscape"
- "jhove"
- "libimage-exiftool-perl"
- "libxml2-utils"
- "logapp"
- "md5deep"
- "mediainfo"
- "nfs-common"
- "openjdk-7-jre-headless"
- "p7zip-full"
- "pbzip2"
- "postfix"
- "python-fido"
- "python-gearman"
- "python-lxml"
- "python-mysqldb"
- "python-pyicu"
- "python-unidecode"
- "readpst"
- "rsync"
- "siegfried"
- "sleuthkit"
- "tesseract-ocr"
- "tika"
- "tree"
- "ufraw"
- "unrar-free"
- "uuid"

=== RPM Support ===

This analysis is based on the use of CentOS/Redhat 7, for a port to CentOS 6, there would be more work than is outlined here.

In order to get Archivematica running on an rpm based linux distribution, a set of 5 rpm packages for the different Archivematica applications would need to be created. RPM's for about 30 different dependencies would also have to be created.

Archivematica Packages:

Archivematica Common
Dashboard
MCP Server
MCP Client
Archivematica Storage Service

optional (not all of these are currently being packaged as .debs):
MCP rpc Client
automation-tools
archivematica-devtools

Other Open Source applications required in rpm packages for Archivematica:

* atool
* bagit
* bulk_extractor
* exiftool (repoforge has this, but we want to package a specific version)
* ffmpeg
** libasound2
** jack
** openjpeg - 1.5.x is packaged, might be new enough to avoid packaging
** libraw1394 - we might be able to live without this
** libvpx
* fido
* fits
* gearman / python-gearman
* jhove
* mediainfo
* nailgun / nailgun-client
* nfs - should work without extra packages, but requires testing
* python-elementtree
* python-mimeparse
* siegfried
** go 1.4
* sleuthkit
** afflib
** libbfio
** libewf (version in repoforge is 3 years older)
* tika
* ufraw
* unar
* unidecode
* unrar-free

All of the remaining required dependencies are either included in the stock RHEL/CentOS 7 repositories, or in the third-party Repoforge repository.
(TODO: list which repo each dependency is maintained in).

Artefactual already produces Ubuntu packages for most of the packages listed here, and we have some tooling in place to automate some of this process.
See: https://github.com/artefactual-labs/am-packbuild for an example set of python scripts used to create Ubuntu packages for the 5 Archivematica packages.
(TODO: move ubuntu packaging scripts to github).

== Scope ==

Artefactual has done some analysis of the effort required, and provided quotes for this work to some institutions, at their request. Feel free to add additional comments or another piece to this section if you have more information about the possible scope of work required.

=== Proposed Approach ===

# Check if the Ubuntu package dependencies have equivalent RPMs in CentOS. We estimate that Ubuntu packages provided by standard Ubuntu repositories have a CentOS equivalent in the standard CentOS repos, and that all the Ubuntu packages built by Artefactual are missing in CentOS and require to be built as well
# Build missing CentOS RPMs package dependencies
# Fix the ansible role in https://github.com/artefactual-labs/ansible-role-archivematica-src to be able to install Archivematica / Storage Service in CentOS
# Repeat steps above as required until we obtain a working CentOS installation

=== Artefactual Estimate ===

We have estimated that it would take about 16-20 hours to create an initial set of packages for all of the required applications.

Another 12-16 hours of testing would be required, at a minimum, to confirm that all the packages are working properly, and to do very basic tests of Archivematica on CentOS 7. Further testing would be desirable, any testing that could be done by the community would help improve the outcome of this work.

We would probably need another 8 hours of work for project administration and documentation.

Based on these estimates, it would probably take about 40 hours of work to create the required packages and test and document the CentOS 7 installation procedure.

Artefactual provides development services on either a fixed fee or a time and materials basis. We offer a less expensive rate for time and materials contracts. Our rates are listed here:

https://www.artefactual.com/services/

== Alternative approaches ==

It's also possible to ship the Archivematica packages and its dependencies as container images. Docker has donated its container format and runtime to the [https://www.opencontainers.org/ Open Container Initiative]. These images are composable and they can run via the Docker or rkt container runtimes or independently via [https://github.com/opencontainers/runc runC]. Images are easily distributed via services like [https://hub.docker.com/ Docker Hub] or [https://github.com/docker/distribution Docker Distribution].

A first attempt at this approach has been published [https://hub.docker.com/r/sevein/archivematica-mcp-client-base/]. This is a docker image containing all of the dependencies of the Archivematica MCP Client package. The image is built on top of an ubuntu base image, but it can be deployed on any linux distribution, not just CentOS. Docker images can also be run on a windows host, via virtualbox on windows 8/10, and via Windows Containers on Windows Server 2016.

It is possible to produce rpm packages, that contain docker images, for example: [https://github.com/alanfranz/docker-rpm-builder].

More on Docker from RedHat: [http://developerblog.redhat.com/2014/05/15/practical-introduction-to-docker-containers/]

Improvements/CentOS-RedHat support

2016-01-31T03:47:32Z

Hakamine: /* List of Archivematica Dependencies (in Ubuntu) */

== User Story ==

As a systems administrator, I would like to be able to run Archivematica on an rpm based version of linux like CentOS or RedHat.

== Status ==

Discussion/Analysis. No code has yet been written to support this improvement.

== Interest ==

Please feel free to add your organizations name to this list, if you have an interest in this improvement.

Artefactual would like to see this improvement developed. We are able to do the development work, for a fee. We are also willing to assist others to complete all or part of the work required, in order to reduce the scope down to a level where Artefactual can complete the process as part of our existing commitment to provide new packages with each release.

== Analysis: ==

=== The Current Situation ===

Currently, Archivematica only works on LTS versions of Ubuntu (14.04 and 12.04). This is not due to any specific limitations in the Archivematica codebase, it is entirely a matter of packaging and bundling the large number of dependencies required in an Archivematica installation.

Archivematica is comprised of a set of 5 separate packages, written primarily in python. Artefactual currently builds .deb packages for Ubuntu of all 5 packages, and makes them available via launchpad (e.g, the most current stable version is at https://launchpad.net/~archivematica/+archive/ubuntu/1.4).

It is not necessary to use those .deb packages to install Archivematica. For example see these instructions for installing Archivematica using Ansible and Vagrant (https://wiki.archivematica.org/Getting_started#Installation). In that example, the 5 Archivematica packages are installed directly from github, as source, not from .deb packages. However, the longer list of external dependencies are still installed from .deb packages.

Some of those .deb packages are available in the standard Ubuntu repositories, like apache and mysql. Others, like jhove, are in the Ubuntu multiverse repository, which is not always enabled by default in Ubuntu, but is easy to enable. Others are either not available from Ubuntu repositories, or the versions available there are too old to work in Archivematica. For these packages, Artefactual has taken on the responsibility for building .deb packages, and hosting them on launchpad. There are several listed here for example https://launchpad.net/~archivematica/+archive/ubuntu/1.4, like bagit, bulk_extractor, ffmpeg and others.

==== List of Archivematica's Ubuntu Package Dependencies ====

This list is based on the packages installed by the Ansible role ( https://github.com/artefactual-labs/ansible-role-archivematica-src )

Note that it is planned to move some package based dependencies to pip ( https://github.com/artefactual/archivematica/pull/398 )

===== Installed Using Packages =====

====== Storage Service ======

- "python-lxml"
- "nginx"
- "unar"
- "uwsgi"
- "uwsgi-plugin-python"
- "python-virtualenv"
- "python-dev"
- "libxml2-dev"
- "libxslt1-dev"
- "libz-dev"
- "libffi-dev"
- "libssl-dev"

====== Pipeline (dashboard, MCP Server, MCP Client) ======

- "python"
- "python-pip"
- "python2.7-elementtree"
- "python-mimeparse"
- "python-dateutil"

- "apache2-mpm-prefork"
- "libapache2-mod-wsgi"
- "python-pip"
- "python-gearman"
- "python-simplejson"

- "dbconfig-common"
- "logapp"
- "python-pyinotify"
- "python-gearman"
- "python-mysqldb"
- "python-lxml"
- "uuid"

- "atool"
- "bagit"
- "bulk-extractor"
- "clamav"
- "clamav-daemon"
- "ffmpeg"
- "fits"
- "gearman"
- "imagemagick"
- "inkscape"
- "jhove"
- "libimage-exiftool-perl"
- "libxml2-utils"
- "logapp"
- "md5deep"
- "mediainfo"
- "nfs-common"
- "openjdk-7-jre-headless"
- "p7zip-full"
- "pbzip2"
- "postfix"
- "python-fido"
- "python-gearman"
- "python-lxml"
- "python-mysqldb"
- "python-pyicu"
- "python-unidecode"
- "readpst"
- "rsync"
- "siegfried"
- "sleuthkit"
- "tesseract-ocr"
- "tika"
- "tree"
- "ufraw"
- "unrar-free"
- "uuid"

=== RPM Support ===

This analysis is based on the use of CentOS/Redhat 7, for a port to CentOS 6, there would be more work than is outlined here.

In order to get Archivematica running on an rpm based linux distribution, a set of 5 rpm packages for the different Archivematica applications would need to be created. RPM's for about 30 different dependencies would also have to be created.

Archivematica Packages:

Archivematica Common
Dashboard
MCP Server
MCP Client
Archivematica Storage Service

optional (not all of these are currently being packaged as .debs):
MCP rpc Client
automation-tools
archivematica-devtools

Other Open Source applications required in rpm packages for Archivematica:

* atool
* bagit
* bulk_extractor
* exiftool (repoforge has this, but we want to package a specific version)
* ffmpeg
** libasound2
** jack
** openjpeg - 1.5.x is packaged, might be new enough to avoid packaging
** libraw1394 - we might be able to live without this
** libvpx
* fido
* fits
* gearman / python-gearman
* jhove
* mediainfo
* nailgun / nailgun-client
* nfs - should work without extra packages, but requires testing
* python-elementtree
* python-mimeparse
* siegfried
** go 1.4
* sleuthkit
** afflib
** libbfio
** libewf (version in repoforge is 3 years older)
* tika
* ufraw
* unar
* unidecode
* unrar-free

All of the remaining required dependencies are either included in the stock RHEL/CentOS 7 repositories, or in the third-party Repoforge repository.
(TODO: list which repo each dependency is maintained in).

Artefactual already produces Ubuntu packages for most of the packages listed here, and we have some tooling in place to automate some of this process.
See: https://github.com/artefactual-labs/am-packbuild for an example set of python scripts used to create Ubuntu packages for the 5 Archivematica packages.
(TODO: move ubuntu packaging scripts to github).

== Scope ==

Artefactual has done some analysis of the effort required, and provided quotes for this work to some institutions, at their request. Feel free to add additional comments or another piece to this section if you have more information about the possible scope of work required.

=== Artefactual Estimate ===

We have estimated that it would take about 16-20 hours to create an initial set of packages for all of the required applications.

Another 12-16 hours of testing would be required, at a minimum, to confirm that all the packages are working properly, and to do very basic tests of Archivematica on CentOS 7. Further testing would be desirable, any testing that could be done by the community would help improve the outcome of this work.

We would probably need another 8 hours of work for project administration and documentation.

Based on these estimates, it would probably take about 40 hours of work to create the required packages and test and document the CentOS 7 installation procedure.

Artefactual provides development services on either a fixed fee or a time and materials basis. We offer a less expensive rate for time and materials contracts. Our rates are listed here:

https://www.artefactual.com/services/

== Alternative approaches ==

It's also possible to ship the Archivematica packages and its dependencies as container images. Docker has donated its container format and runtime to the [https://www.opencontainers.org/ Open Container Initiative]. These images are composable and they can run via the Docker or rkt container runtimes or independently via [https://github.com/opencontainers/runc runC]. Images are easily distributed via services like [https://hub.docker.com/ Docker Hub] or [https://github.com/docker/distribution Docker Distribution].

A first attempt at this approach has been published [https://hub.docker.com/r/sevein/archivematica-mcp-client-base/]. This is a docker image containing all of the dependencies of the Archivematica MCP Client package. The image is built on top of an ubuntu base image, but it can be deployed on any linux distribution, not just CentOS. Docker images can also be run on a windows host, via virtualbox on windows 8/10, and via Windows Containers on Windows Server 2016.

It is possible to produce rpm packages, that contain docker images, for example: [https://github.com/alanfranz/docker-rpm-builder].

More on Docker from RedHat: [http://developerblog.redhat.com/2014/05/15/practical-introduction-to-docker-containers/]

Improvements/CentOS-RedHat support

2016-01-31T03:35:34Z

Hakamine: /* Installed Using Python pip = */

== User Story ==

As a systems administrator, I would like to be able to run Archivematica on an rpm based version of linux like CentOS or RedHat.

== Status ==

Discussion/Analysis. No code has yet been written to support this improvement.

== Interest ==

Please feel free to add your organizations name to this list, if you have an interest in this improvement.

Artefactual would like to see this improvement developed. We are able to do the development work, for a fee. We are also willing to assist others to complete all or part of the work required, in order to reduce the scope down to a level where Artefactual can complete the process as part of our existing commitment to provide new packages with each release.

== Analysis: ==

=== The Current Situation ===

Currently, Archivematica only works on LTS versions of Ubuntu (14.04 and 12.04). This is not due to any specific limitations in the Archivematica codebase, it is entirely a matter of packaging and bundling the large number of dependencies required in an Archivematica installation.

Archivematica is comprised of a set of 5 separate packages, written primarily in python. Artefactual currently builds .deb packages for Ubuntu of all 5 packages, and makes them available via launchpad (e.g, the most current stable version is at https://launchpad.net/~archivematica/+archive/ubuntu/1.4).

It is not necessary to use those .deb packages to install Archivematica. For example see these instructions for installing Archivematica using Ansible and Vagrant (https://wiki.archivematica.org/Getting_started#Installation). In that example, the 5 Archivematica packages are installed directly from github, as source, not from .deb packages. However, the longer list of external dependencies are still installed from .deb packages.

Some of those .deb packages are available in the standard Ubuntu repositories, like apache and mysql. Others, like jhove, are in the Ubuntu multiverse repository, which is not always enabled by default in Ubuntu, but is easy to enable. Others are either not available from Ubuntu repositories, or the versions available there are too old to work in Archivematica. For these packages, Artefactual has taken on the responsibility for building .deb packages, and hosting them on launchpad. There are several listed here for example https://launchpad.net/~archivematica/+archive/ubuntu/1.4, like bagit, bulk_extractor, ffmpeg and others.

==== List of Archivematica Dependencies (in Ubuntu) ====

===== Installed Using Packages =====

====== Storage Service ======

- "python-lxml"
- "nginx"
- "unar"
- "uwsgi"
- "uwsgi-plugin-python"
- "python-virtualenv"
- "python-dev"
- "libxml2-dev"
- "libxslt1-dev"
- "libz-dev"
- "libffi-dev"
- "libssl-dev"

====== Pipeline (dashboard, MCP Server, MCP Client) ======

- "python"
- "python-pip"
- "python2.7-elementtree"
- "python-mimeparse"
- "python-dateutil"

- "apache2-mpm-prefork"
- "libapache2-mod-wsgi"
- "python-pip"
- "python-gearman"
- "python-simplejson"

- "dbconfig-common"
- "logapp"
- "python-pyinotify"
- "python-gearman"
- "python-mysqldb"
- "python-lxml"
- "uuid"

- "atool"
- "bagit"
- "bulk-extractor"
- "clamav"
- "clamav-daemon"
- "ffmpeg"
- "fits"
- "gearman"
- "imagemagick"
- "inkscape"
- "jhove"
- "libimage-exiftool-perl"
- "libxml2-utils"
- "logapp"
- "md5deep"
- "mediainfo"
- "nfs-common"
- "openjdk-7-jre-headless"
- "p7zip-full"
- "pbzip2"
- "postfix"
- "python-fido"
- "python-gearman"
- "python-lxml"
- "python-mysqldb"
- "python-pyicu"
- "python-unidecode"
- "readpst"
- "rsync"
- "siegfried"
- "sleuthkit"
- "tesseract-ocr"
- "tika"
- "tree"
- "ufraw"
- "unrar-free"
- "uuid"

===== Installed Using Python pip =====

====== Storage Service ======
(TODO)

====== Pipeline (dashboard, MCP Server, MCP Client) ======
(TODO)

=== RPM Support ===

This analysis is based on the use of CentOS/Redhat 7, for a port to CentOS 6, there would be more work than is outlined here.

In order to get Archivematica running on an rpm based linux distribution, a set of 5 rpm packages for the different Archivematica applications would need to be created. RPM's for about 30 different dependencies would also have to be created.

Archivematica Packages:

Archivematica Common
Dashboard
MCP Server
MCP Client
Archivematica Storage Service

optional (not all of these are currently being packaged as .debs):
MCP rpc Client
automation-tools
archivematica-devtools

Other Open Source applications required in rpm packages for Archivematica:

* atool
* bagit
* bulk_extractor
* exiftool (repoforge has this, but we want to package a specific version)
* ffmpeg
** libasound2
** jack
** openjpeg - 1.5.x is packaged, might be new enough to avoid packaging
** libraw1394 - we might be able to live without this
** libvpx
* fido
* fits
* gearman / python-gearman
* jhove
* mediainfo
* nailgun / nailgun-client
* nfs - should work without extra packages, but requires testing
* python-elementtree
* python-mimeparse
* siegfried
** go 1.4
* sleuthkit
** afflib
** libbfio
** libewf (version in repoforge is 3 years older)
* tika
* ufraw
* unar
* unidecode
* unrar-free

All of the remaining required dependencies are either included in the stock RHEL/CentOS 7 repositories, or in the third-party Repoforge repository.
(TODO: list which repo each dependency is maintained in).

Artefactual already produces Ubuntu packages for most of the packages listed here, and we have some tooling in place to automate some of this process.
See: https://github.com/artefactual-labs/am-packbuild for an example set of python scripts used to create Ubuntu packages for the 5 Archivematica packages.
(TODO: move ubuntu packaging scripts to github).

== Scope ==

Artefactual has done some analysis of the effort required, and provided quotes for this work to some institutions, at their request. Feel free to add additional comments or another piece to this section if you have more information about the possible scope of work required.

=== Artefactual Estimate ===

We have estimated that it would take about 16-20 hours to create an initial set of packages for all of the required applications.

Another 12-16 hours of testing would be required, at a minimum, to confirm that all the packages are working properly, and to do very basic tests of Archivematica on CentOS 7. Further testing would be desirable, any testing that could be done by the community would help improve the outcome of this work.

We would probably need another 8 hours of work for project administration and documentation.

Based on these estimates, it would probably take about 40 hours of work to create the required packages and test and document the CentOS 7 installation procedure.

Artefactual provides development services on either a fixed fee or a time and materials basis. We offer a less expensive rate for time and materials contracts. Our rates are listed here:

https://www.artefactual.com/services/

== Alternative approaches ==

It's also possible to ship the Archivematica packages and its dependencies as container images. Docker has donated its container format and runtime to the [https://www.opencontainers.org/ Open Container Initiative]. These images are composable and they can run via the Docker or rkt container runtimes or independently via [https://github.com/opencontainers/runc runC]. Images are easily distributed via services like [https://hub.docker.com/ Docker Hub] or [https://github.com/docker/distribution Docker Distribution].

A first attempt at this approach has been published [https://hub.docker.com/r/sevein/archivematica-mcp-client-base/]. This is a docker image containing all of the dependencies of the Archivematica MCP Client package. The image is built on top of an ubuntu base image, but it can be deployed on any linux distribution, not just CentOS. Docker images can also be run on a windows host, via virtualbox on windows 8/10, and via Windows Containers on Windows Server 2016.

It is possible to produce rpm packages, that contain docker images, for example: [https://github.com/alanfranz/docker-rpm-builder].

More on Docker from RedHat: [http://developerblog.redhat.com/2014/05/15/practical-introduction-to-docker-containers/]

Improvements/CentOS-RedHat support

2016-01-31T01:26:34Z

Hakamine: /* Analysis: */

== User Story ==

As a systems administrator, I would like to be able to run Archivematica on an rpm based version of linux like CentOS or RedHat.

== Status ==

Discussion/Analysis. No code has yet been written to support this improvement.

== Interest ==

Please feel free to add your organizations name to this list, if you have an interest in this improvement.

Artefactual would like to see this improvement developed. We are able to do the development work, for a fee. We are also willing to assist others to complete all or part of the work required, in order to reduce the scope down to a level where Artefactual can complete the process as part of our existing commitment to provide new packages with each release.

== Analysis: ==

=== The Current Situation ===

Currently, Archivematica only works on LTS versions of Ubuntu (14.04 and 12.04). This is not due to any specific limitations in the Archivematica codebase, it is entirely a matter of packaging and bundling the large number of dependencies required in an Archivematica installation.

Archivematica is comprised of a set of 5 separate packages, written primarily in python. Artefactual currently builds .deb packages for Ubuntu of all 5 packages, and makes them available via launchpad (e.g, the most current stable version is at https://launchpad.net/~archivematica/+archive/ubuntu/1.4).

It is not necessary to use those .deb packages to install Archivematica. For example see these instructions for installing Archivematica using Ansible and Vagrant (https://wiki.archivematica.org/Getting_started#Installation). In that example, the 5 Archivematica packages are installed directly from github, as source, not from .deb packages. However, the longer list of external dependencies are still installed from .deb packages.

Some of those .deb packages are available in the standard Ubuntu repositories, like apache and mysql. Others, like jhove, are in the Ubuntu multiverse repository, which is not always enabled by default in Ubuntu, but is easy to enable. Others are either not available from Ubuntu repositories, or the versions available there are too old to work in Archivematica. For these packages, Artefactual has taken on the responsibility for building .deb packages, and hosting them on launchpad. There are several listed here for example https://launchpad.net/~archivematica/+archive/ubuntu/1.4, like bagit, bulk_extractor, ffmpeg and others.

==== List of Archivematica Dependencies (in Ubuntu) ====

===== Installed Using Packages =====

====== Storage Service ======

- "python-lxml"
- "nginx"
- "unar"
- "uwsgi"
- "uwsgi-plugin-python"
- "python-virtualenv"
- "python-dev"
- "libxml2-dev"
- "libxslt1-dev"
- "libz-dev"
- "libffi-dev"
- "libssl-dev"

====== Pipeline (dashboard, MCP Server, MCP Client) ======

- "python"
- "python-pip"
- "python2.7-elementtree"
- "python-mimeparse"
- "python-dateutil"

- "apache2-mpm-prefork"
- "libapache2-mod-wsgi"
- "python-pip"
- "python-gearman"
- "python-simplejson"

- "dbconfig-common"
- "logapp"
- "python-pyinotify"
- "python-gearman"
- "python-mysqldb"
- "python-lxml"
- "uuid"

- "atool"
- "bagit"
- "bulk-extractor"
- "clamav"
- "clamav-daemon"
- "ffmpeg"
- "fits"
- "gearman"
- "imagemagick"
- "inkscape"
- "jhove"
- "libimage-exiftool-perl"
- "libxml2-utils"
- "logapp"
- "md5deep"
- "mediainfo"
- "nfs-common"
- "openjdk-7-jre-headless"
- "p7zip-full"
- "pbzip2"
- "postfix"
- "python-fido"
- "python-gearman"
- "python-lxml"
- "python-mysqldb"
- "python-pyicu"
- "python-unidecode"
- "readpst"
- "rsync"
- "siegfried"
- "sleuthkit"
- "tesseract-ocr"
- "tika"
- "tree"
- "ufraw"
- "unrar-free"
- "uuid"

==== Installed Using Python pip =====

====== Storage Service ======
(TODO)

====== Pipeline (dashboard, MCP Server, MCP Client) ======
(TODO)

=== RPM Support ===

This analysis is based on the use of CentOS/Redhat 7, for a port to CentOS 6, there would be more work than is outlined here.

In order to get Archivematica running on an rpm based linux distribution, a set of 5 rpm packages for the different Archivematica applications would need to be created. RPM's for about 30 different dependencies would also have to be created.

Archivematica Packages:

Archivematica Common
Dashboard
MCP Server
MCP Client
Archivematica Storage Service

optional (not all of these are currently being packaged as .debs):
MCP rpc Client
automation-tools
archivematica-devtools

Other Open Source applications required in rpm packages for Archivematica:

* atool
* bagit
* bulk_extractor
* exiftool (repoforge has this, but we want to package a specific version)
* ffmpeg
** libasound2
** jack
** openjpeg - 1.5.x is packaged, might be new enough to avoid packaging
** libraw1394 - we might be able to live without this
** libvpx
* fido
* fits
* gearman / python-gearman
* jhove
* mediainfo
* nailgun / nailgun-client
* nfs - should work without extra packages, but requires testing
* python-elementtree
* python-mimeparse
* siegfried
** go 1.4
* sleuthkit
** afflib
** libbfio
** libewf (version in repoforge is 3 years older)
* tika
* ufraw
* unar
* unidecode
* unrar-free

All of the remaining required dependencies are either included in the stock RHEL/CentOS 7 repositories, or in the third-party Repoforge repository.
(TODO: list which repo each dependency is maintained in).

Artefactual already produces Ubuntu packages for most of the packages listed here, and we have some tooling in place to automate some of this process.
See: https://github.com/artefactual-labs/am-packbuild for an example set of python scripts used to create Ubuntu packages for the 5 Archivematica packages.
(TODO: move ubuntu packaging scripts to github).

== Scope ==

Artefactual has done some analysis of the effort required, and provided quotes for this work to some institutions, at their request. Feel free to add additional comments or another piece to this section if you have more information about the possible scope of work required.

=== Artefactual Estimate ===

We have estimated that it would take about 16-20 hours to create an initial set of packages for all of the required applications.

Another 12-16 hours of testing would be required, at a minimum, to confirm that all the packages are working properly, and to do very basic tests of Archivematica on CentOS 7. Further testing would be desirable, any testing that could be done by the community would help improve the outcome of this work.

We would probably need another 8 hours of work for project administration and documentation.

Based on these estimates, it would probably take about 40 hours of work to create the required packages and test and document the CentOS 7 installation procedure.

Artefactual provides development services on either a fixed fee or a time and materials basis. We offer a less expensive rate for time and materials contracts. Our rates are listed here:

https://www.artefactual.com/services/

== Alternative approaches ==

It's also possible to ship the Archivematica packages and its dependencies as container images. Docker has donated its container format and runtime to the [https://www.opencontainers.org/ Open Container Initiative]. These images are composable and they can run via the Docker or rkt container runtimes or independently via [https://github.com/opencontainers/runc runC]. Images are easily distributed via services like [https://hub.docker.com/ Docker Hub] or [https://github.com/docker/distribution Docker Distribution].

A first attempt at this approach has been published [https://hub.docker.com/r/sevein/archivematica-mcp-client-base/]. This is a docker image containing all of the dependencies of the Archivematica MCP Client package. The image is built on top of an ubuntu base image, but it can be deployed on any linux distribution, not just CentOS. Docker images can also be run on a windows host, via virtualbox on windows 8/10, and via Windows Containers on Windows Server 2016.

It is possible to produce rpm packages, that contain docker images, for example: [https://github.com/alanfranz/docker-rpm-builder].

More on Docker from RedHat: [http://developerblog.redhat.com/2014/05/15/practical-introduction-to-docker-containers/]

Improvements/CentOS-RedHat support

2016-01-19T22:36:56Z

Hakamine: /* RPM Support */

== User Story ==

As a systems administrator, I would like to be able to run Archivematica on an rpm based version of linux like CentOS or RedHat.

== Status ==

Discussion/Analysis. No code has yet been written to support this improvement.

== Interest ==

Please feel free to add your organizations name to this list, if you have an interest in this improvement.

Artefactual would like to see this improvement developed. We are able to do the development work, for a fee. We are also willing to assist others to complete all or part of the work required, in order to reduce the scope down to a level where Artefactual can complete the process as part of our existing commitment to provide new packages with each release.

== Analysis: ==

=== The Current Situation ===

Currently, Archivematica only works on LTS versions of Ubuntu (14.04 and 12.04). This is not due to any specific limitations in the Archivematica codebase, it is entirely a matter of packaging and bundling the large number of dependencies required in an Archivematica installation.

Archivematica is comprised of a set of 5 separate packages, written primarily in python. Artefactual currently builds .deb packages for Ubuntu of all 5 packages, and makes them available via launchpad (e.g, the most current stable version is at https://launchpad.net/~archivematica/+archive/ubuntu/1.4).

It is not necessary to use those .deb packages to install Archivematica. For example see these instructions for installing Archivematica using Ansible and Vagrant (https://wiki.archivematica.org/Getting_started#Installation). In that example, the 5 Archivematica packages are installed directly from github, as source, not from .deb packages. However, the longer list of external dependencies are still installed from .deb packages.

Some of those .deb packages are available in the standard Ubuntu repositories, like apache and mysql. Others, like jhove, are in the Ubuntu multiverse repository, which is not always enabled by default in Ubuntu, but is easy to enable. Others are either not available from Ubuntu repositories, or the versions available there are too old to work in Archivematica. For these packages, Artefactual has taken on the responsibility for building .deb packages, and hosting them on launchpad. There are several listed here for example https://launchpad.net/~archivematica/+archive/ubuntu/1.4, like bagit, bulk_extractor, ffmpeg and others.

=== RPM Support ===

This analysis is based on the use of CentOS/Redhat 7, for a port to CentOS 6, there would be more work than is outlined here.

In order to get Archivematica running on an rpm based linux distribution, a set of 5 rpm packages for the different Archivematica applications would need to be created. RPM's for about 30 different dependencies would also have to be created.

Archivematica Packages:

Archivematica Common
Dashboard
MCP Server
MCP Client
Archivematica Storage Service

optional (not all of these are currently being packaged as .debs):
MCP rpc Client
automation-tools
archivematica-devtools

Other Open Source applications required in rpm packages for Archivematica:

* atool
* bagit
* bulk_extractor
* exiftool (repoforge has this, but we want to package a specific version)
* ffmpeg
** libasound2
** jack
** openjpeg - 1.5.x is packaged, might be new enough to avoid packaging
** libraw1394 - we might be able to live without this
** libvpx
* fido
* fits
* gearman / python-gearman
* jhove
* mediainfo
* nailgun / nailgun-client
* nfs - should work without extra packages, but requires testing
* python-elementtree
* python-mimeparse
* siegfried
** go 1.4
* sleuthkit
** afflib
** libbfio
** libewf (version in repoforge is 3 years older)
* tika
* ufraw
* unar
* unidecode
* unrar-free

All of the remaining required dependencies are either included in the stock RHEL/CentOS 7 repositories, or in the third-party Repoforge repository.
(TODO: list which repo each dependency is maintained in).

Artefactual already produces Ubuntu packages for most of the packages listed here, and we have some tooling in place to automate some of this process.
See: https://github.com/artefactual-labs/am-packbuild for an example set of python scripts used to create Ubuntu packages for the 5 Archivematica packages.
(TODO: move ubuntu packaging scripts to github).

== Scope ==

Artefactual has done some analysis of the effort required, and provided quotes for this work to some institutions, at their request. Feel free to add additional comments or another piece to this section if you have more information about the possible scope of work required.

=== Artefactual Estimate ===

We have estimated that it would take about 16-20 hours to create an initial set of packages for all of the required applications.

Another 12-16 hours of testing would be required, at a minimum, to confirm that all the packages are working properly, and to do very basic tests of Archivematica on CentOS 7. Further testing would be desirable, any testing that could be done by the community would help improve the outcome of this work.

We would probably need another 8 hours of work for project administration and documentation.

Based on these estimates, it would probably take about 40 hours of work to create the required packages and test and document the CentOS 7 installation procedure.

Artefactual provides development services on either a fixed fee or a time and materials basis. We offer a less expensive rate for time and materials contracts. Our rates are listed here:

https://www.artefactual.com/services/

== Alternative approaches ==

It's also possible to ship the Archivematica packages and its dependencies as container images. Docker has donated its container format and runtime to the [https://www.opencontainers.org/ Open Container Initiative]. These images are composable and they can run via the Docker or rkt container runtimes or independently via [https://github.com/opencontainers/runc runC]. Images are easily distributed via services like [https://hub.docker.com/ Docker Hub] or [https://github.com/docker/distribution Docker Distribution].

A first attempt at this approach has been published [https://hub.docker.com/r/sevein/archivematica-mcp-client-base/]. This is a docker image containing all of the dependencies of the Archivematica MCP Client package. The image is built on top of an ubuntu base image, but it can be deployed on any linux distribution, not just CentOS. Docker images can also be run on a windows host, via virtualbox on windows 8/10, and via Windows Containers on Windows Server 2016.

It is possible to produce rpm packages, that contain docker images, for example: [https://github.com/alanfranz/docker-rpm-builder].

More on Docker from RedHat: [http://developerblog.redhat.com/2014/05/15/practical-introduction-to-docker-containers/]