109Troubleshoots - amagerard/Wiki GitHub Wiki

HOME

Return to the list of wikis

RedHat/Xwiki

1- Network 2- Java 3- Tomcat 4- Mariadb 5- Xwiki
6- Nginx 7- selinux 8- GnomeShell 9 Troubleshoots

9. TroubleShoots.

9.1 Sunday March 9, 2025.

This is the Redhat 9.5 version.
Nginx replaces Apache.
Many errors have been corrected.
java-21-openjdk-headless.
Tomcat 10.1.36.
Xwiki 17.1.0.

9.2 Tuesday February 25, 2025.

9.2.1 Updated Almalinux 9.5.

Xwiki supports Java 21 version.
dnf remove java-latest-openjdk-headless
dnf install java-21-openjdk-headless
systemctl restart tomcat

9.2.2 Update of httpd install ssl.conf.

rm /etc/httpd/conf.d/ssl.conf
systemctl restart httpd

9.2.3 Updated to tomcat 9.0.100.

You will no longer have enough free space on the partition /opt.

lvextend -L+2G /dev/vgl0/opt  
resize2fs /dev/vgl0/opt  

systemctl stop tomcat  
cd /opt  
tar -cvf /opt/mybackup_tomcat.tar  tomcat  
cd /opt/tomcat/webapps  
tar -cvf /opt/mybackup_xwiki.tar xwiki  
mv /opt/tomcat  /opt/tomcat_backup  
  
mkdir /opt/tomcat  
chown -R tomcat:tomcat tomcat  
  
