mirror of
https://github.com/Alfresco/alfresco-sdk.git
synced 2025-05-12 17:05:08 +00:00
b1139739b8
* Improved the readability of the pom.xml * Introduced 7.1 + upgrade others to the latest version * Handled the new Share's versions separation * Use a variable to set the user in the Dockerfile * Final versions * Updated README [ci skip] * Fixed the broken URL to the new one * Wildcard on the version to prevent further useless updates Co-authored-by: gfertuso <giovanni.fertuso@alfresco.com>
88 lines
3.5 KiB
Markdown
88 lines
3.5 KiB
Markdown
---
|
||
Title: Switching Alfresco Content Services and Share versions
|
||
Added: v3.0.0
|
||
Last reviewed: 2021-02-09
|
||
---
|
||
# Switching Alfresco Content Services and Share versions
|
||
|
||
The latest version of the Alfresco SDK supports different versions for Alfresco Content Services and Alfresco Share. Since each product is no longer
|
||
released under one common version number, ACS (i.e. alfresco.war) and the Share UI (share.war) are now released with individual version numbers.
|
||
|
||
By default, SDK 4.x is configured to generate projects using the most recent version of ACS and Share. You can easily change one (or both) versions by
|
||
simply updating the `pom.xml` file in your project. The compatibility of these versions is up to you, however you should check in advance the right versions
|
||
to use.
|
||
|
||
When editing `pom.xml` you will see a number of properties that define the Alfresco Content Services platform version and the Alfresco Share version, such as:
|
||
|
||
```
|
||
<alfresco.platform.version>7.0.0-A20</alfresco.platform.version>
|
||
<alfresco.share.version>7.0.0-M3</alfresco.share.version>
|
||
```
|
||
|
||
Before continuing, always remember to start from a newly generated SDK project before changing the version numbers. We do not recommend changing the versions
|
||
using developed customizations or source code.
|
||
|
||
This article is focused on the Community version. If you want to switch to Alfresco Enterprise, please visit [Working with Enterprise](working-with-enterprise/README.md).
|
||
|
||
The supported versions are explained in the next sections of this article.
|
||
|
||
## Switch to Alfresco version 6.0.x
|
||
|
||
Starting from a newly created Alfresco SDK 4.x project (All-In-One, Platform JAR, or Share JAR), let’s replace the two properties with the following ones.
|
||
|
||
1. Open the pom.xml in your generated project.
|
||
|
||
2. Replace the properties with the following:
|
||
|
||
```
|
||
<alfresco.platform.version>6.0.7-ga</alfresco.platform.version>
|
||
<alfresco.share.version>6.0.c</alfresco.share.version>
|
||
```
|
||
|
||
In this example we have shown the switch to version 6.0.7-ga. Feel free to use the correct version for your project, paying attention to the compatible versions
|
||
of Alfresco Content Services and Alfresco Share.
|
||
|
||
3. After changing the versions, delete all the previous data of your development Docker environment:
|
||
|
||
```
|
||
$ ./run.sh purge
|
||
```
|
||
|
||
4. Rebuild and restart the project:
|
||
|
||
```
|
||
$ ./run.sh build_start
|
||
```
|
||
|
||
**IMPORTANT:** Alfresco 6.1+ is ready to work with JDK 11, but Alfresco 6.0 needs to be compiled and run using JDK 8, so please take this into account when you
|
||
switch from version 6.1+ to 6.0.x. If you compile Alfresco 6.0.x with JDK 11 you'll experience the issue described in the [Troubleshooting page](../troubleshooting.md)
|
||
about wrong JDK versions.
|
||
|
||
## Switch to Alfresco version 6.1.x or 6.2.x
|
||
|
||
Starting from a newly created Alfresco SDK 4.x project (All-In-One, Platform JAR, or Share JAR), let’s replace the two properties with the following ones.
|
||
|
||
1. Open the pom.xml in your generated project.
|
||
|
||
2. Replace the properties with the following:
|
||
|
||
```
|
||
<alfresco.platform.version>6.1.2-ga</alfresco.platform.version>
|
||
<alfresco.share.version>6.1.0-RC3</alfresco.share.version>
|
||
```
|
||
|
||
In this example we have shown the switch to version 6.1.2-ga. Feel free to use the correct version for your project, paying attention to the compatible versions
|
||
of Alfresco Content Services and Alfresco Share.
|
||
|
||
3. After changing the versions, delete all the previous data of your development Docker environment:
|
||
|
||
```
|
||
$ ./run.sh purge
|
||
```
|
||
|
||
4. Rebuild and restart the project:
|
||
|
||
```
|
||
$ ./run.sh build_start
|
||
```
|