Getting Started
Kaazing Gateway 8.12 (Battlestar) Release
February 2009
Welcome to Kaazing Gateway! This document explains how to get up-and-running with Kaazing Gateway--a process that should not take longer than 10 or 15 minutes. This document contains the following sections:
- Verify System Requirements
- Download and Install the Kaazing Gateway Demo Bundle
- Start the Kaazing Gateway Server
- Verify the Installation
- Next Steps
- Additional Documentation
Verify System Requirements
The following are the minimum system hardware and software requirements for running Kaazing Gateway demo bundle:
Hardware
- 100 MB for the Kaazing Gateway demo bundle
Operating System
- Windows: Windows Vista, Windows XP SP2
- Unix: Ubuntu Linux or any Unix or Linux platform that supports Java 1.6 (Java 6)
Environment
- Java Developer Kit (JDK) 1.6.x (Java 6) or greater
- The JAVA_HOME environment variable must be set to the directory where the JDK is installed, for example C:\Program Files\Java\jdk1.6.0_06
Browser Support
- Firefox version 1.5 and higher
- Internet Explorer version 5.5 and higher
- Safari version 3.0 and higher
- Opera version 9.5 and higher
- Google Chrome version 0.2 and higher
Download and Install the Kaazing Gateway Demo Bundle
Download the Kaazing Gateway demo bundle for your platform and unpack it into the directory of your choice (for example, C:\kaazing). This location will be referred to as $KAAZING_HOME in the rest of this document. The demo bundle also contains a distribution of Apache ActiveMQ for demo purposes.
- Windows Download: kaazing-gateway-demos-8.12_2-bin.zip
- Linux Download: kaazing-gateway-demos-8.12_2-bin.tar.gz
Start the Kaazing Gateway Server
To start the Kaazing Gateway Server, run the gateway.start command from the directory in which you have just unpacked the Kaazing Gateway distribution. For example, C:\kaazing\kaazing-gateway-demos-8.12\bin.
Kaazing Gateway Demo Bundle
To start the demo bundle, you must start both the Kaazing Gateway Server and the Apache ActiveMQ server. To do this, perform the following steps in a shell or command prompt:
Unix/Linux
- Navigate to $KAAZING_HOME/apache-activemq-5.1.0/bin
- Run activemq
- Navigate to $KAAZING_HOME/kaazing-gateway-demos-8.12/bin
- Run gateway.start
- Optionally, run the stock.start script to send stock data to the Apache ActiveMQ server. This is required to view the Stock Trading Table demo.
- Optionally, run the udp.start script to start the UDP data source. This is required to view the Server-Sent Events demo.
Windows
- Navigate to $KAAZING_HOME\apache-activemq-5.1.0\bin
- Run activemq.bat
- Navigate to $KAAZING_HOME\kaazing-gateway-demos-8.12\bin
- Run gateway.start.bat
- Optionally, run the stock.start.bat script to send stock data to the Apache ActiveMQ server. This is required to view the Stock Trading Table demo.
- Optionally, run the udp.start.bat script to start the UDP (User Datagram Protocol) data source. This is required to view the Server-Sent Events demo.
When you start the Kaazing Gateway the following INFO messages display in your shell or command prompt:
INFO [Gateway] Starting server at 2009-02-18 17:29:59
INFO [Gateway] Starting services
INFO [Gateway] http://localhost:8000/
INFO [Gateway] http://localhost:8000/session
INFO [Gateway] https://localhost:9000/
INFO [Gateway] https://localhost:9000/session
INFO [Gateway] sse://localhost:8003/sse
INFO [Gateway] sse+ssl://localhost:9003/sse
INFO [Gateway] ws://localhost:8001/activemq
INFO [Gateway] ws://localhost:8002/jabber
INFO [Gateway] ws://localhost:8005/jabber
INFO [Gateway] wss://localhost:9001/activemq
INFO [Gateway] wss://localhost:9002/jabber
INFO [Gateway] wss://localhost:9005/jabber
INFO [Gateway] Started services
INFO [Gateway] Starting management
INFO [Gateway] jmx://localhost:2020/
INFO [Gateway] Started management
INFO [Gateway] Started server successfully in 0.406 secs
Configuring the Kaazing Gateway Server
You can perform additional gateway configuration by modifying settings in the file $KAAZING_HOME/conf/gateway-config.xml. For example, you can change accept host names and ports and add authorization constraints for services. For more information about gateway configuration, security, and monitoring tasks, see the Kaazing Gateway Administrator's Guide.
Verify the Installation
Open a browser and navigate to
the Kaazing Gateway home page at http://localhost:8000/. The Kaazing Gateway home page displays. Click the Documentation tab to see the documentation library. Refer to this page for tutorials and additional information about Kaazing
Gateway. Click the Demos tab to see the demos.
Next Steps
To get started with Kaazing Gateway, take a look at the additional documentation, try a tutorial, and run some of the preconfigured demos in the Kaazing Gateway demo bundle.
Additional Documentation
Refer to the Documentation page for additional information about Kaazing Gateway.