Socket server for ActiveStack
Last updated 4 years ago by curb47 .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install activestack-gateway -g
SYNC missed versions from official npm registry.

ActiveStack Gateway

Circle CI


The ActiveStack Gateway is a Node server that sets up a real-time socket server for clients wanting to connect to the ActiveStack backend.



  • Node = 0.10.x
  • Redis
  • RabbitMQ

Install Options

The AS Gateway provides two usage methods:

  • Install globally with NPM: npm install -g activestack-gateway. This method will make the activestack-gateway executable available on your path for starting from the command line.
  • Install in your own node project with npm install activestack-gateway. This method will make the gateway available to your project at runtime so you can control the gateway from your application.


If you installed the gateway with the global option then you'll have a new executable on your path: activestack-gateway.

To start the gateway server with default options run:

> activestack-gateway server|s

To start the gateway console to control an already running server run:

> activestack-gateway console|c

Console Commands

Once you've started the active stack control console you can issue these commands to control the server:

  • quit - to quit the console
  • restart - to restart the server
  • shutdown - to shut the server down
  • loglevel - set the log level # Not currently implemented
  • clientmessageresendinterval - print the client message resend interval configuration
  • clientcount - print the number of clients connected to the server


The AS Gateway allows several different configuration options. These can be specified using a customer configuration file.

# How often should server process send heartbeats to workers
# How long before a worker times out and is restarted
# Get warned when memory reaches this level
# Get warned when memory reaches this level
# Hard memory limit
# Hard memory limit
# How long to wait before worker is restarted
# Worker backoff
# The number of workers to spawn. If not specified will use (numCPUs/2)+1

# Logging level
# Shutdown password
# The port to listen on 
# Use SSL or not

# Socket IO configurations

# Redis configurations

# RabbitMQ configurations

Running Tests

npm test

API Documentation

ActiveStack Services

  • gateway.js - Passed in the Express HTTP Server instance to listen for connect requests on.
    1. Sets up a redis listener for the SocketIO library to use. This is meant to allow each instance of a SocketIO listener to be stateless.
    2. Starts up a SocketIO listener, attaching itself to the ExpressJS HTTP Server instance passed in from server.js.
    3. As part of the SocketIO listener, a Flash Policy "Server" is also started for Flash based socket clients.
    4. Creates and starts a new RabbitMQ listener.
    5. Once the RabbitMQ listener is established (i.e. has emitted its ready event) the SocketIO has its connection listener setup.
    6. SocketIO connection listener handles a new client connect request by:
      1. Storing a reference to the socket by its
      2. Adds listeners to the new socket for disconnect and logout.
      3. Creates a new Client, passing in the new socket, RabbitMQ instance, and RabbitMQ exchange.
      4. Once the new Client is established it is meant to handle all communication with the client except in the case of a socket disconnect/logout.

ActiveStack Client

  • Client
    1. Creates a new Session for the Client. A Session represents the state of the Client. In order to be stateless, the Session data is encrypted and sent to the client. The encrypted session data is considered to be the reconnect "key" for any client reconnect attempts. Whenever the Session data changes, the reconnect "key" is re-packaged and re-sent to the client.
    2. Sets up listeners for:
      1. message - Routes the message to all the clients registered agents
      2. logout - Routes the logout message to all the clients registered agents
      3. disconnect - Routes the disconnect message to all the clients registered agents
      4. error - Handles the error accordingly, which potentially means invalidating and disposing of the Client.

Current Tags

  • 0.2.5                                ...           latest (4 years ago)

9 Versions

  • 0.2.5                                ...           4 years ago
  • 0.2.4                                ...           4 years ago
  • 0.2.3                                ...           4 years ago
  • 0.2.2                                ...           4 years ago
  • 0.2.1                                ...           4 years ago
  • 0.3.0                                ...           5 years ago
  • 0.2.0                                ...           5 years ago
  • 0.1.1                                ...           5 years ago
  • 0.1.0                                ...           5 years ago
Maintainers (1)
Today 0
This Week 1
This Month 1
Last Day 1
Last Week 0
Last Month 0
Dependencies (8)
Dev Dependencies (6)
Dependents (0)

Copyright 2014 - 2016 © |