XWiki iestatīšana
Must prepare before: XWiki uzstādīšana no ražotāja vietnes or XWiki uzstādīšana ar APT | Should prepare further: XWiki skaņošana |
Saturs
- Datu bāzes paketes izmēra palielināšana
- Noklusēto iestatījumu maiņa
- Vecāka — bērna attiecību iestatīšana
- Datu bāzes nosaukuma maiņa
- Pielikumu saglabāšana failu sistēmā
- Jaunu iestatījumu izveide
- Kļūdu risināšana
- Saites
Datu bāzes paketes izmēra palielināšana
Ja pielikumus glabā MySQL datu bāzē, tad failu izmēru ierobežo MySQL paketes izmērs. Pielikumus glabā Base64 kodējumā, tāpēc datu bāzē fails ir 1,5× lielāks par oriģinālu.
Atver failu /etc/mysql/my.cnf un izmaina rindu:
max_allowed_packet = 64M- Alternatīva ir pielikumu glabāšana failu sistēmā (skat. tālāk).
Noklusēto iestatījumu maiņa
Izmaina sīkfailu šifrēšanas atslēgas failā ../xwiki/WEB-INF/xwiki.cfg:
xwiki.authentication.validationKey=...
xwiki.authentication.encryptionKey=...uz tāda paša garuma patvaļīgi izvēlētu tekstu
Failā ../xwiki/WEB-INF/xwiki.cfg: izmaina iestatījumus
...
xwiki.plugin.watchlist.automaticwatch=none
...- Izmaina .../WEB-INF/classes/logback.xml (piemēram, /var/lib/tomcat9/webapps/xwiki/WEB-INF/classes/logback.xml) failu:
Pēc noklusēšanas XWiki žurnālu raksta standarta izejā, kuru lietojumu serveris pāradresē uz /var/log/syslog failu. Ja negrib to piesārņot ar XWiki ziņojumiem, norāda:
<appender name="FILE" class="ch.qos.logback.core.FileAppender">
<file>/var/log/tomcat9/xwiki.log</file>
<encoder>
<pattern>%d [%t] %-5p %-30.30c{2} - %m %n</pattern>
</encoder>
</appender>
...
<root level="warn">
<appender-ref ref="FILE"/>
</root>Lai novērstu daudzus brīdinājumus Deprecated usage legacy-style HQL ordinal parameters (`?`); use JPA-style ordinal parameters (e.g., `?1`) instead... par novecojuša API izmantošanu, izmaina rindu:
<logger name="com.xpn.xwiki" level="warn"/>uz
<logger name="com.xpn.xwiki" level="error"/>Lai novērstu Going to buffer response body of large or unknown size. Using getResponseBodyAsStream instead is recommended, pievieno rindu:
...
<!-- Surpressed custom warnings -->
...
<logger name="org.apache.commons.httpclient.HttpMethodBase" level="error"/>Lai novērstu No Unicode mapping for CID+132 (132) in font KMJJJK+Wingdings-Regular un Using fallback font 'LiberationSans' for 'TimesNewRomanPS-BoldItalicMT brīdinājumus, pievieno rindu:
<logger name="org.apache.pdfbox.pdmodel.font" level="error"/>
- Izvēlas cilni Preferences un pārliecinās par iestatījumu atbilstību, ja nepieciešams, veic izmaiņas, piemēram:
- Sadaļā Editing- Default Editor to use ieraksta vērtību "Text" (tas nozīmē, ka pēc noklusēšanas visiem lietotājiem rediģēšanas funkcija atvērs "Wiki", nevis "WYSIWYG" rediģēšanas režīmu).
- Šajā pašā cilnē atver sadaļu Registration un uzstāda vērtību: "Use email verification"="Yes".
- Aiziet uz sākumlapu http://localhost/xwiki/bin/view/Main/WebHome un labajā navigācijas joslā klikšķina uz linku Admin Center. Izvēlas linku Users un reģistrē dažus jaunus (ne admin) lietotājus.
- Ja vēlas, uzliek Multi language un valodas.
Vecāka — bērna attiecību iestatīšana
Ja izmanto XWiki vecāka — bērna lauku, izmaina faila .../xwiki/xwiki.properties lauka vērtību
Datu bāzes nosaukuma maiņa
Failā .../WEB-INF/hibernate.cfg.xml nomaina rindu:
...
<property name="connection.url">jdbc:mysql://localhost/otherxwiki</property>
...Failā .../WEB-INF/xwiki.cfg izmaina rindu:
...
xwiki.db=otherxwiki- Pārliecinās, ka .../WEB-INF/lib mapē ir attiecīgās datu bāzes draiveris
Pielikumu saglabāšana failu sistēmā
- Pārstata pielikumu glabāšanu nevis datu bāzē, bet failu sistēmā.
Ja nepieciešams, izmaina Tomcat iestatījumus, lai tas ļautu sekot saitēm. Failā /etc/tomcat9/context.xml nomaina rindu, pievienojot papildu atribūtu:
<Context">uz
<Context>
<Resources allowLinking="true" />
Jaunu iestatījumu izveide
Lai uzsāktu XWiki inicializācijas vedni, izdzēš datu bāzi un failus mapē /var/cache/tomcat9/Catalina/localhost/xwiki/extension (vai tur, kur ir norādīts environment.permanentDirectory parametrs xwiki.properties failā.
Kļūdu risināšana
Spiežot pogu Pievienot komentāru parāda kļūdu
Failā /var/lib/tomcat9/webapps/xwiki/skins/flamingo/commentfield.vm atkomentē rindas:
#template('display_macros.vm') > ##!!!#template('display_macros.vm')
#initRequiredSkinExtensions() > ##!!!#initRequiredSkinExtensions()
#getRequiredSkinExtensions($requiredSkinExtensions) > ##!!!#getRequiredSkinExtensions($requiredSkinExtensions)
Saites
- http://platform.xwiki.org/xwiki/bin/view/Features/DistributionWizard
- http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Attachments
- http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Configuration
Created by Valdis Vītoliņš on 2013-11-09 13:21
Last modified by Valdis Vītoliņš on 2024-09-17 19:16