su - tomcat  
wget -P /opt/tomcat https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.100/bin/apache-tomcat-9.0.100.tar.gz  
tar xzvf /opt/tomcat/apache-tomcat-9.0.100.tar.gz -C /opt/tomcat --strip-components=1  
chmod +x /opt/tomcat/bin/*.sh  
rm /opt/tomcat/apache-tomcat-9.0.100.tar.gz  
echo "export CATALINA_HOME="/opt/tomcat/"" >> /opt/tomcat/.bashrc  
cp /opt/tomcat/conf/tomcat-users.xml /opt/tomcat/conf/tomcat-users.xml_backup  
cp /opt/tomcat/webapps/manager/META-INF/context.xml    /opt/tomcat/webapps/manager/META-INF/context.xml_backup  
cp /opt/tomcat/webapps/manager/META-INF/context.xml    /opt/tomcat/webapps/manager/META-INF/context.xml_backup  
  
cp /opt/tomcat_backup/conf/tomcat-users.xml  /opt/tomcat/conf/tomcat-users.xml  
cp /opt/tomcat_backup/webapps/manager/META-INF/context.xml /opt/tomcat/webapps/manager/META-INF/context.xml  
cp /opt/tomcat_backup/webapps/host-manager/META-INF/context.xml  /opt/tomcat/webapps/host-manager/META-INF/context.xml  
exit  
  
systemctl start tomcat  
  
Check tomcat service.  
Ip xwiki server : 192.168.60.44  
http://192.168.60.44:8080  
server status:  
username=admin  
password=D51mbtAB49!  
  
  
cd /opt/tomcat/webapps  
tar -xvf /opt/mybackup_xwiki.tar xwiki  
systemctl restart tomcat  
  
Check xwiki.  
Ip xwiki server : 192.168.60.44  
http://192.168.60.44:8080/xwiki

9.2.4 Updated from xwiki 15.10.1 to 16.10.4.

Tomcat version is 9.0.100.
Java version is 21.

systemctl stop tomcat  
systemctl stop httpd  
systemctl stop mariadb  
  
cd /opt  
tar -cvf /opt/mybackup_tomcat.tar  tomcat  
cd /opt/tomcat/webapps  
tar -cvf /opt/mybackup_xwiki.tar xwiki  
mkdir tomcat_backup  
tar -xvf mybackup_tomcat.tar  -C /opt/tomcat_backup  --strip-components=1  
  
su - tomcat  
cd webapps  
rm -rf xwiki  
  
wget -P /opt/tomcat `https://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-war/16.10.4/xwiki-platform-distribution-war-16.10.4.war`  
mv /opt/tomcat/xwiki-platform-distribution-war-16.10.4.war /opt/tomcat/webapps/xwiki.war  
exit  
  
systemctl start tomcat  
wait one minute.  
systemctl stop tomcat  
  
su - tomcat  
rm /opt/tomcat/webapps/xwiki.war  
  
  
cp /opt/tomcat/webapps/xwiki/WEB-INF/hibernate.cfg.xml /opt/tomcat/webapps/xwiki/WEB-INF/hibernate.cfg.xml_backup  
cp /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.cfg  /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.cfg_backup  
cp /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.properties  /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.properties_backup  
cp /opt/tomcat/webapps/xwiki/WEB-INF/web.xml  /opt/tomcat/webapps/xwiki/WEB-INF/web.xml_backup  
  
cp /opt/tomcat_backup/webapps/xwiki/WEB-INF/hibernate.cfg.xml /opt/tomcat/webapps/xwiki/WEB-INF/hibernate.cfg.xml  
cp /opt/tomcat_backup/webapps/xwiki/WEB-INF/xwiki.cfg  /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.cfg  
cp /opt/tomcat_backup/webapps/xwiki/WEB-INF/xwiki.properties  /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.properties  
cp /opt/tomcat_backup/webapps/xwiki/WEB-INF/web.xml  /opt/tomcat/webapps/xwiki/WEB-INF/web.xml  
  
wget -P /opt/tomcat/webapps/xwiki/WEB-INF/lib/ `https://repo1.maven.org/maven2/org/mariadb/jdbc/mariadb-java-client/3.5.2/mariadb-java-client-3.5.2.jar`  
  
vi /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.cfg  
xwiki.store.migration=1  
xwiki.store.migration.exitAfterEnd=0  
xwiki.store.migration.databases=all  
  
exit  
  
systemctl start tomcat  
systemctl start httpd  
systemctl start mariadb  
  
http://192.168.60.44:8080/xwiki  
Open a session.  
  
Ugrade  XWiki Standard Flavor tor 16.4  
Possible conflicts with old version.  
Choose automatically  
  
A the end.  
systemctl stop tomcat  
The services takes a few minutes to stop.  
  
su - tomcat  
vi /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.cfg  
xwiki.store.migration=0  
#xwiki.store.migration.exitAfterEnd=0  
#xwiki.store.migration.databases=all  
exit  
  
systemctl start tomcat  
  
Ip xwiki server : 192.168.60.44  
`http://192.168.60.44:8080/xwiki`  
Open a session.

9.2.5 Updated from xwiki 16.10.4 to 17.1.0

Tomcat version is 9.0.100.
Java version is 21

systemctl stop tomcat  
systemctl stop httpd  
  
Do a backup of your database.  
mariadb-dump -u root -p xwiki > /home/teacher/backup_xwiki_2025-03-01.sql  
systemctl stop mariadb  
  
cd /opt  
tar -cvf /opt/mybackup_tomcat.tar  tomcat  
cd /opt/tomcat/webapps  
tar -cvf /opt/mybackup_xwiki.tar xwiki  
mkdir tomcat_backup  
tar -xvf mybackup_tomcat.tar  -C /opt/tomcat_backup  --strip-components=1

Before .
9.2.5.1- Upgrade tomcat from 9.0.100 to 10.1.36.

rm -rf /opt/tomcat  
  
mkdir /opt/tomcat  
chown -R tomcat:tomcat tomcat  
su - tomcat  
wget -P /opt/tomcat https://dlcdn.apache.org/tomcat/tomcat-10/v10.1.36/bin/apache-tomcat-10.1.36.tar.gz  
tar xzvf /opt/tomcat/apache-tomcat-10.1.36.tar.gz -C /opt/tomcat --strip-components=1  
chmod +x /opt/tomcat/bin/*.sh  
rm /opt/tomcat/apache-tomcat-10.1.36.tar.gz  
echo "export CATALINA_HOME="/opt/tomcat/"" >> /opt/tomcat/.bashrc  
cp /opt/tomcat/conf/tomcat-users.xml /opt/tomcat/conf/tomcat-users.xml_backup  
cp /opt/tomcat_backup/conf/tomcat-users.xml  /opt/tomcat/conf/tomcat-users.xml  
cp /opt/tomcat/webapps/manager/META-INF/context.xml    /opt/tomcat/webapps/manager/META-INF/context.xml_backup  
cp /opt/tomcat/webapps/host-manager/META-INF/context.xml  /opt/tomcat/webapps/host-manager/META-INF/context.xml_backup  
cp /opt/tomcat_backup/webapps/manager/META-INF/context.xml /opt/tomcat/webapps/manager/META-INF/context.xml  
cp /opt/tomcat_backup/webapps/host-manager/META-INF/context.xml  /opt/tomcat/webapps/host-manager/META-INF/context.xml  
exit  
systemctl restart tomcat  
Ip xwiki server : 192.168.60.44  
http://192.168.60.44:8080  
server status:  
username=admin  
password=D51mbtAB49!  
  
systemctl stop tomcat

9.2.5.2- Upgrade from xwiki 16.10.4 to 17.1.0.

su - tomcat  
  
wget -P /opt/tomcat https://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-war/17.1.0/xwiki-platform-distribution-war-17.1.0.war  
mv /opt/tomcat/xwiki-platform-distribution-war-17.1.0.war /opt/tomcat/webapps/xwiki.war  
exit  
  
systemctl start tomcat  
wait one minute.  
systemctl stop tomcat  
  
su - tomcat  
rm /opt/tomcat/webapps/xwiki.war  
  
cp /opt/tomcat/webapps/xwiki/WEB-INF/hibernate.cfg.xml /opt/tomcat/webapps/xwiki/WEB-INF/hibernate.cfg.xml_backup  
cp /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.cfg  /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.cfg_backup  
cp /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.properties  /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.properties_backup  
cp /opt/tomcat/webapps/xwiki/WEB-INF/web.xml  /opt/tomcat/webapps/xwiki/WEB-INF/web.xml_backup  
  
cp /opt/tomcat_backup/webapps/xwiki/WEB-INF/hibernate.cfg.xml /opt/tomcat/webapps/xwiki/WEB-INF/hibernate.cfg.xml  
cp /opt/tomcat_backup/webapps/xwiki/WEB-INF/xwiki.cfg  /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.cfg  
cp /opt/tomcat_backup/webapps/xwiki/WEB-INF/xwiki.properties  /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.properties  
cp /opt/tomcat_backup/webapps/xwiki/WEB-INF/web.xml  /opt/tomcat/webapps/xwiki/WEB-INF/web.xml  
  
wget -P /opt/tomcat/webapps/xwiki/WEB-INF/lib/ https://repo1.maven.org/maven2/org/mariadb/jdbc/mariadb-java-client/3.5.2/mariadb-java-client-3.5.2.jar  
  
  
vi /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.cfg  
xwiki.store.migration=1  
xwiki.store.migration.exitAfterEnd=0  
xwiki.store.migration.databases=all  
exit  
  
systemctl start tomcat  
systemctl start httpd  
systemctl start mariadb  
  
Ip xwiki server : 192.168.60.44  
http://192.168.60.44:8080/xwiki  
Open a session.  
  
Update XWiki Standard Flavor tor 17.1  
Possible conflicts with old version.  
choose automatically  
  
A the end.  
systemctl stop tomcat  
The services takes a few minutes to stop.  
  
su - tomcat  
vi /opt/tomcat/webapps/xwiki/WEB-INF/xwiki.cfg  
xwiki.store.migration=0  
#xwiki.store.migration.exitAfterEnd=0  
#xwiki.store.migration.databases=all  
exit  
  
systemctl start tomcat  
  
Ip xwiki server : 192.168.60.44  
http://192.168.60.44:8080/xwiki  
Open a session.