Installing Labs 3b on Windows (manual installation)

[resplin]

Obsolete Pages{{Obsolete}}

The official documentation is at: http://docs.alfresco.com

Table of Contents

• 1 Windows manual installation
  
  
  
  • 1.1 Preparation
  
  
  • 1.2 Installation Steps
  
  
  • 1.3 Manual removal of Alfresco
  
  

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
  

Caveats:

• 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.

Preparation

The following steps are a check list of things you might want to do prior to beginning a manual installation.

1. see information on removing a manually installed Alfresco.
   
2. Stop any running Alfresco instances or anything else using port 8080 (tomcat) or 3306 (MySQL).
   
3. Stop Tomcat.
   
4. Stop MySQL.
   
5. Backup your Tomcat installation.
   
6. Backup your MySQL installation (including all the data files).
   

Installation Steps

1. Unzip alfresco-labs-war-3b.zip to <unzipdir>.
   
2. Move <unzipdir>\extensions\extension to <Tomcat home>/shared/classes/alfresco/.
   
3. Move <unzipdir>\extensions\messages to <Tomcat home>/shared/classes/alfresco/.
   
4. Move <unzipdir>\endorsed\* into </tt><Tomcat home>/common/endorsed/</tt>.
   
5. Move <unzipdir>\bin\* into <Tomcat home>/bin/.
   
6. Start the MySQL server.
   
7. Open a command prompt and change directory to <unzipdir>\extras\databases\mysql.
   
8. Run: db_setup.bat (prompts for MySQL root password).
   
9. Check: mysql -ualfresco -palfresco 'show databases;'
   
10. See Configuring the MySQL database.
    
11. Copy MySQL connector driver (custom-repository.properties suggests mysql-connector-java-5.0.3-bin.jar) to <Tomcat home>/common/lib  
    
12. (I used mysql-connector-java-5.0.8-bin.jar which I downloaded from MySQL and built)
    
13. Tomcat preparation:
    
14. 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.
    
15. Check setenv.bat if it exists with JAVA_OPTS defined.
    
16. Start Tomcat - I use a custom script that ends up executing catalina.bat (just make sure catalina.bat is executed).
    
17. Check: Connect to Tomcat manager using a browser: http://localhost:8080/manager/html.
    
18. Login to Tomcat manager http://localhost:8080/manager/html.
    
19. Deploy the war file: alfresco.war
    
20. Deployment takes after a few minutes and the database schema is created
    
21. 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.

1. Undeploy alfresco.war from tomcat (using Tomcat manager).
   
2. Remove the MySQL Alfresco database: mysql -uroot -ppassword -e 'drop database alfresco;.
   
3. Stop MySQL.
   
4. Stop Tomcat.
   
5. Delete the installed files (carefully):
   

<Tomcat home>/webapps/alfresco
<Tomcat home>/shared/classes/alfresco/
<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)
<Tomcat home>/bin/Win32NetBIOS.dll
<Tomcat home>/bin/Win32NetBIOSx64.dll
<Tomcat home>/bin/Win32Utils.dll
<Tomcat home>/bin/Win32Utilsx64.dll

Labs 3
Installation
3.0