You can install the third-party software used by Community Edition independently. Some of the software can be installed any time before or after installing Community Edition.
Install LibreOffice
In Community Edition, you can transform a document from one format to another, for example, a text file to a PDF file. To access these transformation facilities, you must install LibreOffice. This is optional, and can be done any time after Community Edition is installed.
-
Browse to the LibreOffice download site.
-
Download the latest (stable) version of LibreOffice for your platform.
-
When prompted, specify a download destination.
-
Browse to the location of your downloaded file, and install the application.
-
Change the installation directory to:
- (Windows)
c:\Alfresco\LibreOffice
- (Linux)
/opt/alfresco/LibreOffice
If you’re installing LibreOffice on Linux, you also need a number of libraries to be installed. See Install Linux libraries for more.
- (Windows)
-
Modify the
jodconverter.officeHome
property in the<classpathRoot>/alfresco-global.properties
file to point to the LibreOffice install location.Note: For Windows, set the path using the
\\
separator, or use the forward slash/
Unix path separator. For example:c:\\Alfresco\\LibreOffice
orc:/Alfresco/LibreOffice
. -
If the Community Edition server is running, stop and restart the server.
Install Linux libraries
Use this information to install Linux libraries manually on supported Linux distributions, such as Ubuntu, SUSE and Red Hat.
LibreOffice requires the following libraries to be installed on your system:
- libfontconfig
- libICE
- libSM
- libXrender
- libXext
- libXinerama
- libcups
- libGLU
- libcairo2
- libgl1-mesa-glx
If the required libraries are missing, you’ll get a warning message. You can install them using your preferred package manager from the command line. Note that the file names for the Linux libraries may vary by distribution.
For Red Hat Enterprise Linux/CentOS, you can run:
cd <libre-install-dir>/LibreOffice_*.*.*.*_Linux_x86-64_rpm/RPMS/
sudo yum localinstall *rpm
For Ubuntu:
cd <libre-install-dir>/LibreOffice_*.*.*.*_Linux_x86-64_rpm/RPMS/
sudo dpkg -i *deb
If LibreOffice doesn’t start up normally with Community Edition, test it manually, for example, by running this startup script:
start ex. {installdir}/libreoffice/scripts/libreoffice_ctl.sh start
status ex. {installdir}/libreoffice/scripts/libreoffice_ctl.sh status
If you receive errors that indicate that a library is missing, work with your system administrator to add the missing library or its equivalent from your configured repositories.
Install ImageMagick
To enable image manipulation in Community Edition, you must install and configure ImageMagick. Community Edition uses ImageMagick to manipulate images for previewing.
-
Verify that ImageMagick is already installed on your system.
Use the ImageMagick convert command to check that you have the right software installed on your machine. This command is usually located in
/usr/bin
:install Image
. -
If the ImageMagick software isn’t available on your system, download and install the appropriate package for your platform.
To download ImageMagick, browse to the ImageMagick download website.
Note: In next steps, you’ll make changes to the Community Edition configuration files to enable the manually installed ImageMagick application. These steps can only be performed after Community Edition has been installed.
-
Browse to the
<classpathRoot>
directory. -
Open the
alfresco-global.properties
file. -
Modify the ImageMagick properties to point to the ImageMagick root directory.
Property Description img.root Windows: img.root=C:\\ImageMagick
Linux:img.root=/ImageMagick
Note: Don’t include a slash (/
) at the end of the path, i.e./ImageMagick/
.img.dyn Windows: img.dyn=${img.root}\\lib
Linux:img.dyn=${img.root}/lib
img.exe Windows: img.exe=${img.root}\\convert.exe
Linux:img.exe=${img.root}/bin/convert
img.coders Windows: img.coders=${img.root}\\modules\\coders
Linux:img.coders=${img.root}/modules/coders
img.config Windows: img.config=${img.root}\\config
Linux:img.config=${img.root}/config
img.url Windows: img.url=${img.root}\\url
Linux:img.url=${img.root}/url
Note: Test that you’re able to convert a PDF using the command:
convert filename.pdf[0] filename.png
Install alfresco-pdf-renderer
Community Edition uses alfresco-pdf-renderer
for creating document thumbnails and previews. Use this information to install alfresco-pdf-renderer
on your system.
Note: To use the
alfresco-pdf-renderer
, ensure that Community Edition is installed. Changes made to thealfresco-global.properties
file in your installation will change the configuration and enable you to manually install thealfresco-pdf-renderer
application.
Note: The
alfresco-pdf-renderer
executable file is platform-specific.
The alfresco-pdf-renderer
binaries are available in the Community Edition distribution zip.
- For Windows:
- Extract the file
alfresco-pdf-renderer/alfresco-pdf-renderer-1.0-win64.tgz
to a location of your choice. - Browse to the location of your saved file and extract the archive.
-
Add the following properties to the
alfresco-global.properties
file:alfresco-pdf-renderer.root=<alfresco-pdf-renderer_installation_dir> alfresco-pdf-renderer.exe=${alfresco-pdf-renderer.root}/alfresco-pdf-renderer alfresco-pdf-renderer.url=http://localhost:8090/
- Extract the file
- For Linux:
- Extract the file
alfresco-pdf-renderer/alfresco-pdf-renderer-1.0-linux.tgz
to a location of your choice. - Browse to the location of your saved file and extract the archive.
-
Add the following properties to the
alfresco-global.properties
file:alfresco-pdf-renderer.root=<alfresco-pdf-renderer_installation_dir> alfresco-pdf-renderer.exe=${alfresco-pdf-renderer.root}/alfresco-pdf-renderer alfresco-pdf-renderer.url=http://localhost:8090/
- Extract the file
Note: Use the
alfresco-pdf-renderer.url
property when runningalfresco-pdf-renderer
remotely. If you’re runningalfresco-pdf-renderer
locally, then you don’t need to set this property.
Language support
Translations in Community Edition use language packs. The supported language packs are:
- English (en)
- German (de)
- Spanish (es)
- French (fr)
- Italian (it)
- Japanese (ja)
- Dutch (nl)
- Norwegian - Bokmål (nb)
- Russian (ru)
- Brazilian Portuguese (pt_BR)
- Simplified Chinese (zh_CN)
The language used switches according to the browser locale. Ensure that your browser is set up to view the relevant locale, which ensures that the special characters display correctly in your installed instance.
The source-localized files are encoded in ASCII, and the special and accented characters are displayed using escape sequences. The source files have been renamed using the corresponding locale for each language. For example, site-welcome.properties
is called sitewelcome_ fr.properties
for the French version.
Although the interface is localized, the following components have not been localized, therefore, any strings originating from these components will be displayed in English.
- SharePoint
- LibreOffice
The following files are not localized and the error messages remain in English to ease searching for fixes to issues.
content-service.properties
dictionary-messages.properties
module-messages.properties
patch-service.properties
repoadmin-interpreter-help.properties
schema-update.properties
system-messages.properties
(partially translated)tenant-interpreter-help.properties
version-service.properties
webclient-config-admin-interpreter-help.properties
workflow-interpreter-help.properties
control.properties
(inremote-api
directory)
Install integrations
Use this information to review the components or modules that integrate Community Edition with other applications.
Integrations
Integrations | Notes |
---|---|
Search Services | |
Office Services | |
Google Docs Integration |
Test installation
Installation testing checks that Community Edition is successfully installed and it’s working as expected after installation.
Some of the points that need to be checked prior to testing your installation are:
- Verify that, after a successful install, the application works as expected and meets user needs.
- On uninstall, check that all previously installed files and registry entries are removed as expected.
Post-installation checks
Once you’ve successfully installed Community Edition, test and gain familiarity with the core features and functions.
Here are some tips to familiarize yourself.
Note: We recommend that you create a test site for testing purpose and put all your test data in that site.
- Can you login using your user name and password. See Logging in.
- Can you create a site. See Creating a new site.
- Can you add new users to the site. See Adding users to a site.
- Can you add pages to the site. See Adding pages to a site.
- Can you add content to a site library. See Adding content items.
- Can you copy or move content from its current location to another folder or any other site. See Copying content and Moving content.
- Can you update content. See Updating content.
- Can you manage permissions for a user or a group for accessing content. See Managing content permissions.
- Can you add a new rule to a folder in the site library and check if it works. See Adding a new rule.
- Can you schedule events, such as meeting, for your team. See Scheduling events.
Start and stop server
Use this information to run the Community Edition server and Alfresco Share.
Start server
Once you’ve installed Community Edition using the distribution zip, you can start the server. The server must be running before you can use Alfresco Share.
-
Navigate to the installation directory for your database and start the server.
-
Navigate to the Tomcat
/bin
directory and start the server:For example: (Linux)
./startup.sh
For example: (Windows)
startup
You need administrator rights to run this command.
-
Browse to the location of your Community Edition installation:
For example,
http://<your-host>:8080/alfresco
.
Stop server
Use this information to stop the server.
-
Navigate to the Tomcat
/bin
directory then choose one of these options to stop the server:For example: (Linux)
./shutdown.sh
For example: (Windows)
shutdown
You need administrator rights to run this command.
-
Navigate to the installation directory for your database and stop the server.
Start Alfresco Share
Once you’ve started Community Edition, you can start Alfresco Share using a browser.
-
Browse to the location of your installation.
For example,
http://<your-host>:8080/share
.Alfresco Share opens in a browser.
-
Sign in using a user name and password.
The default administrator user name is
admin
.