If I knew how to contribute to the documentation I would have done so, but I didn't find anything on Github, so I post it here to help others, who may run into the same quirks as I did.
Proposal 1 (DB Setup):
Please add sections regarding the supported DB setups for ACS. There's only an example regarding PostgreSQL. But for MySQL 8 a specific section of the documentation could mention:
That the initial root password is written into a [computername],err file (in the MySQL data folder) after the first initialisation of the DB.
And it would also be helpful to document the creation of the alfreso DB and an user like:
mysql> CREATE DATABASE alfresco CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
mysql> create user 'alfresco'@'localhost' IDENTIFIED BY 'alfresco';
mysql> GRANT ALL PRIVILEGES ON alfresco . * TO 'alfresco'@'localhost';
While this may be knowledge that any "Install without container" person should have, it would be VERY helpful to have a "alfresco-global.propeties.sample" in the distribution that mentions the correct driver name for MySQL 8 Connector/J.
The sample contains
# MySQL connection
But the class name for the MySQL 8 Connector/J is com.mysql.cj.jdbc.Driver
should mention that if your Tomcat installation is NOT located under the Alfresco distribution installation the line in "apply_amps.bat"
has to be adjusted accordingly.
Proposal 3 (Enable Simple JAR modules):
The creation of the modules folder under CATALINA_HOME is described as optional in the documentation. But at least for me the deployment failed because of the share and platform deployment XML descriptors that mention these folder.
Moreover: On my Windows OS the path in the XML files was not working until I changed the it to a windows path notation style.
Proposal 4 (Solr Metadata Keystore):
Sorry, but this is really something that has to be fixed and enhanced in the Search Services distribution and it's :