EC2

resplin — Fri, 05 Jun 2015 23:40:44 GMT

The official documentation is at: http://docs.alfresco.com

1 Official Alfresco AMI for Amazon EC2

2 Running and Accessing the Image

3 Release Notes

Official Alfresco AMI for Amazon EC2

This is the official Alfresco 3.2 Community Edition built on Ubuntu 9.10 (Karmic Koala) and installed using the Alfresco package from the Canonical partner repository.

Alfresco has released this image to encourage developers to build cloud-ready content applications that leverage Alfresco's Enterprise Content Management (ECM) features and standard API's such as Content Management Interoperability Services (CMIS).

32 and 64-bit images now available for US and EU regions.

Running and Accessing the Image

Pre-requisites

SSH Keypair: You should already have an EC2 keypair created, if not, create one through the command-line tools or the AWS Console
Firewall Security Group Configuration: Minimally, ports 80 (HTTP) and 7070 (Sharepoint Protocol) must be opened. TCP port 22 will be useful for SSH and port 8080 for direct access to the Tomcat server (useful for development).
Instance Type Recommendation: A 'c1.medium' server is adequate for small test or development deployments. However, an m1.large instance is the minimum requirement for a production use.

Starting the Server

Simply instantiate the server image through the AWS Console or command-line tool. Please be patient, it can take about 5-10 minutes to start up completely. Once that happens, point your browser to the external IP or public DNS name of your new instance. A welcome screen will direct you to the Alfresco Explorer or Alfresco Share user interfaces.

The default Alfresco login is: admin

The default Alfresco password is: admin

IMPORTANT SECURITY NOTICE: Please change the Alfresco and MySQL password as soon as possible. The Alfresco password can be changed from the Alfresco Explorer UI while the MySQL password needs to be changed by connecting to the server via SSH. See 'Database Details' below.

SSH Details

These Ubuntu-based images require that you SSH as the 'ubuntu' user, not as 'root'.

$ ssh ubuntu@<EC2_PUBLIC_DNS> -i <EC2_SSH_KEY>

Starting and Stopping Alfresco and MySQL

You can use the service manager to start and stop Tomcat and MySQL:

$ sudo service tomcat6 [stop | start | restart]
$ sudo service mysql [stop | start | restart]

Important File Locations

Tomcat: /usr/share/tomcat6

Tomcat JAVA_OPTS Overrides: /etc/default/tomcat6

Alfresco WAR Files: /usr/share/tomcat6/webapps

Alfresco Config Files: /usr/share/tomcat6/shared/classes

Log Files: /var/log/tomcat6

Alfresco Content Store and Indexes: /var/lib/alfresco

MySQL Data: /var/lib/mysql

Database Details

IMPORTANT SECURITY NOTICE: The passwords for both the MySQL 'root' and 'alfresco@localhost' users is 'alfresco'. Please change them and edit the password in /usr/share/tomcat6/shared/classes/alfresco-global.properties

Using EBS Volumes

Eventually, the images will support auto-attaching and mounting of volumes. In the interim, to use an EBS volume, you must do the following:

Shutdown both Alfresco and MySQL as noted above.
Create an EBS volume of at least 10GB. This volume must exist in the same Availability Zone as the Alfresco server instance.
Attach the EBS volume to your Alfresco server instance.
Format and mount the EBS volume to /vol or some other location. Tips on formatting and mounting EBS volumes may be found at: http://developer.amazonwebservices.com/connect/entry.jspa?categoryID=100&externalID=1663
Configure MySQL to use the new storage volume by editing /etc/my.cnf
Change the Alfresco dir.root location to the new volume by editing /usr/share/tomcat6/shared/classes/alfresco-global.properties
Copy MySQL data files and Alfresco content store to new volume location.
Edit /etc/apparmor.d/usr.sbin.mysqld to reflect the new location of the mysql data directory
Reboot the server
Start and test MySQL
Start and test Tomcat / Alfresco

More detailed instructions will be provided at a later time.

topic EC2 in Alfresco Archive

EC2

Table of Contents