The Repository Admin Console application gives you control over the management and settings of the Content Services environment.
You’ll find help text on the Admin Console pages to assist you with setting up the repository. See how to launch the Admin Console directly.
The Admin Console is a standalone console for managing the administration of the repository.
The Admin Console is a tool comprising separate pages that identify a particular administrative activity or feature:
- System Summary: Viewing the System Summary
- Email Services:
- Repository Services:
- Activities Feed: Configuring the Activities Feed
- Repository Server Clustering: Managing members of a cluster
- Search Service Sharding: Configuring sharding using the Admin Console
- Process Engines: Enabling workflow process engines
- Query Accelerator: View and manage query set configuration files
- Replication Service: Enabling the Replication Service
- Search Service: Configuring Search Services using Admin Console
Subscription Service: Enabling the Subscription Service
Note: Use Repository Services to manage individual repository servers. This function can’t be accessed through a load balancer.
- Support Tools:
- Directory Management: Managing authentication directories
- Virtual File Systems:
The links provide more information on configuring these activities.
You can use the Admin Console as your main tool to help you manage your production environment. It is a simple alternative to using a JMX console, or manually setting properties in the
The settings that you choose in the Admin Console take precedence over any setting that you add in the
Launch Admin Console
The Repository Admin Console runs externally to the user interface and therefore you launch the application independently. This allows you to run the Admin Console without the need to run Alfresco Share.
Ensure that the Content Services server is running.
Enter the following URL in a browser window:
<your-host-name>is the host name where you’re running the Content Services server and
<alfresco-port>is the port number on which the server is running (by default, the port number is
An Authentication Required prompt displays, showing the IP address or name and the port number of the server.
Enter your user name and password.
Your user name and password must be for an account with administrator permissions. The default administrator user name and password is
The Admin Console displays in a browser window. The title bar shows the host name and its IP address.
You will remain logged into the Admin Console for the duration of the browser session. If you close the browser window completely and then connect to the Admin Console using the URL, you’ll be prompted to enter your account details again.
A useful starting point in the Admin Console is the System Summary page, which gives an overview of which settings are enabled or disabled.
View System Summary
System Summary in the Admin Console shows an overview of the status of the repository, including the general system information, subsystem status, clustering settings, the current authentication chain, and details of which AMPs are applied to the system.
There are no actions or entry fields on the System Summary page. This page is a high-level overview of the setting you’ve chosen or are set as default on the repository.
The overview is divided into the following sections:
- System information
- File Systems
- Indexing Subsystem
- Repository Clustering
- Activities Feed
- Auditing Services
- Content Stores
- Alfresco Module Packages (AMPs)
- Users and Groups
The System Information summary shows the general details of the installation. This information is useful for confirming the installation details, Java installation details, the host operating system specification and memory details.
The File Systems summary shows the settings from the File Servers page. See Enabling File Servers for more information.
The Indexing Subsystem summary shows the settings from the Search Service page. See Configuring Search Services for more information.
The Repository Clustering summary shows the settings from the Repository Server Clustering page. See Repository Server Clustering for more information.
The Activities Feed summary shows the settings from the Activities Feed page. See Setting the Activities Feed for more information.
The Authentication summary shows the settings from the Directory Management page, in particular, the current authentication chain. See Managing authentication directories for more information.
The Email summary shows the settings from the Inbound Email and Outbound Email pages. See Managing inbound and outbound emails for more information.
The Auditing Services summary indicates the status of auditing in Content Services.
The Content Stores summary lists the location of the default content stores.
The Module Packages summary identifies which modules have been applied to this instance of Content Services.
Users and Groups
The Users and Groups summary shows the number of individual users and groups within the system.
View Repository Information
Repository Information in the Admin Console shows details of the repository as it was originally installed. It also shows the current Content Services version.
Open the Admin Console.
In the General section, click Repository Information.
You see the Repository Information page showing the details of your installation.
Customize Admin Console
The Admin Console displays the most common administration activities. You can customize the Admin Console to show different options, properties, and layout, or you can create completely new pages. The Admin Console is composed of default administration pages. Each Admin Console page is a simple web script component built from a library of useful functions and macros that are imported into each Admin Console web script.
If no additional processing logic is required, the web script library functions automatically persist them back to the correct property.
JMX form-style pages are simple to build. Example pages that you can create include: Thread Dump, Active Sessions, Log4J settings, and Test Transforms.
Admin Console example page
When you customize the Admin Console, you can use the example page as a starting point.
The Admin Console example page is called
admin-example and contains comments to help you to understand the code.
The files that you use for working with the example Admin Console page are:
See the Web script components section for more information on these files.
There are also additional properties files that contain the associated strings for localized content in the supported languages.
The following snippet shows the controller code from the
admin-example.get.js file, which retrieves the
RemainingDays properties from the
License JMX bean:
<import resource="classpath:alfresco/enterprise/webscripts/.../admin-common.lib.js"> /* Repository Admin Console - Example GET method */ Admin.initModel( "Alfresco:Name=License", ["Subject", "Issued", "RemainingDays"], "admin-example" );
The following snippet shows the template code from the
<#include "admin-template.ftl" /> <@page title="Example Page"> <div class="column-left"> <@section label="Some Values" /> <@control attribute=attributes["Subject"] /> </div> <div class="column-right"> <@section label="More Values" /> <@control attribute=attributes["Issued"] /> <@control attribute=attributes["RemainingDays"] /> </div> </@page>
The resulting output from the
admin-example web script displays the following:
The values from the License JMX bean are read-only. The template macros understand when the JMX beans are read-only, and therefore, display the text as read-only.
When the JMX beans are editable or if you want to show a different form field, add the following line to change the template:
<@attrtext attribute=attributes["Subject"] />
The resulting output then displays the following: