Component configuration can be handled via file-based configuration file (etc/init.properties
) or via admin ad-hoc commands (either via XMPP client or web AdminUI) and persisting it to database. However, file-based configuration wasn’t persisted to repository if that was the only method to configure the server. Version 7.1.4 introduces a way to force persisting items configuration to repository by introducing Persist item configuration
administrative command.
It affects following components:
It’s possible to execute this command in two ways:
Next major version of Tigase XMPP Server - 8.0.0 - changes how configuration is handled focusing on ad-hoc configuration of Items therefore it’s essential to persist configuration of repository items (external component connections, vhosts, http-api keys, etc…) before upgrading to version 8.0.0!
To persist items to repository using web AdminUI you should navigate to http://<machine_hostname>:8080/admin/
url. Afterwards open group Configuration
from the menu on the left. In the list of commands you should click on:
Persist API keys items configuration
to store HTTP-API component’s api-keysPersist item configuration
on all remaining components which configuration items should be saved.After correctly storing items a confirmation screen with Operation successful
message should appear.
XMPP Client supporting service discovery and admin ad-hoc commands should be used. Each client implements user interface related to those functions slightly differently however general idea stays the same - to persist configuration to the database you should:
--admins=
configuration line)to store HTTP-API component’s api-keys you should:
HTTP server integration module
component (it should has address http.<VHost>
)Persist API keys items configuration
commandto persist data of all remaining components:
find appropriate component:
VHost Manager
(it should has address: vhost-man@<VHost>
Configuration management
(it should has address: basic-conf@<VHost>
External component
(it should has address: ext@<VHost>
Persist item configuration
After correctly storing items a confirmation screen with Operation successful
message should appear.