Install Alfresco On Ubuntu Server Desktop

Ubuntu Server is meant to be a server. If you want a desktop use regular(X)ubuntu, and add the Apache/Nginx or whatever. If this is a VPS, the software sources could be pointing to the provider's repo without any desktop stuff and you'll have to add another repo. OTOH I manage my server through a GUI. On my local machine.

Install Alfresco On Ubuntu Server Desktop Windows 10
Ubuntu Server Desktop Install
Ubuntu Server Gui

Alfresco script based install for Ubuntu servers.

This script will help you set up an Alfresco server instance with all necessary third party components.
Some will be installed via Ubuntu packages, some directly downloaded. The script will walk you through the process. In the end, there will be some manual tasks to complete the installation.

Alfresco does have installers for Linux, and you may be better off with using those installers if you just want to do a quick test install. However, if you intend to run Alfresco in production, this script can help you both with the install, and by examine what the script does, learn what components are involved running an Alfresco instance. Any Alfresco administrator will have to learn that if you intend to use Alfresco in production.

Installing

To start the install, in Ubuntu terminal run

curl -O https://raw.github.com/loftuxab/alfresco-ubuntu-install/master/alfinstall.sh
chmod u+x alfinstall.sh
./alfinstall.sh

All install options will be presented with an introduction. They default to 'n' (no), so type y to actually install that component. You need sudo access to install.

But please do read all of this README before you go ahead.
There is also lots of documentation at http://docs.alfresco.com/4.2/index.jsp. To become an Alfresco server Administator, read the 'Administering' section.

Install alfresco on ubuntu server desktop experience

Once downloaded you can modify (if needed) the script to fit your purpose. Here is a brief explanation if each section.

Alfresco User

The Alfresco user is the server account used to run tomcat. You should never run tomcat as root, so if you do not already have the alfresco (default in the install script) user, you should add the alfresco user.

In this part of the install is also an update to make sure a specific locale is supported (default sv_SE.utf8). This is useful for LibreOffice date formatting to work correctly during transformations.

Limits

Ubuntu default for number of allowed open files in the file system is too low for alfresco use and tomcat may because of this stop with the error 'too many open files'. You should update this value if you have not done so. Read more at http://wiki.alfresco.com/wiki/Too_many_open_files.

Tomcat

Tomcat is the java application server used to actually run Alfresco. The script downloads the latest version of Tomcat 7, and then updates its configuration files to better support running Alfresco.
Ubuntu upstart is used to stop and start tomcat. You must have a look and verify settings in the alfresco upstart file
/etc/init/alfresco.conf
Edit locale setting (LC_ALL) and the memory settings in this file to match your server.
About memory, it has default max set to 2G. That is good enough if you have about 5 users. So add more ram (and then some) to your server, update then Xmx setting in alfresco.conf. Your Alfresco instance will run much smoother.

You will be presented with the option to add either MySql or Postgresql jdbc libraries. You should probably add at least one of them.

Once the install is complete (the entire script and the manual steps following that), run
sudo service alfresco start to start and sudo service alfresco stop to stop tomcat.

Nginx

It is sometimes useful to have a front-end for your Tomcat Alfresco instance. Since Tomcat runs default on port 8080, you can use Nginx as proxy. It is also a lot easier to add ssl support. The default config includes sample configuration for this. Share resource files (anything loaded from /share/res/) is cached in nginx, so it doesn't need to be fetched from tomcat.

The script will use the latest version of the Ubuntu package from Nginx instead of default Ubuntu nginx packages. This allows for spdy support, sample config for this is included (you need an ssl certificate for this).

Caveat: The upload progress bar in Share will show the upload as complete when the upload from client to nginx is complete, but the upload from nginx to Tomcat Share/Alfresco continues shortly. Usually this is barely noticeable, since server connections speeds are a lot faster than client server connections.

Java JDK

Install OpenJDK. You may want to use Oracle Java, but download and install of Oracle Java could not be scripted. If you choose to use Oracle Java, adjust paths setting in /etc/init/alfresco.conf.

LibreOffice

Downloads and install LibreOffice from libreoffice.org (technically from a mirror). Alfresco just use LibreOffice for transformations, and later versions have better (hopefully) conversion filters.In this step ImageMagick is also installed from Ubuntu standard packages, if you skip this step install ImageMagick separately. Some extra font packages like Microsoft true type fonts is also installed, since you likely will add documents to Alfresco that have used them, this will result in better transformations.

Swftools

