Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tigase/tigase-database-migrator

(M) Tool allowing easy migration data to Tigase XMPP Server from other XMPP servers
https://github.com/tigase/tigase-database-migrator

database jabber mysql tigase-database-migrator tigase-xmpp-server xmpp

Last synced: 2 months ago
JSON representation

(M) Tool allowing easy migration data to Tigase XMPP Server from other XMPP servers

Host: GitHub
URL: https://github.com/tigase/tigase-database-migrator
Owner: tigase
License: agpl-3.0
Created: 2019-05-22T09:31:02.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2023-11-20T23:29:25.000Z (about 1 year ago)
Last Synced: 2024-05-01T09:53:40.016Z (9 months ago)
Topics: database, jabber, mysql, tigase-database-migrator, tigase-xmpp-server, xmpp
Language: Java
Homepage: https://tigase.net
Size: 650 KB
Stars: 4
Watchers: 7
Forks: 2
Open Issues: 1
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: COPYING

Awesome Lists containing this project

README

![database-migrator screenshot](assets/images/db-migrator.png)

![Tigase Logo](assets/images/tigase-logo.png) ![Build Status](https://tc.tigase.net/app/rest/builds/buildType:(id:TigaseDatabaseMigrator_Build)/statusIcon)

# Tigase Database Migrator

Tigase Database Migrator is component allowing migration of different types of data from various XMPP servers.
Currently supports following servers and data:

* `ejabberd`
* User data (authentication, roster)
* MUC (multi user chat)
* PubSub

# Usage

Complete guide available in [documentation](https://docs.tigase.net/tigase-database-migrator/1.0.0/Tigase_Database_Migrator_Guide/html/)

Migrator is a command-line utility. Main class: `tigase.db.converter.Converter`, if executed without any parameters will display help with all parameters explained:

```
$ java -cp jars/*:. tigase.db.converter.Converter [options]
```

## Converter options

Following options are supported

* `-I` or `--interactive` (*optional*) - Enable interactive mode, which will result in prompting for missing parameters
* `-R value` or `--repository-class=value` - allows specifying `DataRepository` implementation used for reading data from source; must implement tigase.db.DataSource (default: `tigase.db.jdbc.DataRepositoryImpl`)
* `-S value` or `--source-uri=value` - URI of the source do the data: `jdbc:xxxx:///…`
* `-T value` or `--server-type=value` - type of the server from which import will be performed, possible values: [ejabberd, ejabberd_new]
* `-D value` or `--destination-uri=value` - URI of the destination for the data: `jdbc:xxxx:///…`
* `-C value` or `--components=value` (*optional*) - additional component beans names that should be activated
* `-H value` or `--virtual-host=value` - allows specifying Virtual-host / domain name used by source installation (for example in case of old ejabberd installations)

# Support

When looking for support, please first search for answers to your question in the available online channels:

* Our online documentation: [Tigase Docs](https://docs.tigase.net/)
* Our online forums: [Tigase Forums](https://help.tigase.net/portal/community)
* Our online Knowledge Base [Tigase KB](https://help.tigase.net/portal/kb)

If you didn't find an answer in the resources above, feel free to submit your question to either our
[community portal](https://help.tigase.net/portal/community) or open a [support ticket](https://help.tigase.net/portal/newticket).

# Downloads

Migrator is included in every distribution of Tigase XMPP Server. Dedicated binaries can be downloaded from our [Maven repository](https://maven-repo.tigase.net/#artifact/tigase/tigase-database-migrator)

# Compilation

It's a Maven project therefore after cloning the repository you can easily build it with:

```bash
mvn -Pdist clean install
```

# License

Official Tigase repository is available at: https://github.com/tigase/tigase-database-migrator/.

Licensed under AGPL License Version 3. Other licensing options available upon request.