mirror of
https://github.com/Alfresco/alfresco-community-repo.git
synced 2025-07-24 17:32:48 +00:00
103 lines
3.6 KiB
Plaintext
103 lines
3.6 KiB
Plaintext
Configuring and starting Alfresco/Share:
|
|
----------------------------------------
|
|
|
|
- Clone the project (e.g. git clone git@gitlab.alfresco.com:records-management/records-management.git)
|
|
|
|
- Import the project as a maven project
|
|
|
|
- Start the Alfresco/Share instances with the following commands:
|
|
|
|
mvn clean install -Pstart-repo
|
|
mvn clean install -Pstart-share
|
|
|
|
(these commands work best if run from the specific directories, e.g. start share from
|
|
rm-enterprise/rm-enterprise-share/ or rm-community/rm-community-share/ )
|
|
|
|
|
|
Configuring a different DB other than H2 (e.g. MySQL or PostgreSQL):
|
|
--------------------------------------------------------------------
|
|
|
|
- Create a file called "local.properties" under src/main/resources in alfresco-rm-enterprise-repo
|
|
|
|
- Add the following properties in this new file
|
|
my.db.name -> The name of the database schema
|
|
my.db.port -> The port number for your database (default port number for postgres is 5432 and for mysql it is 3306)
|
|
|
|
- Run the following commands to start your Alfresco instance:
|
|
|
|
to start Alfresco (using Postgres):
|
|
mvn clean install -Pstart-repo,use-postgres
|
|
|
|
to start Alfresco (using MySQL):
|
|
mvn clean install -Pstart-repo,use-mysql
|
|
|
|
|
|
Running integration test:
|
|
-------------------------
|
|
|
|
In order to execute the integration tests run the following command (unit tests will be executed every time before you start Alfresco/Share):
|
|
|
|
mvn clean install -Dskip.integrationtests=false
|
|
|
|
|
|
Running UI Automation tests:
|
|
----------------------------
|
|
|
|
To run the automated UI tests, change to the rm-automation directory and run:
|
|
|
|
mvn clean install -Dskip.automationtests=false
|
|
|
|
Depending on your local Firefox version, you may need to modify the rm-automation/pom.xml to use version 1.7 of selenium-grid
|
|
|
|
|
|
Updating License Headers:
|
|
-------------------------
|
|
|
|
In order to refesh out of date license source headers run the following command:
|
|
|
|
mvn clean install -Dlicense.update.dryrun=false
|
|
|
|
|
|
Running tests against latest Aikau snapshot:
|
|
--------------------------------------------
|
|
|
|
The latest Aikau snapshot can be pulled by running the following command in rm-community:
|
|
|
|
mvn clean install -DskipTests -Dalfresco.aikau.version=LATEST -U
|
|
|
|
Thereafter start the Share instance and run automation tests as described above.
|
|
|
|
|
|
Configuring Outlook Integration:
|
|
-------------------------------
|
|
|
|
To download and run RM with the Outlook Integration AMPs installed on the repo and Share use the following commands:
|
|
|
|
mvn clean install -Pstart-repo,outlook-integration
|
|
mvn clean install -Pstart-share,outlook-integration
|
|
|
|
Follow these instructions install licence and Outlook plugin:
|
|
|
|
- http://docs.alfresco.com/outlook2.1/tasks/Outlook-license.html
|
|
- http://docs.alfresco.com/outlook2.1/tasks/Outlook-install_v2.html
|
|
|
|
|
|
|
|
|
|
|
|
SNAPSHOT dependencies:
|
|
----------------------
|
|
|
|
If you're building Enterprise RM, the base project (Community) is pulled in via a snapshot dependency configured in maven.
|
|
This dependency will either be loaded from your local .m2 cache or from Nexus if the version in your .m2 doesn't exist or is old
|
|
(Old in maven terms is anything over 24hrs old). If maven fetches it from Nexus, your code it's unlikely to be the correct version.
|
|
You want to always use the version in your local cache - this means either doing a daily build at the root project level
|
|
that pushes a new copy of the correct version into your cache, or alternatively you could run mvn with the
|
|
--no-snapshot-dependency (or -nsu) option, which won't try to download a newer version.
|
|
|
|
|
|
Code Formatting:
|
|
----------------
|
|
|
|
This project follows the usual Alfresco Coding Standards. If you use Eclipse or IntelliJ, there are settings inside the ide-config directory for you to import.
|