Skip to content

Commit

Permalink
[DOCS-7560] Alfresco Content Services 23.2 (#1383)
Browse files Browse the repository at this point in the history
* [DOCS-7560-Content-Services-23.2] Update Alfresco Content Services 23.x

* [DOCS-7560-Content-Services-23.2] Update Alfresco Content Services 23.x

* Add files via upload

* [DOCS-7560-Content-Services-23.2] Update image ACS Upgrade 23.x

* [DOCS-7560] Update Community Edition 23.2 for ACS 23.2

* [DOCS-7561] Update Alfresco Content Services Support Platforms 23.2 (#1345)

* [DOCS-7561-content-services-support-23.2] Update ACS 23.2 Supported Platforms

* [DOCS-7561-content-services-support-23.2] Update ACS Supported Platforms 23.2

* Update supported platforms for ACS 23.x

* Update Connector for Azure 5.0

* [DOCS-7550] Add Control Center 8.4 compatibility for ACS 23 (#1361)

* [DOCS-7587] Update Supported Platforms page for Transform Service 4.1 (#1347)

* [DOCS-7587] Update Supported Platforms page

* [DOCS-7587] Update Supported Platforms page

* [DOCS-7439] Update supported platforms for ACA 4.0 (#1354)

* Add Alfresco Enterprise Viewer 4.0

* [DOCS-7391] Update supported platforms for Outlook Integration 3.0

* [DOCS-7591][DOCS-7592] Add compatibility for SAP Connector 6.0.1 (#1365)

* [DOCS-7555] Add compatibility for Salesforce Connector 3.1 with ACS (#1367)

* [DOCS-7587] Add ATS 4.0 compatibility back into ACS 23.1 table (#1373)

* [DOCS-7600] Fix AIS compatibility for ACS 23.x (#1374)

* [DOCS-7530] Add Federation Services 3.1 compatibility for ACS 23.x (#1375)

* [DOCS-7577][DOCS-7444] Add Alfresco SDK 4.x compatibility (#1377)

* [DOCS-7536] Update Supported Platforms for SAP Cloud Connector 2.0 (#1379)

* [DOCS-7536] Update Supported Platforms for SAP Cloud 2.0
* [DOCS-7536] Update Supported Platforms for SAP Cloud 1.2.1

* [DOCS-7586] Update Supported Platforms for AWS S3 Connector 6.1 (#1380)

* [DOCS-7598] Update Supported Platforms for AOS 3.0 (#1381)

* [DOCS-7561] Update AGS 23.2 for ACS 23.2 and ADW 4.4 for ACS 23.x

* [DOCS-7581] Update Supported Platforms for Google Docs Integration 4.1 (#1382)

Co-authored-by: Adelaide Nxumalo <27953420+anxumalo@users.noreply.github.com>

* [DOCS-7524] Minor fix for APS

---------

Co-authored-by: Adelaide Nxumalo <27953420+anxumalo@users.noreply.github.com>
Co-authored-by: Monika Rutkowska <153922997+monikarutkowska@users.noreply.github.com>
Co-authored-by: MateuszTomaska <115556670+MateuszTomaska@users.noreply.github.com>

---------

Co-authored-by: Adelaide Nxumalo <27953420+anxumalo@users.noreply.github.com>
Co-authored-by: Monika Rutkowska <153922997+monikarutkowska@users.noreply.github.com>
Co-authored-by: MateuszTomaska <115556670+MateuszTomaska@users.noreply.github.com>
  • Loading branch information
4 people authored Mar 7, 2024
1 parent 8bba7b6 commit 7e04d81
Showing 12 changed files with 134 additions and 28 deletions.
4 changes: 2 additions & 2 deletions _config.yml
Original file line number Diff line number Diff line change
@@ -11,7 +11,7 @@ defaults:
tutorial: true
support: true
versions:
- 23.1
- 23.x
- 7.4
- 7.3
- 7.2
@@ -24,7 +24,7 @@ defaults:
- scope:
path: "content-services/latest"
values:
version: 23.1
version: 23.x
latest: true
release: true
- scope:
4 changes: 2 additions & 2 deletions _data/toc/content-services.yaml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Alfresco Content Services 23.1
- version: 23.1
# Alfresco Content Services 23.x
- version: 23.x
pages:
- title: 'Introduction'
path: '/content-services/latest/'
6 changes: 4 additions & 2 deletions content-services/7.4/support/index.md
Original file line number Diff line number Diff line change
@@ -89,13 +89,14 @@ Choose a combination of products to build your own Supported Stack. If anything
| Alfresco Content Connector for Azure 3.2 | |
| Alfresco Content Connector for Salesforce 2.4 | |
| Alfresco Content Connector for SAP applications 5.3 | |
| Alfresco Content Connector for SAP Cloud 1.2 | |
| Alfresco Content Connector for SAP Cloud 1.2.1 | |
| Alfresco Collaboration Connector for Microsoft 365 2.0 | |
| Alfresco Collaboration Connector for Teams 2.0 | |
| Alfresco Outlook Integration 2.10 | |
| Alfresco Office Services 1.6 | |
| Alfresco Google Docs Integration 3.4 | |
| Alfresco Content Services SDK 5.2 | |
| Alfresco Content Services SDK 4.7 | |
| Alfresco Content Services SDK 4.6 | |
| | |
| **Applications** | |
@@ -204,13 +205,14 @@ Choose a combination of products to build your own Supported Stack. If anything
| Alfresco Content Connector for Azure 3.2 | |
| Alfresco Content Connector for Salesforce 2.4 | |
| Alfresco Content Connector for SAP applications 5.3 | |
| Alfresco Content Connector for SAP Cloud 1.2 | |
| Alfresco Content Connector for SAP Cloud 1.2.1 | |
| Alfresco Collaboration Connector for Microsoft 365 2.0 | |
| Alfresco Collaboration Connector for Teams 2.0 | |
| Alfresco Outlook Integration 2.10 | |
| Alfresco Office Services 1.6 | |
| Alfresco Google Docs Integration 3.4 | |
| Alfresco Content Services SDK 5.2 | |
| Alfresco Content Services SDK 4.7 | |
| Alfresco Content Services SDK 4.6 | |
| | |
| **Applications** | |
2 changes: 1 addition & 1 deletion content-services/latest/config/action.md
Original file line number Diff line number Diff line change
@@ -16,7 +16,7 @@ To configure an APS Action there are several prerequisites that must be met:

> **Note:** If Content Services and Process Services do not sync their uses against a single LDAP database then an APS Action will never work. See [configure LDAP for Content Services]({% link content-services/latest/admin/auth-sync.md %}#configure-ldap) and [configure LDAP for Process Services]({% link process-services/latest/config/authenticate.md %}#ldap-and-active-directory) for information on configuring LDAP.
> **Important:** The APS Action AMP is compatible with Alfresco Process Services 2.4.1 and Alfresco Content Services 23.1.
> **Important:** The APS Action AMP is compatible with Alfresco Process Services 2.4.1 and Alfresco Content Services 23.x.
## Install the AMP

2 changes: 1 addition & 1 deletion content-services/latest/index.md
Original file line number Diff line number Diff line change
@@ -2,7 +2,7 @@
title: Alfresco Content Services
---

Alfresco Content Services 23.1 (or ACS) offers full-featured Enterprise Content Management (ECM) for organizations that require enterprise-grade scalability, performance, and 24x7 support for business-critical content and compliance. It delivers a wide range of use cases such as content and governance services, contextual search and insight, the ability to easily integrate with other applications. At the core of Content Services is a repository supported by a server that persists content, metadata, associations, and full text indexes.
Alfresco Content Services 23.x (or ACS) offers full-featured Enterprise Content Management (ECM) for organizations that require enterprise-grade scalability, performance, and 24x7 support for business-critical content and compliance. It delivers a wide range of use cases such as content and governance services, contextual search and insight, the ability to easily integrate with other applications. At the core of Content Services is a repository supported by a server that persists content, metadata, associations, and full text indexes.

Some of the key capabilities of Content Service include:

2 changes: 1 addition & 1 deletion content-services/latest/install/ansible.md
Original file line number Diff line number Diff line change
@@ -122,7 +122,7 @@ While Content Services supports a wide range of OS, the playbook is only support

### Component versions

The table below shows the version of the components deployed by the playbook for Content Services 23.1, 7.x, and Community.
The table below shows the version of the components deployed by the playbook for Content Services 23.x, 7.x, and Community.

| Component | 23.1.0 Enterprise | 7.4 Enterprise | 7.3 Enterprise | 7.2 Enterprise | 7.1 Enterprise | 7.0 Enterprise | Community |
|-|-|-|-|-|-|-|-|
2 changes: 1 addition & 1 deletion content-services/latest/install/containers/helm.md
Original file line number Diff line number Diff line change
@@ -385,7 +385,7 @@ Since you deployed Enterprise, you'll also have access to:
* Alfresco Digital Workspace: `https://acs.YOUR-DOMAIN-NAME/workspace/`
* Alfresco Sync Service: `https://acs.YOUR-DOMAIN-NAME/syncservice/healthcheck`

If you're running Content Services 23.1 (i.e. the latest version) and already have a valid license file for this version, you can apply it directly to the running system. Navigate to the Admin Console and apply your license:
If you're running Content Services 23.x (i.e. the latest version) and already have a valid license file for this version, you can apply it directly to the running system. Navigate to the Admin Console and apply your license:

* [https://acs.YOUR-DOMAIN-NAME/alfresco/service/enterprise/admin/admin-license](http://localhost:8080/alfresco/service/enterprise/admin/admin-license){:target="_blank"} (this only applies for the Enterprise Download Trial)
* Default username and password is `admin`
2 changes: 1 addition & 1 deletion content-services/latest/install/zip/amp.md
Original file line number Diff line number Diff line change
@@ -5,7 +5,7 @@ nav: false

An Alfresco Module Package (AMP) is a bundle of code, content model, content, and the directory structure that is used to distribute additional functionality for Content Services. Use the Module Management Tool (MMT) to install and manage AMP files. You can install an AMP in an Alfresco WAR using the MMT, or by using the `apply_amps` tool.

The MMT is available as a JAR file from the distribution zip (`alfresco-content-services-distribution-23.1.x.zip`), in the zip's `/bin` directory. Place the `/bin` directory and its contents in the same location where you extracted the Content Services distribution zip; for example `<installLocation>/bin`.
The MMT is available as a JAR file from the distribution zip (`alfresco-content-services-distribution-23.x.x.zip`), in the zip's `/bin` directory. Place the `/bin` directory and its contents in the same location where you extracted the Content Services distribution zip; for example `<installLocation>/bin`.

1. Browse to the `/bin` directory, for example:

2 changes: 1 addition & 1 deletion content-services/latest/install/zip/index.md
Original file line number Diff line number Diff line change
@@ -64,7 +64,7 @@ Here's a list of the files to download and install.

| File | Description |
| ---- | ----------- |
| alfresco-content-services-distribution-23.1.x.zip | Content Services distribution zip for new installations or upgrades. Alfresco WAR files (in distribution zip) for a manual install into an existing Tomcat application server. This distribution zip also contains the Module Management Tool (MMT) and the sample extension files, such as `alfresco-global.properties`. |
| alfresco-content-services-distribution-23.x.x.zip | Content Services distribution zip for new installations or upgrades. Alfresco WAR files (in distribution zip) for a manual install into an existing Tomcat application server. This distribution zip also contains the Module Management Tool (MMT) and the sample extension files, such as `alfresco-global.properties`. |
|alfresco-search-services-2.0.x.zip | Alfresco Search Services distribution zip.<br><br>See [Install Alfresco Search Services]({% link search-services/latest/install/index.md %}) for more information. |

## Preparing the filesystem and database
4 changes: 2 additions & 2 deletions content-services/latest/install/zip/tomcat.md
Original file line number Diff line number Diff line change
@@ -105,7 +105,7 @@ The Content Services distribution file is a zip containing the required WAR file
1. Browse to [Hyland Community](https://community.hyland.com/){:target="_blank"}.
2. Download the file: `alfresco-content-services-distribution-23.1.x.zip`
2. Download the file: `alfresco-content-services-distribution-23.x.x.zip`
3. Specify a location for the download and extract the file to a system directory; for example `<installLocation>`.
@@ -229,7 +229,7 @@ The new keystore configuration implementation requires it to be configured with

1. Move the default keystore files to your installation

1. Extract from the `alfresco-content-services-distribution-23.1.x.zip` file the following two files:
1. Extract from the `alfresco-content-services-distribution-23.x.x.zip` file the following two files:

* `/keystore/metadata-keystore/keystore`
* `/keystore/metadata-keystore/keystore-passwords.properties`
119 changes: 111 additions & 8 deletions content-services/latest/support/index.md
Original file line number Diff line number Diff line change
@@ -2,10 +2,103 @@
title: Supported platforms
---

Here is a list of the individual components that have been through the complete Alfresco Quality Assurance and Certification activities for Alfresco Content Services 23.1.
Here is a list of the individual components that have been through the complete Alfresco Quality Assurance and Certification activities for Alfresco Content Services 23.x.

Choose a combination of products to build your own Supported Stack. If anything is unclear then please [contact Support]({% link support/latest/contact.md %}).

{% capture twenty-three-two %}

| Version | Notes |
| ------- | ----- |
| **Operating systems** | |
| Red Hat Enterprise Linux 9.x x64 | |
| Red Hat Enterprise Linux 8.8 x64 | |
| Windows Server 2022 | |
| Amazon Linux | v2 |
| CentOS 7.9 x64 | |
| Ubuntu 22.04 | |
| Rocky Linux 9.x | |
| Rocky Linux 8.8 | |
| | |
| **Databases** | |
| MySQL 8 | `mysql-connector-java-8.0.30.jar` |
| MS SQL Server 2022 | `mssql-jdbc-11.2.0.jre17.jar` |
| MS SQL Server 2019 | `mssql-jdbc-9.2.1.jre11.jar` |
| Oracle 19c | `Ojdbc11.jar` – 19.3 |
| PostgreSQL 15.x | `Postgresql-42.6.0.jar` |
| PostgreSQL 14.x | `Postgresql-42.3.2.jar` |
| PostgreSQL 13.x | `Postgresql-42.3.2.jar` |
| MariaDB 10.6 | `MariaDB Connector/J 2.7.2` |
| Amazon Aurora | Use of Amazon Aurora is supported only if it is configured to emulate one of the supported versions of PostgreSQL or MySQL listed above, and the listed JDBC driver is used. |
| | |
| **Message brokers** | |
| ActiveMQ v5.18 | |
| | |
| **Application servers** | |
| Tomcat 10.1.x | |
| | |
| **Clients** | |
| Windows 10 x64 | |
| Windows 8.1 x64 | |
| Windows 7 x64 | |
| Mac OSX 10.12 | |
| | |
| **Browsers** | |
| Mozilla Firefox 86 | |
| Microsoft Edge Latest| |
| Chrome 89 | Includes Chromium edition. |
| Safari 15 | |
| | |
| **Java** | |
| OpenJDK 17.x.x | |
| Amazon Corretto 17 | |
| | |
| **Third party integrations** | |
| Microsoft 365 | |
| MS Office 2016 | Microsoft Office for Mac does not support Kerberos authentication. |
| | |
| **Services** | |
| Alfresco Governance Services 23.2 | |
| | |
| **Integrations** | Check the individual documentation on prerequisites and supported platforms for each integration. |
| Alfresco Sync Service 4.0 | |
| Alfresco Desktop Sync 1.17 | |
| Alfresco Desktop Sync 1.16 | |
| Alfresco Transform Service 4.1 | |
| Alfresco Document Transformation Engine 2.4 | |
| Alfresco Search Enterprise 4.0 | For information about migrating from Alfresco Search and Insight Engine 2.0 or Alfresco Search Services 2.0, see the [Alfresco Search Enterprise upgrade page]({% link search-enterprise/latest/upgrade/index.md %}). |
| Alfresco Search and Insight Engine 2.0.8 and later | Search and Insight Engine is compatible with Java 11 as long as you run Zeppelin in a Java 8 runtime. You can do this either in a VM or separate Java 8 based server. |
| Alfresco Search Services 2.0.8 and later | |
| Alfresco Federation Services 3.2 | |
| Keycloak 21.1.2 | |
| Identity Service 2.0 | |
| Alfresco Intelligence Services 3.1 | |
| Alfresco Content Connector for AWS S3 6.1 | Adds support for AWS Glacier using Cloud storage layer. |
| Alfresco Content Connector for Azure 5.0 | |
| Alfresco Content Connector for Salesforce 3.1 | |
| Alfresco Content Connector for SAP Applications 6.0.1 | |
| Alfresco Content Connector for SAP Cloud 2.0 | |
| Alfresco Collaboration Connector for Microsoft 365 2.0 | |
| Alfresco Collaboration Connector for Teams 2.0 | |
| Alfresco Outlook Integration 3.0 | |
| Alfresco Office Services 2.0 | |
| Alfresco Google Docs Integration 4.1 | |
| Alfresco Content Services SDK 4.8 | |
| | |
| **Applications** | |
| Alfresco Digital Workspace 4.4 | |
| Alfresco Mobile Workspace 1.8 | |
| Alfresco Control Center 8.4 | |
| Alfresco Application Development Framework (ADF) 6.x | Some API functionality may be available only in the latest Alfresco Content Services release. |
| Alfresco Content Accelerator 4.0 | |
| Alfresco Enterprise Viewer 4.0 | |
| | |
| **Components** | |
| ImageMagick v7.1.0-16 | |
| LibreOffice v7.2.5 | |

{% endcapture %}

{% capture twenty-three-one %}

| Version | Notes |
@@ -22,13 +115,13 @@ Choose a combination of products to build your own Supported Stack. If anything
| | |
| **Databases** | |
| MySQL 8 | `mysql-connector-java-8.0.30.jar` |
| MS SQL Server 2022 | |
| MS SQL Server 2022 | mssql-jdbc-11.2.0.jre17.jar |
| MS SQL Server 2019 | `mssql-jdbc-9.2.1.jre11.jar` |
| Oracle 19c | `Ojdbc11.jar` – 19.3 |
| PostgreSQL 15.x | `Postgresql-42.6.0.jar` |
| PostgreSQL 14.x | `Postgresql-42.3.2.jar` |
| PostgreSQL 13.x | `Postgresql-42.3.2.jar` |
| MariaDB 10.6 | |
| MariaDB 10.6 | `MariaDB Connector/J 2.7.2` |
| Amazon Aurora | Use of Amazon Aurora is supported only if it is configured to emulate one of the supported versions of PostgreSQL or MySQL listed above, and the listed JDBC driver is used. |
| | |
| **Message brokers** | |
@@ -50,7 +143,7 @@ Choose a combination of products to build your own Supported Stack. If anything
| Safari 15 | |
| | |
| **Java** | |
| OpenJDK 17.0.4 | |
| OpenJDK 17.x.x | |
| Amazon Corretto 17 | |
| | |
| **Third party integrations** | |
@@ -65,35 +158,45 @@ Choose a combination of products to build your own Supported Stack. If anything
| Alfresco Sync Service 4.0 | |
| Alfresco Desktop Sync 1.17 | |
| Alfresco Desktop Sync 1.16 | |
| Alfresco Transform Service 4.1 | |
| Alfresco Transform Service 4.0 | |
| Alfresco Document Transformation Engine 2.4 | |
| Alfresco Search Enterprise 4.0 | For information about migrating from Alfresco Search and Insight Engine 2.0 or Alfresco Search Services 2.0, see the [Alfresco Search Enterprise upgrade page]({% link search-enterprise/latest/upgrade/index.md %}). |
| Alfresco Search and Insight Engine 2.0.8 and later | Search and Insight Engine is compatible with Java 11 as long as you run Zeppelin in a Java 8 runtime. You can do this either in a VM or separate Java 8 based server. |
| Alfresco Search Services 2.0.8 and later | |
| Alfresco Federation Services 3.2 | |
| Alfresco Federation Services 3.1 | |
| Keycloak 21.1.2 | |
| Identity Service 2.0 | |
| Alfresco Intelligence Services 3.1 | |
| Alfresco Content Connector for AWS S3 6.0 | Adds support for AWS Glacier using Cloud storage layer. |
| Alfresco Content Connector for Azure 4.0 | |
| Alfresco Content Connector for Salesforce 3.1 | |
| Alfresco Content Connector for Salesforce 3.0 | |
| Alfresco Content Connector for SAP applications 6.0 | |
| Alfresco Content Connector for SAP Cloud 1.2 | |
| Alfresco Content Connector for SAP Applications 6.0 | |
| Alfresco Content Connector for SAP Cloud 2.0 | |
| Alfresco Collaboration Connector for Microsoft 365 2.0 | |
| Alfresco Collaboration Connector for Teams 2.0 | |
| Alfresco Outlook Integration 3.0 | |
| Alfresco Office Services 2.0 | |
| Alfresco Google Docs Integration 4.1 | |
| Alfresco Google Docs Integration 4.0 | |
| Alfresco Content Services SDK 4.8 | |
| Alfresco Content Services SDK 4.7 | |
| | |
| **Applications** | |
| Alfresco Digital Workspace 4.3 | |
| Alfresco Digital Workspace 4.4 | |
| Alfresco Mobile Workspace 1.8 | |
| Alfresco Control Center 8.4 | |
| Alfresco Control Center 8.3 | |
| Alfresco Application Development Framework (ADF) 6.x | Some API functionality may be available only in the latest Alfresco Content Services release. |
| Alfresco Content Accelerator 4.0 | |
| Alfresco Enterprise Viewer 4.0 | |
| | |
| **Components** | |
| ImageMagick v7.1.0-16 | |
| LibreOffice v7.2.5 | |

{% endcapture %}

{% include tabs.html tableid="supported-platforms" opt1="23.1" content1=twenty-three-one %}
{% include tabs.html tableid="supported-platforms" opt1="23.2" content1=twenty-three-two opt2="23.1" content2=twenty-three-one %}
13 changes: 7 additions & 6 deletions content-services/latest/upgrade/index.md
Original file line number Diff line number Diff line change
@@ -21,13 +21,13 @@ When you upgrade Content Services, it's recommended that you follow a structured

The following diagram shows the upgrade paths for major versions:

![Upgrade paths to 23.1]({% link content-services/images/upgrade-path-23.1.png %})
![Upgrade paths to 23.x]({% link content-services/images/upgrade-path-23.x.png %})

The upgrade path recommendations are:

* Direct upgrades to Content Services 23.1 are supported only from 7.1 and later versions, using their latest patch release.
* Content Services 23.1 introduces changes that require new releases of some modules. To upgrade to 23.1, you also need to update any of the module artifacts to which you're entitled. See [Supported platforms]({% link content-services/latest/support/index.md %}) for more details on the associated versions.
* You must upgrade to a supported version of Alfresco Search Services before upgrading the repository to 23.1. See [Upgrade Search Services]({% link search-services/latest/upgrade/index.md %}) for more information.
* Direct upgrades to Content Services 23.x are supported only from 7.1 and later versions, using their latest patch release.
* Content Services 23.x introduces changes that require new releases of some modules. To upgrade to 23.x, you also need to update any of the module artifacts to which you're entitled. See [Supported platforms]({% link content-services/latest/support/index.md %}) for more details on the associated versions.
* You must upgrade to a supported version of Alfresco Search Services before upgrading the repository to 23.x. See [Upgrade Search Services]({% link search-services/latest/upgrade/index.md %}) for more information.

> **Note:** If you're upgrading from an earlier release that's not shown on this diagram, [contact Support]({% link support/latest/contact.md %}){:target="_blank"}.
@@ -48,6 +48,7 @@ The following table shows the upgrade path for major versions:
| Community Edition 7.3 | Content Services 7.3 |
| Community Edition 7.4 | Content Services 7.4 |
| Community Edition 23.1 | Content Services 23.1 |
| Community Edition 23.2 | Content Services 23.2 |

Please contact Alfresco Support for upgrade advice that's specific to your environment.

@@ -93,13 +94,13 @@ These steps assume that you've got an existing Content Services installation (`a
data.dir.root:/alfresco-v.2/solr/myindexes
```

2. Validate the new 23.1 installation to check that it's working correctly.
2. Validate the new 23.x installation to check that it's working correctly.
1. Configure the new installation with a new repository and database (not the existing one).
2. [Start the server]({% link content-services/latest/install/zip/additions.md %}#start-server) and [validate](#validate-upgrade) that the system works correctly.
3. Apply all customizations to the new 23.1 installation.
3. Apply all customizations to the new 23.x installation.
1. [Stop]({% link content-services/latest/install/zip/additions.md %}#stop-server) the server.

0 comments on commit 7e04d81

Please sign in to comment.