-
Notifications
You must be signed in to change notification settings - Fork 3
/
exportword087d
493 lines (465 loc) · 21.4 KB
/
exportword087d
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
Message-ID: <1532300863.4406.1485866399063.JavaMail.confluence@ip-10-127-227-164>
Subject: Exported From Confluence
MIME-Version: 1.0
Content-Type: multipart/related;
boundary="----=_Part_4405_995039624.1485866399063"
------=_Part_4405_995039624.1485866399063
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
Content-Location: file:///C:/exported.html
<html xmlns:o=3D'urn:schemas-microsoft-com:office:office'
xmlns:w=3D'urn:schemas-microsoft-com:office:word'
xmlns:v=3D'urn:schemas-microsoft-com:vml'
xmlns=3D'urn:w3-org-ns:HTML'>
<head>
<meta http-equiv=3D"Content-Type" content=3D"text/html; charset=3Dutf-8=
">
<title>Requirements for doing a normal installation</title>
<!--[if gte mso 9]>
<xml>
<o:OfficeDocumentSettings>
<o:TargetScreenSize>1024x640</o:TargetScreenSize>
<o:PixelsPerInch>72</o:PixelsPerInch>
<o:AllowPNG/>
</o:OfficeDocumentSettings>
<w:WordDocument>
<w:View>Print</w:View>
<w:Zoom>90</w:Zoom>
<w:DoNotOptimizeForBrowser/>
</w:WordDocument>
</xml>
<![endif]-->
<style>
<!--
@page Section1 {
size: 8.5in 11.0in;
margin: 1.0in;
mso-header-margin: .5in;
mso-footer-margin: .5in;
mso-paper-source: 0;
}
td {
page-break-inside: avoid;
}
tr {
page-break-after: avoid;
}
div.Section1 {
page: Section1;
}
/* Confluence print stylesheet. Common to all themes for print medi=
a */
/* Full of !important until we improve batching for print CSS */
@media print {
#main {
padding-bottom: 1em !important; /* The default padding of 6em is to=
o much for printouts */
}
body {
font-family: Arial, Helvetica, FreeSans, sans-serif;
font-size: 10pt;
line-height: 1.2;
}
body, #full-height-container, #main, #page, #content, .has-personal-sid=
ebar #content {
background: #fff !important;
color: #000 !important;
border: 0 !important;
width: 100% !important;
height: auto !important;
min-height: auto !important;
margin: 0 !important;
padding: 0 !important;
display: block !important;
}
a, a:link, a:visited, a:focus, a:hover, a:active {
color: #000;
}
#content h1,
#content h2,
#content h3,
#content h4,
#content h5,
#content h6 {
font-family: Arial, Helvetica, FreeSans, sans-serif;
page-break-after: avoid;
}
pre {
font-family: Monaco, "Courier New", monospace;
}
#header,
.aui-header-inner,
#navigation,
#sidebar,
.sidebar,
#personal-info-sidebar,
.ia-fixed-sidebar,
.page-actions,
.navmenu,
.ajs-menu-bar,
.noprint,
.inline-control-link,
.inline-control-link a,
a.show-labels-editor,
.global-comment-actions,
.comment-actions,
.quick-comment-container,
#addcomment {
display: none !important;
}
.comment .date::before {
content: none !important; /* remove middot for print view */
}
h1.pagetitle img {
height: auto;
width: auto;
}
.print-only {
display: block;
}
#footer {
position: relative !important; /* CONF-17506 Place the footer at en=
d of the content */
margin: 0;
padding: 0;
background: none;
clear: both;
}
#poweredby {
border-top: none;
background: none;
}
#poweredby li.print-only {
display: list-item;
font-style: italic;
}
#poweredby li.noprint {
display: none;
}
/* no width controls in print */
.wiki-content .table-wrap,
.wiki-content p,
.panel .codeContent,
.panel .codeContent pre,
.image-wrap {
overflow: visible !important;
}
/* TODO - should this work? */
#children-section,
#comments-section .comment,
#comments-section .comment .comment-body,
#comments-section .comment .comment-content,
#comments-section .comment p {
page-break-inside: avoid;
}
#page-children a {
text-decoration: none;
}
/**
hide twixies
the specificity here is a hack because print styles
are getting loaded before the base styles. */
#comments-section.pageSection .section-header,
#comments-section.pageSection .section-title,
#children-section.pageSection .section-header,
#children-section.pageSection .section-title,
.children-show-hide {
padding-left: 0;
margin-left: 0;
}
.children-show-hide.icon {
display: none;
}
/* personal sidebar */
.has-personal-sidebar #content {
margin-right: 0px;
}
.has-personal-sidebar #content .pageSection {
margin-right: 0px;
}
}
-->
</style>
</head>
<body>
<h1>Requirements for doing a normal installation</h1>
<div class=3D"Section1">
<p>eZ Publish makes use of and depends on five important things:</p=
>
<ol>
<li>
<div>
A web server
</div></li>
<li>
<div>
The server-side PHP scripting engine
</div></li>
<li>
<div>
A database server
</div></li>
<li>
<div>
An image conversion system (optional)
</div></li>
<li>
<div>
The Zeta Components library
</div></li>
</ol>
<p>The first three things should be in place before an eZ Publish installat=
ion is deployed. The image conversion system is optional and is only needed=
if you're planning to use eZ Publish with images. The web server and the s=
erver-side PHP scripting engine have to run on the same machine. The databa=
se server may run on a different computer.</p>
<p>Please visit the <a href=3D"/display/EZP51/Requirements">requirements pa=
ge</a> to check if your platform fully supports installing eZ Publish, then=
come back for the extra details which follow.</p>
<h2 id=3D"Requirementsfordoinganormalinstallation-Webserver">Web server</h2=
>
<p>Currently, only the <a href=3D"http://httpd.apache.org/" class=3D"extern=
al-link" rel=3D"nofollow">Apache </a>web server is supported. On Linux/UNIX=
based systems, it is recommended to use the latest version of the 2.2.x br=
anch (applies also to cluster mode). Note that it must run in "prefork" mod=
e instead of "threaded" mode - the reason for this is because some of the l=
ibraries that PHP extensions use might not be thread-safe.</p>
<p>Nginx and Lighttpd are known to work as well but are currently not suppo=
rted. "Rewrite" rules for those web servers can be found online, f.e. on th=
e forums on <a href=3D"http://share.ez.no" class=3D"external-link" rel=3D"n=
ofollow">share.ez.no</a>.</p>
<p>On Windows, it is recommended to use MS IIS 7 or higher (with Microsoft =
URL Rewrite Module 1.1 or higher). Apache 2.x for Windows is not supported =
since it only exists in "threaded" mode.</p>
<h2 id=3D"Requirementsfordoinganormalinstallation-Server-sidePHPscriptingen=
gine">Server-side PHP scripting engine</h2>
<p>PHP is free software and can be downloaded from <a href=3D"http://www.ph=
p.net" class=3D"external-link" rel=3D"nofollow">http://www.php.net</a>. The=
full list of extensions needed can be found on the <a href=3D"/display/EZP=
51/Requirements">requirements page</a>. Info on some caveats can be found b=
elow:</p>
<h3 id=3D"Requirementsfordoinganormalinstallation-Zlibextension">Zlib exten=
sion</h3>
<p>Make sure that zlib support in PHP is enabled, otherwise the <a href=3D"=
/display/EZP51/The+setup+wizard">setup wizard</a> will not be able to unpac=
k downloaded packages during the installation process.</p>
<h3 id=3D"Requirementsfordoinganormalinstallation-DOMextension">DOM extensi=
on</h3>
<p>In most cases, <a href=3D"http://www.php.net/dom" class=3D"external-link=
" rel=3D"nofollow">DOM functions</a> are enabled by default as they are inc=
luded in the PHP core. However, some Linux distributions have PHP without c=
ompiled-in support for DOM. Instead, they provide DOM as a shared module in=
a separate RPM package called "php-xml".</p>
<h3 id=3D"Requirementsfordoinganormalinstallation-PHPCLI">PHP CLI</h3>
<p><a name=3D"eztoc131654_2_4" rel=3D"nofollow"></a>Since version 5.0, it i=
s necessary to have <a href=3D"http://www.php.net/manual/en/features.comman=
dline.php" class=3D"external-link" rel=3D"nofollow">PHP CLI</a> installed, =
as using php from the command line is needed during the setup process. Also=
, some features like <a href=3D"http://doc.ez.no/eZ-Publish/Technical-manua=
l/5.x/Features/Notifications" class=3D"external-link" rel=3D"nofollow">noti=
fications</a>, delayed search indexing, upgrade scripts, the collaboration =
system (content approval), clearing caches from within the command line, et=
c. will not work without php cli access.</p>
<h3 id=3D"Requirementsfordoinganormalinstallation-CURL">CURL</h3>
<p>It is recommended to enable <a href=3D"http://www.php.net/curl" class=3D=
"external-link" rel=3D"nofollow">CURL</a> support, otherwise some features =
like <a href=3D"http://doc.ez.no/eZ-Publish/Technical-manual/4.x/Reference/=
Configuration-files/site.ini/ProxySettings/ProxyServer" class=3D"external-l=
ink" rel=3D"nofollow">outbound connections via proxy</a> and <a href=3D"htt=
p://pubsvn.ez.no/nextgen/trunk/doc/features/3.8/ssl_enhancement_with_ezsoap=
client.txt" class=3D"external-link" rel=3D"nofollow">SSL support for eZSoap=
</a> will not work.</p>
<h3 id=3D"Requirementsfordoinganormalinstallation-PHPmemorylimitissue">PHP =
memory limit issue</h3>
<p>eZ Publish needs at least 64 MB of memory in order to complete the setup=
wizard. Normal operation requires about 32 MB. However, it is highly recom=
mended that you keep the 64 MB setting since eZ Publish consumes a lot more=
memory as you reindex the content, execute upgrade scripts, etc. Multiling=
ual sites will also require at least 64 MB.</p>
<p>As of PHP 5.2.1 and later, there is no need to change the default "<code=
>memory_limit</code>" setting (it is set to 128 MB by default), but make su=
re to check your setup anyway.</p>
<h3 id=3D"Requirementsfordoinganormalinstallation-PHPtimezone">PHP timezone=
</h3>
<p>You need to set the "<a href=3D"http://www.php.net/manual/en/ref.datetim=
e.php#ini.date.timezone" class=3D"external-link" rel=3D"nofollow">date.time=
zone</a>" value in the "<code>php.ini</code>" configuration file. If this s=
etting is not specified, you will most likely receive error messages like "=
It is not safe to rely on the system's timezone settings" when running eZ P=
ublish on PHP 5. The following example shows how the corresponding line in =
"<code>php.ini</code>" looks like:</p>
<div class=3D"preformatted panel" style=3D"border-width: 1px;">
<div class=3D"preformattedContent panelContent">=20
<pre>date.timezone =3D <timezone></pre>=20
</div>
</div>
<p>Refer to the <a href=3D"http://www.php.net/timezones" class=3D"external-=
link" rel=3D"nofollow">PHP documentation</a> for the list of supported time=
zones. Don't forget to restart Apache after editing "<code>php.ini</code>".=
</p>
<h3 id=3D"Requirementsfordoinganormalinstallation-"><a name=3D"eztoc131654_=
3" rel=3D"nofollow"></a></h3>
<h3 id=3D"Requirementsfordoinganormalinstallation-Sessionparameters">Sessio=
n parameters</h3>
<p>eZ Publish sessions are handled by the Symfony stack, through session ha=
ndlers. For that to be set up, additional <code>yml</code> config=
uration are required, which you can find in the <a href=3D"/display/EZ=
P51/Session">Session</a> chapter.</p>
<h3 id=3D"Requirementsfordoinganormalinstallation-Otherphpconfigurationsett=
ings">Other php configuration settings</h3>
<p>See the <a href=3D"http://symfony.com/doc/current/reference/requirements=
.html" class=3D"external-link" rel=3D"nofollow">Symfony documentation</a> f=
or the recommended <code>php.ini</code> settings for Symfony, as well as th=
e<a href=3D"https://confluence.ez.no/display/EZP/Virtual+host+example" clas=
s=3D"external-link" rel=3D"nofollow"> Vhost example</a> for the recommended=
<code>php.ini</code> settings for eZ Publish.</p>
<h2 id=3D"Requirementsfordoinganormalinstallation-ZetaComponentslibrary">Ze=
ta Components library</h2>
<p>Zeta Components (formerly eZ Components) is an enterprise-ready, general=
purpose library of PHP components which can be used used independently or =
together for PHP application development. They can be downloaded from <a hr=
ef=3D"http://ezcomponents.org/download" class=3D"external-link" rel=3D"nofo=
llow">http://ezcomponents.org/download</a>, or installed using different me=
thods such as Pear, Composer, Github etc... The <a href=3D"http://ezcompone=
nts.org/docs/install" class=3D"external-link" rel=3D"nofollow">online docum=
entation</a> has detailed instructions on installing them on the webserver.=
</p>
<p>The correct version of the Zeta Components required for running eZ Publi=
sh always comes bundled with eZ Publish package itself, so there is no need=
to install them separately.</p>
<p>It is possible to use a single instance of the Zeta Components library a=
nd share it between multiple installations of eZ Publish. Such configuratio=
n is complex and falls outside the scope of this document.</p>
<h2 id=3D"Requirementsfordoinganormalinstallation-Databaseserver">Database =
server</h2>
<p>eZ Publish stores miscellaneous data structures and actual content using=
a relational database. This means that a database server has to be availab=
le for eZ Publish at all times. Follow this link to the eZ Publish <a href=
=3D"http://doc.ez.no/eZ-Publish/Technical-manual/5.x/Installation/Normal-in=
stallation/Requirements-for-doing-a-normal-installation" class=3D"external-=
link" rel=3D"nofollow">requirements page</a> to find which database solutio=
ns eZ Publish is compatible with.</p>
<p>eZ Publish 5 requires a UTF-8 database and support for transactions, whi=
ch for MySQL means using the <code><a href=3D"http://dev.mysql.com/doc/refm=
an/5.0/en/innodb-storage-engine.html" class=3D"external-link" rel=3D"nofoll=
ow"> InnoDB</a></code> storage engine.</p>
<p>The setup wizard will automatically detect the database server during op=
eration of the setup wizard if it is running on the same computer that oper=
ates as web server.</p>
<p>Note that eZ Publish 5 does not support <a href=3D"http://doc.ez.no/eZ-P=
ublish/Technical-manual/5.x/Features/Clustering" class=3D"external-link" re=
l=3D"nofollow">clustering</a> mode for PostgreSQL databases. The clustering=
code is optimized for best performance on MySQL databases using the <code>=
<a href=3D"http://dev.mysql.com/doc/refman/5.0/en/innodb-storage-engine.htm=
l" class=3D"external-link" rel=3D"nofollow"> InnoDB</a></code> storage engi=
ne.</p>
<h3 id=3D"Requirementsfordoinganormalinstallation-MySQL">MySQL</h3>
<p>Even if you are not going to run eZ Publish in a clustered environment, =
the use of <code>InnoDB</code> is required. This storage engine makes it po=
ssible to use transaction-safe tables in a MySQL database. (Database transa=
ction support is enabled by default in eZ Publish. This feature makes the s=
ystem less vulnerable to database errors and inconsistencies due to aborted=
requests.) Contact your database administrator if you are unsure about whe=
ther <code>InnoDB</code> is available on your server.</p>
<p>MySQL can be tweaked with a lot of settings, but one setting which is re=
quired to set to a higher value is <a href=3D"http://dev.mysql.com/doc=
/refman/5.0/en/innodb-parameters.html#sysvar_innodb_buffer_pool_size" class=
=3D"external-link" rel=3D"nofollow">innodb_buffer_pool_size</a> , by defaul=
t it is set to 8mb, but it needs at least to be set to 128mb, or as the mys=
ql doc says up to 80% of system memory on dedicated database server.</p>
<p><strong>Known issue with running PHP5.3 on MySQL:</strong> Some peo=
ple (like Windows users with both IPv4 and IPv6 installed ) experience prob=
lems connecting to the database server using host names like "<code>localho=
st</code>"... If you experience problems, try using IPv4 address like "<cod=
e>127.0.0.1</code>". This is due to a connectivity problem when running PHP=
5.3 on MySQL. So, please replace the database server name "<code>localhost<=
/code>" with the IP address of the machine, or "<code>127.0.0.1</code>", wh=
ich is reserved for the local host.</p>
<h3 id=3D"Requirementsfordoinganormalinstallation-PostgresSQL">PostgresSQL<=
/h3>
<p>If you want to use PostgreSQL, make sure the "<code><a href=3D"http://ww=
w.postgresql.org/docs/8.3/static/pgcrypto.html" class=3D"external-link" rel=
=3D"nofollow">pgcrypto</a></code>" module is installed. On Linux/UNIX, you =
may need to install a separate package called "<code>postgresql-contrib</co=
de>" (refer to the <a href=3D"http://www.postgresql.org/docs/8.3/static/con=
trib.html" class=3D"external-link" rel=3D"nofollow">PostgreSQL documentatio=
n</a> for more information), which contains the "<code>pgcrypto</code>" mod=
ule. The "<code>pgcrypto</code>" module provides cryptographic functions fo=
r PostgreSQL, including the "digest" function, which is needed for eZ Publi=
sh. When setting up a PostgreSQL database for eZ Publish, you will have to =
register these functions in the database. Refer to the "Setting up a databa=
se" part of the "<span class=3D"confluence-link"> </span><a href=3D"/d=
isplay/EZP51/Installing+eZ+Publish+on+a+Linux-UNIX+based+system"><span clas=
s=3D"confluence-link">Installing eZ Publish on a Linux/UNIX based system</s=
pan></a>" and "<a href=3D"/display/EZP51/Installing+eZ+Publish+on+Windows">=
<span class=3D"confluence-link">Installing eZ Publish on Windows</span></a>=
" documentation pages (depending on the target OS) for more information.</p=
>
<h2 id=3D"Requirementsfordoinganormalinstallation-Imageconversionsystem(opt=
ional)">Image conversion system (optional)</h2>
<p>In order to resize, convert or modify images, eZ Publish needs to make u=
se of an image conversion system. One of the following software packages (b=
oth are free) can be used:</p>
<ul>
<li>
<div>
GD2 (comes with PHP)
</div></li>
<li>
<div>
ImageMagick (
<a href=3D"http://www.imagemagick.org" class=3D"external-link" rel=3D"nofol=
low">http://www.imagemagick.org</a>)
</div></li>
</ul>
<p>ImageMagick supports more formats than GD and usually produces better re=
sults (better scaling, etc.). The setup wizard will automatically detect th=
e pre-installed image conversion system(s).</p>
<p>The installation and setup of required software solutions (outlined abov=
e) is far beyond the scope of this document. Please refer to the homepage a=
nd documentation of the different software solutions.</p>
<h2 id=3D"Requirementsfordoinganormalinstallation-Limitationonsomefilesyste=
mswhenstoringlargenumberofcontentfiles">Limitation on some file systems whe=
n storing large number of content files</h2>
<p>eZ Publish stores all binary content (e.g. images, PDFs etc) on disc in =
<code>var/storage</code> using a similar folder structure to the content tr=
ee, creating one folder for each object. In most file systems used under Li=
nux (especially ext2 + ext3) there is a hard limit of 32.000 to the maximum=
number of sub-folders which can be created in one folder. This means that =
it is not possible to store more than 31999 objects under one parent object=
.</p>
<p>To get around this limitation without changing the file system, you can =
split your content tree so that you don't have more than 32k content files =
(example: images) in the same folder.</p>
<p>Other file systems support more file/folder entries per folder:</p>
<ul>
<li>ext4: 64.000</li>
<li>ReiserFS: roughly 1.2 million</li>
<li>ZFS: 2^48 (a really big number: 281474976710656)!</li>
</ul>
<p>Note that those filesystems might not be fully supported by eZ Publish, =
please check out the <a href=3D"/display/EZP51/Requirements">requirements p=
age</a> for details.</p>
<h2 id=3D"Requirementsfordoinganormalinstallation-eZPublishonNFSfilesystems=
">eZ Publish on NFS file systems</h2>
<p>Please be aware that it's not advisable to run eZ Publish on NFS file sy=
stems as you may experience issues. The cause of the issues may be performa=
nce, as NFS will slow down on heavy network traffic, slow access to files, =
or file access concurrency regarding file lock. Also, eZ Publish currently =
uses the <a href=3D"http://php.net/manual/en/function.flock.php" title=
=3D"flock() PHP function" class=3D"external-link" rel=3D"nofollow">flock()<=
/a> PHP function, which is not considered stable for NFS shares.</p>
<p>NFS should only be used to store distributed data such as cache, or bina=
ry files, in clustered environments.</p>
<h2 id=3D"Requirementsfordoinganormalinstallation-Networkconnectivity">Netw=
ork connectivity</h2>
<p>During execution of the setup wizard, the web server will need to downlo=
ad some content from the internet.</p>
<p>If the web server can not access directly the internet, or if it has to =
go through a proxy, workarounds have to be taken. See the <a href=3D"/displ=
ay/EZP51/The+setup+wizard">setup wizard</a> documentation page for possible=
workarounds</p>
</div>
</body>
</html>
------=_Part_4405_995039624.1485866399063--