Downloaded and compiled. Since it is compiled locally the script first installs tools for compiling using standard Ubuntu packages.

ImageMagick

Installed using the Ubuntu default package.
If you get the error no decode delegate for this image format on start in the alfresco.log make sure to check that the path for img.coders= in alfresco-global.properties. The path may be version specific for the installed version.

Alfresco

Download and install of Alfresco itself. Or rather, the alfresco.war and share.war and adds them to tomcat/webapps folder. Current version is 4.2.c.You also have the option to install Google Docs and Sharepoint addons. Skip if you do not intend to use them, you can always add then later.You can completely skip this step if you intend to use Enterprise version or any other version. See also the special section about the addons directory.

Solr

You have a choice lucene (default) or Solr as indexing engine. Solr runs as a separate application and is slightly more complex to configure. As Solr is more advanced and handle multilingual better it is recommended that you install Solr.If you choose to use Solr, remember to update default indexing engine (currently lucene) in alfresco-global.properties.

A special directory is created, /opt/alfresco/addons. This directory can be used to manage any addons and the core war files.

addons/alfresco - Alfresco amp files.
addons/share - Share amp files.
addons/war - alfresco.war and share.war files goes in here.
The script addons/apply.shis what you run to install amp files to war files, and then copy the war files to tomcat/webapps. The script has three parameter options
amp - just install the amp files to war files.
copy - Copy war files to tomcat/webapps.
all - Do both of the above. You can only do this if tomcat is not running.

If you didn't install Alfresco war files with the install script you can use this script to manage your war files. If you for example want to use the Enterprise version, download the war files from Alfresco support portal and add them to the /war directory and the run apply.sh. Or you can always add them directly to tomcat/webapps.

In the directory /opt/alfresco/scripts there are some useful scripts installed. Or if you did not run the install script, grab them from github. Here is what they do:

libreoffice.sh - Start/stop libreoffice manually. Sometimes libreoffice crashes during a transformation, use this script to start it again. Alfresco will re-connect when the server detects libreoffice is running. You can add this to crontab for automatic checks:
*/10 * * * * /opt/alfresco/scripts/libreoffice.sh start 2>&1 >> /opt/alfresco/logs/office.log0 2 * * * /opt/alfresco/scripts/libreoffice.sh restart 2>&1 > /opt/alfresco/logs/office.logThis will make sure libreoffice is running (if not already started and tomcat is running). Once per night it will also do a complete restart (in case LibreOffice behaves badly).
iptables.sh - Script to add port forwarding. Useful if you want to use cifs, ftp that will not run on lower port numbers if not root. Or if you´re not using nginx as front end and want to forward port 80 to 8080.
limitconvert.sh - Script to limit the number of cpu:s ImageMagick convert can use during transformations. Some Document library views with large thumbnails can cause intensive transformation load, and this script make sure some resources are left for other work.
createssl.sh - Create self signed certificates, useful for testing purposes. Works well with nginx.
mariadb.sh - Install the mariadb database server (the MySql alternative). It is recommended that you instead use a dedicated database server. Seriously, do that. And do some database optimizations, out of scope for this install guide.
postgresql.sh - Same as for MariaDB, but the postgres version.

Can this script be used for any version of Alfresco?

Yes, see the Addon section. But do know that it uses latest version of many components, and they may not be Alfresco officially supported stack.Can I modify the scripts?

Yes, you can either download the install script and modify as needed. Or you clone the entire thing at Github and create your own version. If you create/change anything that you think may be useful, please contribute back.Upgrading - Can I use this to upgrade an existing install?

At this time, this is not the intended use. So short answer is no.
Longer answer is, you can probably grab pieces of the script to upgrade individual components. Or as is recommended when upgrading, test your upgrade on a separate server. So install a new server with fresh install, then grab a copy of your data and do a test upgrade. If this works, switch to this server. Did you make a backup of your data first?I want Alfresco and Share on separate server, can this script be used?

Yes (and is also recommended for best performance), but all components are not needed on both servers. The Alfresco server probably doesn't need nginx, the Share server doesn't need LibreOffice, Swftools and Solr. The 'Alfresco' install step will download both alfresco.war and share.war if run, just remove the one that doesn't apply from tomcat/webapps and addons/war directory.The script does not use version x of component z, can you fix this?

Probably, but you can also. Just edit the script with the version you want to use, most of the specific links can be found in the beginning of the script.
Why does the script use the latest versions/not use Ubuntu packages?