Version 2.1 by Normann P. Nielsen on 2026/11/15 15:40

Show last authors
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}}