Warning

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

XWikiPreferences iestatīšana

  1. Atver http://localhost:8080/xwiki/bin/admin/XWiki/XWikiPreferences
  2. Izvēlnē Lietotāji un grupas, Grupas, Tiesības iestata
    Att01.png

  3. Izvēlnē Lietotāji un grupas, Lietotāji, Tiesības iestata
    Att02.png

  4. Izvēlnē Lietotāji un grupas, Reģistrācija ieslēdz:
    1. Ieslēgt lauku validāciju ar JavaScript 
    2. Ieslēgt pieteikšanās pogu
  5. Paplašinājumu pārvaldnieks pievieno spraudņus:
    1. Map Macro
    2. ShowHide Macro
  6. Izskats un uzvedība, Tēmas norāda:
    1. Krāsu tēma OdoTheme
    2. Apdare OdoTheme
  7. Izskats un uzvedība, Paneļi norāda:
    1. Labā kolonna
    2. Labās puses paneļa platums: Vidējs
    3. Paneļi labajā pusē: Custom.PanelServices,Custom.PanelContent
  8. Izskats un uzvedība, Izskats norāda:
    1. Rādīt lapas anotācijas:
    2. Virsraksts: $tdoc.getRenderedTitle("plain/1.0")
    3. Vietas autortiesības:
      <a rel="license" href="http://creativecommons.org/licenses/by/3.0/deed.${context.language}"><img alt="Creative Commons Attribution 3.0 Unported License" src="/xwiki/bin/download/Custom/WebHome/cc-by.png"/></a>

    4. Versija:
      <a href="/Services/XWiki"><img style="padding-bottom: 2px;" alt="Xwiki Powered" src="/xwiki/bin/download/Custom/WebHome/XWiki-powered.png"/></a>

  9. Saturs, Valodu atbalsts norāda:
    1. Daudzvalodu:
    2. Atbalstītās valodas: Angļu, Vācu, Latviešu, Krievu
    3. Datuma formāts: yyyy-MM-dd HH:mm
  10. Redigēšana iestata:
    1. Noklusētais redaktors: Text
  11. Redigēšana, Sintakses iestata:
    1. Noklusētā sintakse: XWiki 2.1
    2. Liegtās sintakses: Plain 1.0, XDOM, XHTML 1.0, XWiki 2.0

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/mysql.conf.d/mysqld.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. Lai novērstu WARN o.a.v.introspection - Deprecated usage of method [com.xpn.xwiki.api.DeprecatedContext.getLocale] in xwiki... un WARN o.a.v.introspection - Deprecated usage of getter [com.xpn.xwiki.api.Document.getName] in xwiki..., pievieno rindu:

    <logger name="org.apache.velocity.introspection" level="error" />
  5. 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).
  6. Š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

    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 11:21
Last modified by Valdis Vītoliņš on 2025-05-20 11:30
XWiki Powered
Creative Commons Attribution 3.0 Unported License