Amazon Aurora Database on Amazon RDS - Alfresco Content Services - 23.4 - 23.4 - Ready - Alfresco - external - Alfresco/Alfresco-Content-Services/23.4/Alfresco-Content-Services/Configure/Databases/Amazon-RDS/Amazon-Aurora-Database-on-Amazon-RDS - 2025-07-01

Alfresco Content Services
Platform
Alfresco
Product
Alfresco Content Services
Release
23.4
License

You can configure an Aurora database on Amazon RDS for use with Content Services. Amazon Aurora is a MySQL-compatible relational database management system, and has the following prerequisites:

Note: Aurora support is only available when running in Amazon Web Services (AWS).

To configure the database:

  1. Use the ssh command to connect to the Amazon EC2 instance using a provided .ppk key.
    1. For Amazon Linux, the user name is ec2-user.
    2. For RHEL5, the user name is either root or ec2-user.
    3. For Ubuntu, the user name is ubuntu. For SUSE Linux, the user name is root.
  2. Execute sudo su to change to root.
  3. Install Content Serviceson your Amazon EC2 instance.
  4. Install the Aurora database connector.

    This release requires mysql-connector-java-x.x.x.jar for compatibility with the SQL Server database. Check the Supported Platforms page for the correct driver.

    1. Download the driver from the MySQL site at https://dev.mysql.com/.
    2. Copy the JDBC driver into the <TOMCAT_HOME>/lib directory.
  5. Install and use a database tool to connect to the Amazon RDS.
  6. Create a database named alfresco.
  7. Create a user named alfresco.
  8. Set the new user’s password to alfresco.
  9. Open the <classpathRoot>/alfresco-global.properties file.
  10. Locate the dir.root= property.
  11. Edit this to set an absolute path to point to the directory in which you want to store Content Services data. For example: dir.root=C:/Alfresco/alf_data
  12. Set and uncomment the database connection properties as shown below: 
    db.name=alfresco2
db.username=alfresco
db.password=alfresco
db.host=auroraqadb-cluster.cluster-clqevmd2v8y9.us-east-1.rds.amazonaws.com
db.port=13306
db.prefix=mysql
db.pool.max=275

# MySQL database connection

db.driver=com.mysql.cj.jdbc.Driver
db.url=jdbc:mysql://${db.host}/${db.name}?${db.params}
OR
db.url=jdbc:mysql://${db.host}:${db.port}/${db.name}?${db.params}
  13. Save the file.
  14. Restart the Content Services server.