Maintenance

First time setup

See first Deploying to Production.

The GitHub and GitLab needs a ssh key for authentication from translate.dokuwiki.org to push and pull. For more detail see Git interaction. Add the public keys via their web interface. Test connection with ssh -T [email protected] etc.

Regular maintenance

• Delete a plugin/template with bin/console dokuwiki:deleteRepo. There are some exceptions where the forked remote on https://github.com/dokuwiki-translate and https://gitlab.com/dokuwiki-translate needs a check as well.

• New core plugins need to be added in: src/Services/Repository/CoreRepository.php

Troubleshooting

Copied from wiki for an older version. Might be useless...

Logs

logfiles

• /var/log/apache2/translate-access.log ⇒ apache access logs
• /var/log/apache2/translate-error.log ⇒ apache error logs
• application/var/log/prod-2023-12-16.log ⇒ application log for production environment

Extensions, too many errors

if too many errors for plugin/template, then on https://translate.dokuwiki.org/plugin/dw2pdf/settings the latest status is shown

check if latest update and if latest error message provide any hints

php app/console dokuwiki:showInfo plugin dw2pdf

# or more general
php app/console dokuwiki:showInfo
php app/console dokuwiki:showInfo onlyerrors
php app/console dokuwiki:showInfo basicinfo

Reset lock, tmp folder, error count and last updated:

php app/console dokuwiki:softReset plugin dw2pdf

Wait for the 5 min update or trigger yourself (with detailed error message with -vvv option) by

php app/console dokuwiki:updateGit -vvv

check log files or the online settings page

Languages

connect to database:

mysql -p translate

list languages:

SELECT code from languageName;

check whether which plugins use the language code:

SELECT * FROM languageStats WHERE language='langCode';

delete all references between plugin and language code as languageStats.language is a foreign key to languageName.code:

DELETE FROM languageStats WHERE language='langCode';

delete language based on language code:

DELETE FROM languageName where code='langCode';

update language Name:

update languageName SET name = 'Min Nan Chinese' WHERE code = 'nan' LIMIT 1;