Wiki source code of Alfresco Community 4.x Install Cookbook
Version 2.1 by Normann P. Nielsen on 2026/11/15 15:40
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{toc/}} | ||
| 2 | |||
| 3 | [[http://docs.alfresco.com/community/concepts/welcome-infocenter_community.html]] | ||
| 4 | |||
| 5 | {{error}}Alfresco comes with Postgres by default, but I prefer MySQL - hence this guide is for MySQL{{/error}} | ||
| 6 | |||
| 7 | |||
| 8 | |||
| 9 | = Requirements = | ||
| 10 | |||
| 11 | === Alfreco === | ||
| 12 | See link for newest requirements | ||
| 13 | |||
| 14 | === OS and Hardware Settings === | ||
| 15 | **Virtual: **Why not - the benefist are huge | ||
| 16 | |||
| 17 | **Preferred OS:** Ubuntu LTS 64-bit | ||
| 18 | |||
| 19 | **Hardware:** At least 2 CPU's and at least 4 GB Ram | ||
| 20 | |||
| 21 | |||
| 22 | |||
| 23 | === Libs === | ||
| 24 | Different Libs for image support (ImageMagick), SWFTools (Flash), etc | ||
| 25 | |||
| 26 | |||
| 27 | {{code}} | ||
| 28 | sudo apt-get install mysql-server ImageMagick GhostScript smbclient libjpeg62 libgif4 | ||
| 29 | sudo apt-get install libice6 libsm6 libxt6 libxrender1 libfontconfig1 libcups2 | ||
| 30 | sudo add-apt-repository ppa:jon-severinsson/ffmpeg | ||
| 31 | sudo apt-get update | ||
| 32 | sudo apt-get install ffmpeg | ||
| 33 | |||
| 34 | sudo apt-get install libart-2.0-2 | ||
| 35 | wget http://archive.canonical.com/ubuntu/pool/partner/s/swftools/swftools_0.9.0-0ubuntu2_amd64.deb | ||
| 36 | chmod a+x swftools_0.9.0-0ubuntu2_amd64.deb | ||
| 37 | sudo dpkg -i swftools_0.9.0-0ubuntu2_amd64.deb | ||
| 38 | sudo rm swftools_0.9.0-0ubuntu2_amd64.deb | ||
| 39 | {{/code}} | ||
| 40 | |||
| 41 | === LibreOffice === | ||
| 42 | |||
| 43 | {{code}} | ||
| 44 | sudo apt-get install libreoffice | ||
| 45 | sudo apt-get install ttf-mscorefonts-installer fonts-droid | ||
| 46 | {{/code}} | ||
| 47 | |||
| 48 | |||
| 49 | |||
| 50 | === Mail === | ||
| 51 | SMTP Access for sending mail | ||
| 52 | |||
| 53 | IMAP Access for picking up mail | ||
| 54 | |||
| 55 | |||
| 56 | |||
| 57 | = Installation = | ||
| 58 | |||
| 59 | === Prepare database === | ||
| 60 | Create the Database | ||
| 61 | |||
| 62 | |||
| 63 | {{code}} | ||
| 64 | mysql> CREATE DATABASE alfresco CHARACTER SET utf8 COLLATE utf8_bin; | ||
| 65 | Query OK, 1 row affected (0.00 sec) | ||
| 66 | mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER,INDEX on alfresco .* to alfresco@localhost identified by '******'; | ||
| 67 | Query OK, 0 rows affected (0.00 sec) | ||
| 68 | mysql> | ||
| 69 | {{/code}} | ||
| 70 | |||
| 71 | === Install binaries === | ||
| 72 | Download Alfreco from [[http://www.alfresco.com/products/community]] | ||
| 73 | |||
| 74 | For the binary installer, JAVA is integrated. | ||
| 75 | |||
| 76 | |||
| 77 | {{code}} | ||
| 78 | root@myserver:~# ./alfresco-community-4.2.f-installer-linux-x64.bin ---mode text | ||
| 79 | Language Selection | ||
| 80 | Please select the installation language | ||
| 81 | [1] English - English | ||
| 82 | [2] French - Français | ||
| 83 | [3] Spanish - Español | ||
| 84 | [4] Italian - Italiano | ||
| 85 | [5] German - Deutsch | ||
| 86 | [6] Japanese - ??? | ||
| 87 | [7] Dutch - Nederlands | ||
| 88 | [8] Russian - ??????? | ||
| 89 | [9] Simplified Chinese - ???? | ||
| 90 | [10] Norwegian - Norsk bokmål | ||
| 91 | [11] Brazilian Portuguese - Português Brasileiro | ||
| 92 | Please choose an option [1] : | ||
| 93 | ---------------------------------------------------------------------------- | ||
| 94 | Welcome to the Alfresco Community Setup Wizard. | ||
| 95 | ---------------------------------------------------------------------------- | ||
| 96 | Installation Type | ||
| 97 | [1] Easy - Installs servers with the default configuration | ||
| 98 | [2] Advanced - Configures server ports and service properties.: Also choose optional components to install. | ||
| 99 | Please choose an option [1] : 2 | ||
| 100 | ---------------------------------------------------------------------------- | ||
| 101 | Select the components you want to install; clear the components you do not want | ||
| 102 | to install. Click Next when you are ready to continue. | ||
| 103 | Java [Y/n] : | ||
| 104 | PostgreSQL [Y/n] :n | ||
| 105 | Alfresco : Y (Cannot be edited) | ||
| 106 | SharePoint [Y/n] : | ||
| 107 | Web Quick Start [y/N] : | ||
| 108 | Google Docs Integration [Y/n] : | ||
| 109 | LibreOffice [Y/n] : | ||
| 110 | Is the selection above correct? [Y/n]: | ||
| 111 | |||
| 112 | Installation folder | ||
| 113 | Please choose a folder to install Alfresco Community | ||
| 114 | Select a folder [/opt/alfresco-4.2.f]: /opt/alfresco | ||
| 115 | ---------------------------------------------------------------------------- | ||
| 116 | Database Configuration | ||
| 117 | JDBC URL: [jdbc:postgresql://localhost/alfresco]: jdbc:mysql://localhost/alfresco | ||
| 118 | JDBC Driver: [org.postgresql.Driver]: com.mysql.jdbc.Driver | ||
| 119 | Database name: [alfresco]: | ||
| 120 | Username: []: alfresco | ||
| 121 | Password: : | ||
| 122 | Verify: : | ||
| 123 | ---------------------------------------------------------------------------- | ||
| 124 | Tomcat Port Configuration | ||
| 125 | Please enter the Tomcat configuration parameters you wish to use. | ||
| 126 | Web Server domain: [127.0.0.1]: | ||
| 127 | Tomcat Server Port: [8080]: | ||
| 128 | Tomcat Shutdown Port: [8005]: | ||
| 129 | Tomcat SSL Port [8443]: | ||
| 130 | Tomcat AJP Port: [8009]: | ||
| 131 | ---------------------------------------------------------------------------- | ||
| 132 | Alfresco FTP Port | ||
| 133 | Please choose a port number to use for the integrated Alfresco FTP server. | ||
| 134 | Port: [21]: | ||
| 135 | ---------------------------------------------------------------------------- | ||
| 136 | Alfresco RMI Port | ||
| 137 | Please choose a port number for Alfresco to use to execute remote commands. | ||
| 138 | Port: [50500]: | ||
| 139 | ---------------------------------------------------------------------------- | ||
| 140 | Admin Password | ||
| 141 | Please give a password to use for the Alfresco administrator account. | ||
| 142 | Admin Password: : | ||
| 143 | Repeat Password: : | ||
| 144 | ---------------------------------------------------------------------------- | ||
| 145 | Alfresco SharePoint Port | ||
| 146 | Please choose a port number for the SharePoint protocol. | ||
| 147 | Port: [7070]: | ||
| 148 | ---------------------------------------------------------------------------- | ||
| 149 | Install as a service | ||
| 150 | You can optionally register Alfresco Community as a service. This way it will | ||
| 151 | automatically be started every time the machine is started. | ||
| 152 | Install Alfresco Community as a service? [Y/n]: | ||
| 153 | |||
| 154 | ---------------------------------------------------------------------------- | ||
| 155 | LibreOffice Server Port | ||
| 156 | Please enter the port that the LibreOffice Server will listen to by default. | ||
| 157 | LibreOffice Server Port [8100]: | ||
| 158 | ---------------------------------------------------------------------------- | ||
| 159 | Setup is now ready to begin installing Alfresco Community on your computer. | ||
| 160 | Do you want to continue? [Y/n]: | ||
| 161 | ---------------------------------------------------------------------------- | ||
| 162 | Please wait while Setup installs Alfresco Community on your computer. | ||
| 163 | Installing | ||
| 164 | 0% ______________ 50% ______________ 100% | ||
| 165 | ######################################### | ||
| 166 | ---------------------------------------------------------------------------- | ||
| 167 | Setup has finished installing Alfresco Community on your computer. | ||
| 168 | View Readme File [Y/n]: n | ||
| 169 | Launch Alfresco Community Share [Y/n]: n | ||
| 170 | {{/code}} | ||
| 171 | |||
| 172 | If You use MySQL, we need to copy in the driver (get it [[here>>http://dev.mysql.com/downloads/connector/j/]]) first to /opt/alfresco/tomcat/lib: | ||
| 173 | |||
| 174 | |||
| 175 | {{code}} | ||
| 176 | sudo cp mysql-connector-java-5.1.34-bin /opt/alfresco/tomcat/lib: | ||
| 177 | {{/code}} | ||
| 178 | |||
| 179 | Then start alfresco: | ||
| 180 | |||
| 181 | |||
| 182 | {{code}} | ||
| 183 | sudo /etc/init.d/alfresco start | ||
| 184 | |||
| 185 | Using CATALINA_BASE: /opt/alfresco/tomcat | ||
| 186 | Using CATALINA_HOME: /opt/alfresco/tomcat | ||
| 187 | Using CATALINA_TMPDIR: /opt/alfresco/tomcat/temp | ||
| 188 | Using JRE_HOME: /opt/alfresco/java | ||
| 189 | Using CLASSPATH: /opt/alfresco/tomcat/bin/bootstrap.jar:/opt/alfresco/tomcat/bin/tomcat-juli.jar | ||
| 190 | Using CATALINA_PID: /opt/alfresco/tomcat/temp/catalina.pid | ||
| 191 | Tomcat started. | ||
| 192 | /opt/alfresco/tomcat/scripts/ctl.sh : tomcat started | ||
| 193 | root@myserver:~# | ||
| 194 | {{/code}} | ||
| 195 | |||
| 196 | See everything is ok: | ||
| 197 | |||
| 198 | |||
| 199 | {{code}} | ||
| 200 | root@myserver:~# tail -f /opt/alfresco/tomcat/logs/catalina.out | ||
| 201 | {{/code}} | ||
| 202 | |||
| 203 | |||
| 204 | |||
| 205 | = Postinstall = | ||
| 206 | |||
| 207 | Also review [[http://docs.alfresco.com/community/concepts/prereq-opt-install.html]] | ||
| 208 | |||
| 209 | === **Move data** === | ||
| 210 | You can move the data dir /opt/alfresco/alf_data to another location (Renaming is not recommeded, the "alf_data" name is in several config files allover) | ||
| 211 | |||
| 212 | |||
| 213 | {{code}} | ||
| 214 | /etc/init.d/alfresco stop | ||
| 215 | cd /opt/alfresco/ | ||
| 216 | mv alf_data /data/ | ||
| 217 | ln -s /data/alf_data . | ||
| 218 | /etc/init.d/alfresco start | ||
| 219 | {{/code}} | ||
| 220 | |||
| 221 | === **Correct Paths** === | ||
| 222 | Edit the /opt/alfresco/tomcat/shared/classes/alfresco-global.properties and check paths | ||
| 223 | |||
| 224 | === Enable CIFS === | ||
| 225 | Edit the /opt/alfresco/tomcat/shared/classes/alfresco-global.properties | ||
| 226 | |||
| 227 | |||
| 228 | {{code}} | ||
| 229 | ## CIFS ## | ||
| 230 | cifs.disableNativeCode=false | ||
| 231 | cifs.enabled=true | ||
| 232 | cifs.serverName=alfresco.myserver.dk | ||
| 233 | cifs.domain=MYSERVER | ||
| 234 | cifs.hostannounce=true | ||
| 235 | cifs.sessionTimeout=500 | ||
| 236 | cifs.ipv6.enabled=false | ||
| 237 | cifs.tcpipSMB.port=445 | ||
| 238 | cifs.netBIOSSMB.namePort=137 | ||
| 239 | cifs.netBIOSSMB.datagramPort=138 | ||
| 240 | cifs.netBIOSSMB.sessionPort=139 | ||
| 241 | cifs.WINS.autoDetectEnabled=true | ||
| 242 | {{/code}} | ||
| 243 | |||
| 244 | === Test CIFS === | ||
| 245 | With the SMB Client You can test and browse: | ||
| 246 | |||
| 247 | |||
| 248 | {{code}} | ||
| 249 | root@myserver: smbclient -U admin \\\\127.0.0.1\\alfresco | ||
| 250 | Enter admin's password: | ||
| 251 | Domain=[MOS-EISLEY] OS=[Java] Server=[Alfresco CIFS Server 6.0.0] | ||
| 252 | smb: \> ls | ||
| 253 | . D 0 Tue Feb 26 18:39:48 2013 | ||
| 254 | .. D 0 Tue Feb 26 18:39:48 2013 | ||
| 255 | __ShowDetails.exe 393216 Tue Feb 26 18:00:58 2013 | ||
| 256 | __CheckInOut.exe 393216 Tue Feb 26 18:00:58 2013 | ||
| 257 | __Alfresco.url 131 Tue Feb 26 18:00:58 2013 | ||
| 258 | Data Dictionary D 0 Tue Feb 26 08:10:23 2013 | ||
| 259 | Guest Home D 0 Tue Feb 26 08:10:10 2013 | ||
| 260 | User Homes D 0 Tue Feb 26 13:28:42 2013 | ||
| 261 | Imap Attachments D 0 Tue Feb 26 08:10:44 2013 | ||
| 262 | Sites D 0 Tue Feb 26 18:40:03 2013 | ||
| 263 | 65535 blocks of size 33553920. 32767 blocks available | ||
| 264 | smb: \> | ||
| 265 | |||
| 266 | |||
| 267 | |||
| 268 | |||
| 269 | {{/code}} | ||
| 270 | |||
| 271 | |||
| 272 | |||
| 273 | === Enable FTP === | ||
| 274 | Edit the /opt/alfresco/shared/classes/alfresco-global.properties (see [[http://docs.alfresco.com/4.1/concepts/fileserv-ftp-props.html]]) | ||
| 275 | |||
| 276 | |||
| 277 | {{code}} | ||
| 278 | ### FTP Server Configuration ### | ||
| 279 | ftp.enabled=true | ||
| 280 | ftp.port=21 | ||
| 281 | ftp.ipv6.enabled=false | ||
| 282 | {{/code}} | ||
| 283 | |||
| 284 | |||
| 285 | |||
| 286 | = Other = | ||
| 287 | |||
| 288 | === Proxy passing === | ||
| 289 | There are good reasons for using an Apache or Traffic Manager in front of the Alfresco Installation, some are: | ||
| 290 | |||
| 291 | * No port changing (non-root users can assign to ports below 1024) | ||
| 292 | * Use of URL Rewrite | ||
| 293 | * Use of URL Blocking | ||
| 294 | * Use of Allow/Denial | ||
| 295 | * SSL offloading/handling outside the Confluence | ||
| 296 | Se my example in [[Apache2 Proxy Passing>>Main.information-technology.apache2-webserver.apache2-proxy-passing]] | ||
| 297 | |||
| 298 | === Trashcan tweaking === | ||
| 299 | Instead of having Alfreso putting deleted files into the contentstore.deleted directory, which has to be cleaned manually, read [[http://blyx.com/2014/08/18/understanding-alfresco-content-deletion/]] and add the amp [[https://code.google.com/p/alfresco-trashcan-cleaner/]] into /op/alfresco/amps/ | ||
| 300 | |||
| 301 | Edit the /opt/alfresco/shared/classes/alfresco-global.properties | ||
| 302 | |||
| 303 | |||
| 304 | {{code}} | ||
| 305 | system.content.eagerOrphanCleanup=true | ||
| 306 | trashcan.cron=0 30 * * * ? | ||
| 307 | trashcan.daysToKeep=1 | ||
| 308 | trashcan.deleteBatchCount=1000 | ||
| 309 | {{/code}} | ||
| 310 | |||
| 311 | |||
| 312 | |||
| 313 | = Batch upload = | ||
| 314 | |||
| 315 | [[Batch upload to Alfresco sites via CIFS>>Main.information-technology.alfresco.batch-upload-to-alfresco-sites-via-cifs]] | ||
| 316 | |||
| 317 | = Logfiles = | ||
| 318 | |||
| 319 | === Logrotate === | ||
| 320 | Set up logrotate to avoid ever growing catalina.out log file. Here JIRA_Home is /opt/jira, logs are rotated daily and kept for 7 days: | ||
| 321 | |||
| 322 | |||
| 323 | {{code language="/etc/logrotate.d/confluence"}} | ||
| 324 | /opt/alfresco/tomcat/logs/catalina.out { | ||
| 325 | daily | ||
| 326 | rotate 7 | ||
| 327 | compress | ||
| 328 | copytruncate | ||
| 329 | delaycompress | ||
| 330 | missingok | ||
| 331 | size 10M | ||
| 332 | notifempty | ||
| 333 | } | ||
| 334 | {{/code}} |