If it is not explicitly told in following recipe, setting up services are described for Ubuntu 20.04 server, but applications are described for Xubuntu 20.04 workstation. If you use different Ubuntu version or Linux distribution, settings as well as content, names and places of configuration files may be different!
Got it.

XWiki iestatīšana

Saturs

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.

  1. Atver failu /etc/mysql/my.cnf un izmaina rindu:

    max_allowed_packet = 64M
  2. Alternatīva ir pielikumu glabāšana failu sistēmā (skat. tālāk).

Noklusēto iestatījumu maiņa

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

  2. Failā ../xwiki/WEB-INF/xwiki.cfg: izmaina iestatījumus 

    ...
    xwiki.plugin.watchlist.automaticwatch=none
    ...
  3. Izmaina .../WEB-INF/classes/logback.xml (piemēram, /var/lib/tomcat9/webapps/xwiki/WEB-INF/classes/logback.xml) failu:
    1. 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>
    2. 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"/>
    3. 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"/>
    4. 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"/>
  4. Izvēlas cilni Preferences un pārliecinās par iestatījumu atbilstību, ja nepieciešams, veic izmaiņas, piemēram:
    1. 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).
  5. Šajā pašā cilnē atver sadaļu Registration un uzstāda vērtību: "Use email verification"="Yes".
    1. 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.
    2. 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

core.hierarchyMode=parentchild

Datu bāzes nosaukuma maiņa

  1. Failā .../WEB-INF/hibernate.cfg.xml nomaina rindu:

    ...
    <property name="connection.url">jdbc:mysql://localhost/otherxwiki</property>
    ...
  2. Failā .../WEB-INF/xwiki.cfg izmaina rindu:

    ...
    xwiki.db=otherxwiki
  3. Pārliecinās, ka .../WEB-INF/lib mapē ir attiecīgās datu bāzes draiveris

Pielikumu saglabāšana failu sistēmā

  1. Pārstata pielikumu glabāšanu nevis datu bāzē, bet failu sistēmā.
  2. 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

    Error number 4001 in 4: Error while evaluating velocity template commentfield.vm

    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


  
Tags XWiki Pārvaldība Konfigurācija
Created by Valdis Vītoliņš on 2013-11-09 13:21
Last modified by Valdis Vītoliņš on 2024-09-17 19:16
 
Xwiki Powered
Creative Commons Attribution 3.0 Unported License