The Convergence Server is the main server side component of the Convergence Realtime Collaboration Framework. Convergence enables developers to rapidly integrate realtime collaboration directly into their applications.
The core Convergence capability is composed of multiple individual projects that are released together. To simplify things, there is a central project that is used for issues, project planning, and road mapping. To report an issue please use the convergence-project repository.
- Scala: The Convergence Server is developed primarily in Scala.
- SBT: SBT is the build tool used by the Convergence Server.
- Akka: Akka is the main development framework used by the Convergence Server. Akka provides the primary ability for multiple Convergence Servers to cluster together, providing horizontal scalability, and high availability.
- OrientDB: Orient DB is used as the backing database.
- Google Protocol Buffers: Protocol Buffers are used as the communications protocol for realtime collaboration over Web Sockets.
The following development tools are required to build the Convergence Server:
The standard SBT tasks can be used to compile and test the server.
sbt compile
sbt test
The main entry point of the Convergence Server is the com.convergencelabs.server.ConvergenceServer
class. This is a good place to start if you are new to the code base.
The Convergence Server uses the SBT Native Packager to build its binary distribution. To stage the build run:
sbt dist/stage
The resultant build will be located in target/universal/stage
.
Refer to the SBT Native Packager Documentation for additional build targets.
The Convergence Dev Server runs an all-in-one instance of Convergence along with an embedded OrientDB Database. The Convergence Dev Server will start up and OrientDB database and initialize it. It will also start a backend node, a rest API, and a realtime API. In order to better reflect a typical deployment, th Convergence Dev Server actually starts up three instances of the Convergence Server (cluster see, backend, and api server). These three instances are tied together using Akka clustering. By default ports 2551, 2552, and 2553 are used by the akka remoting subsystem (each port being used by one of the three ConvergenceServer instances).
By default, when the Convergence Dev Server successfully starts, it will provide two endpoints:
- Realtime API: http://localhost:8080
- Rest API: http://localhost:8081
The Convergence Dev Server can be run from your IDE of choice by executing the following main class:
com.convergencelabs.server.dev.ConvergenceDevServer
By default, the Convergence Dev Server will delete the OrientDB database(s) when it starts up. IF you would like to retain data between runs set the following java property:
-Dconvergence.dev-server.persistent = true
In order to use the OrientDB web interface, the OrientDB Studio plugin must be loaded. The plugin is a dependency of the Convergence Server project but must be copied into the "target/orientdb/plugins" directory. As a convenience, there is an SBT task available to do this. To initialize the Orient DB plugins run the following SBT Command:
sbt orientDbPlugins
The embedded OrientDB can be accessed at: http://localhost:2480/
The credentials root
/ password
can be used to access the databases.
This project uses the SBT Native Packager to build a binary distribution. The distribution can be built by running to following command:
sbt dist/stage
The distribution will be located in distribution/target/universal/stage
. You can run the server by opening a terminal in this directory and executing:
bin/convergence-server
You will need a running OrientDB Server. The easiest way to accomplish that is using the following docker command:
docker run --rm \
--name orientdb \
-p 2424:2424 \
-p 2480:2480 \
-e ORIENTDB_ROOT_PASSWORD=password \
orientdb:3.0.37
Convergence Labs provides several channels for support:
- Please use the Convergence Community Forum for general and technical questions, so the whole community can benefit.
- For paid dedicated support or custom development services, contact us directly.
- Chat with us on the Convergence Public Slack.
- Email [email protected] for all other inquiries.
The Convergence Server is licensed under the GNU Public License v3 (GPLv3) license. Refer to the LICENSE for the specific terms and conditions of the license.
The Convergence Server is also available under a Commercial License. If you are interested in a non-open source license please contact us at Convergence Labs.