This post will provide information about the Multi-tenancy functionality of Alfresco Enterprise 3.0. I have decided to make this article because currently, I have been researching for this feature for a project requirement. I decided to divide this in several parts like enabling, creating, exporting and importing a tenant. Now, let’s get started!
The Multi-Tenancy Feature enables Alfresco to run in a single-instance (meaning using only one Alfresco WAR, DB and same port) multi-tenant environment. So how is it enabled, below are the steps:
1. If it is your first time to run Alfresco(clean DB and alf_data), I suggest you run it first. (Because for some reason, I can not access the tenant admin console if I enable it here).
2. Stop Alfresco.
3. Locate the three files below located at tomcat/shared/classes/alfresco/extension/mt directory :
4. Rename the files:
- mt-context.xml.sample -> mt-context.xml
- mt-admin-context.xml.sample ->mt-admin-context.xml
- mt-contentstore-context.xml.sample -> mt-contentstore-context.xml
5. Restart Alfresco.
6. Open tenant admin console (http://localhost:8080/alfresco/faces/jsp/admin/tenantadmin-console.jsp). If you are able to access this page, multi-tenancy is enabled.
Now that multi-tenancy is enabled, you are now ready to create your first tenant. Below are the steps:
1. Log in as super admin
2. Open tenant admin console
3. Enter command to create tenant:
create <tenant domain> <tenant admin password> <root contentstore dir>
Ex: create tenanta admina C:\Alfresco\alf_data\tenantstore\a
The above command will create a tenant tenanta with an administrator password admina
4. When creation is successful, you can login as tenant by accessing the login page of Alfresco and typing:
Username : admin@tenanta
You can now create spaces, content and users inside your tenant. Enjoy!=)