blob: c0eeca96ed35dc30d81efb9159fbc42bf2b23935 [file] [log] [blame]
"Wave in a Box" (WIAB) project is a stand alone wave server and rich web client that serves as an Apache Wave reference implementation.
Apache Wave site:
This project lets developers and enterprise users run wave servers and host waves on their own hardware. And then share those waves with other wave servers.
This code requires Java 6. If you are on MacOS 10.5 (Leopard) or earlier,
you'll need to install it from -
MacOS 10.5 ships with Java 5 by default.
Wave in a Box uses Ant to build. To run the tests, run:
ant get-third-party
ant test
To build the client and server without tests (faster) run:
ant compile-gwt dist-server
It will be created in dist/waveinabox-X.Y.jar.
You need to configure your instance before you can use it. To create a default simple configuration run:
ant -f server-config.xml
To override default values pass them to the ant script.
For example, to override wave_server_domain run : ant -f server-config.xml
Take a look at the server.config.example to learn about configuration and possible/default values.
The server can be started (on Linux/MacOS) by running
Or, you can run the server from the compiled classes with ant:
ant run-server
The web client will be accessible at http://localhost:9898/
To learn more about Wave in a Box and Wave Federation Protocol:
1. Look at the whitepapers folder - the information is a bit old but still usable.
2. Watch the Wave Summit videos on YouTube, find the links at:
3. Subscribe to the wave-dev mailing list, find instructions at
Wave Protocol communicates using Protocol Buffers
Because of the difficulty of distributing binaries, we do not include the
protocol compiler in this distribution. Therefore, to rebuild updated
protocol buffer files, you will need to install the binary protoc
in your environment by fetching the protobuf code from the website
Additionally, you will have to update the file to
point to the unpacked source distribution of the protocol buffers release.
Then, after updating a proto file, run
ant -f build-proto.xml compile compile_json
Note: this generates files into proto_src. If files here exist without
write permission, you will get permission denied errors from this step.
Note also that you don't need protoc unless you want to change the proto
To enable SSL:
Create a Java keystore for your server (e.g. using
You will need a key (e.g. called "server") whose subject Common Name (CN) is
the hostname of your server.
Set enable_ssl = true and set the ssl_keystore_path and ssl_keystore_password options.
To enable X.509 client authentication:
If your users have X.509 certificates which include their email address, you can have
them logged in automatically (with their wave ID being the same as their email address):
You can get X.509 certificates issued from any normal CA (e.g. StartSSL offer them for free).
You can get your CA's certficate from their website, though note they might provide more than 1 certificate which you need to chain before your client certificates are considered trusted.
1. Add the signing CA to your keystore file.
2. Set enable_clientauth = true
3. Set clientauth_cert_domain (to the part after the "@" in your email addresses).
4. (optional) Set disable_loginpage = true to prevent password-based logins.
Users will be automatically logged in when they access the site, with the
username taken from the email address in their certificate.