XWiki iestatīš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.

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

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

• 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