The official documentation is at: http://docs.alfresco.com
Windows manual installation
This installation approach is for those who choose to manually install alfresco-labs-war-3b.zip. This installation process was created using the following specific software stack:
- Windows XP sp3 (i386 32bit)
- Tomcat 5.5.27 - default install
- JDK 1.5.0_14-b03 - default install
- MySQL 5.0.67 - innodb transactional options
- Tomcat and MySQL were left with the default admin or root accounts for the installation
- The Widows user was a local administrator
- This section is experimental (only completed twice), use at your own risk.
- Details of the OpenOffice or WCM installation are not included.
- Please contact Antony Cartwright with any comments.
See notes on Manual removal of Alfresco below for removing a fully or partially installed Alfresco.
The following steps are a check list of things you might want to do prior to beginning a manual installation.
- see information on removing a manually installed Alfresco.
- Stop any running Alfresco instances or anything else using port 8080 (tomcat) or 3306 (MySQL).
- Stop Tomcat.
- Stop MySQL.
- Backup your Tomcat installation.
- Backup your MySQL installation (including all the data files).
- Unzip alfresco-labs-war-3b.zip to <unzipdir>.
- Move <unzipdir>\extensions\extension to <Tomcat home>/shared/classes/alfresco/.
- Move <unzipdir>\extensions\messages to <Tomcat home>/shared/classes/alfresco/.
- Move <unzipdir>\endorsed\* into </tt><Tomcat home>/common/endorsed/</tt>.
- Move <unzipdir>\bin\* into <Tomcat home>/bin/.
- Start the MySQL server.
- Open a command prompt and change directory to <unzipdir>\extras\databases\mysql.
- Run: db_setup.bat (prompts for MySQL root password).
- Check: mysql -ualfresco -palfresco 'show databases;'
- See Configuring the MySQL database.
- Copy MySQL connector driver (custom-repository.properties suggests mysql-connector-java-5.0.3-bin.jar) to <Tomcat home>/common/lib
- (I used mysql-connector-java-5.0.8-bin.jar which I downloaded from MySQL and built)
- Tomcat preparation:
- Increase Tomcat's Java heap allocation by adding this line set JAVA_OPTS=%JAVA_OPTS% -Xms512m -Xmx512m just after the line ending '...call '%CATALINA_HOME%\bin\setenv.bat', if present or extend the existing definition.
- Check setenv.bat if it exists with JAVA_OPTS defined.
- Start Tomcat - I use a custom script that ends up executing catalina.bat (just make sure catalina.bat is executed).
- Check: Connect to Tomcat manager using a browser: http://localhost:8080/manager/html.
- Login to Tomcat manager http://localhost:8080/manager/html.
- Deploy the war file: alfresco.war
- Deployment takes after a few minutes and the database schema is created
- Check if Alfresco is running: http://localhost:8080/alfresco/ (login as admin/admin)
The installation is complete. Use Tomcat manager to start and stop run Alfresco.
Manual removal of Alfresco
The following steps remove files installed in the above process. As some of these files are common Tomcat files, you are advised to make a backup when an installed file overwrites an existing file so it can be restored when the Alfresco bundled files are removed.
- Undeploy alfresco.war from tomcat (using Tomcat manager).
- Remove the MySQL Alfresco database: mysql -uroot -ppassword -e 'drop database alfresco;.
- Stop MySQL.
- Stop Tomcat.
- Delete the installed files (carefully):
<Tomcat home>/common/endorsed/serializer.jar (if it wasn't there before the alfresco install)
<Tomcat home>/common/endorsed/xalan.jar (if it wasn't there before the alfresco install)
<Tomcat home>/common/lib/mysql-connector-java-5.0.8-bin.jar (if it wasn't there before the alfresco install)