NOTE: Please be aware this documentation isn't necessary in step with the current code. Consider contributing by updating it with your findings!
Wave in a Box is delivered as a Java application. Installation comprises installing the server code and (optionally) configuring federation with XMPP.
Server installation
Getting Java
Ensure you have Java 8 installed before attempting to install Wave in a Box
From release package
Apache Wave releases can soon be downloaded from the release repository, and are packaged for UNIX and Windows systems.
$ wget https://dist.apache.org/repos/dist/dev/incubator/wave/0.4.0-rc10/apache-wave-bin-0.4.0-incubating.tar.bz2 $ tar -jxf apache-wave-bin-0.4.tar.gz $ cd apache-wave-bin-0.4.0-incubating
From source package
Should you want to build from source please use Java 7 for now, as changes in the latest JDK broke the build of this release.
$ wget https://dist.apache.org/repos/dist/dev/incubator/wave/0.4.0-rc10/apache-wave-src-0.4.0-incubating.tar.bz2 $ tar -jxf apache-wave-src-0.4.tar.gz $ cd apache-wave-src-0.4.0-incubating $ ant
You can find the most up-to-date (but possibly unstable) sourcecode at https://github.com/apache/incubator-wave or git://git.apache.org/incubator-wave.git.
Running the server
Run the server with
$ ./run-server.sh
Running the webclient
Once you have followed the instructions on this page about how to get the server running you should be able to reach the web client by going to: http://localhost:9898
when running locally or by contacting port 9898 on the machine running the server
Further steps
This will get you as far as having a basic Wave server for testing and playing, but other steps should or could be taken:
- Using SSL certificates
- Using MongoDB as data store
- Use Federation to contact with other Wave servers
- Enable Wave Extensions
You can find the most up-to-date documentation at https://github.com/apache/incubator-wave-docs or git://git.apache.org/incubator-wave-docs.git.
2 Comments
Yuri Zelikov
I think the RC10 release requires jdk 1.7.
Andreas 'count' Kotes
Hm. Tested and working with both Oracle + OpenJDK Java 8, just building needs Java 7.
(only kicked the tires, though)