Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Graceful server restart
Python Other
branch: tacfile

This branch is 30 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
grace
.gitignore
MANIFEST.in
Makefile
README.md
setup.py

README.md

Graceful swan takes flight. Hunter eyes his prey. KABLAM! Hunter falls. Swan holsters gun. Server continues running.

grace lets you restart your server without interrupting current users. It's a runtime configurable, port forwarder.

Installation

Install the dependencies:

pip install Twisted

Either clone repo:

git clone https://github.com/iffy/grace.git grace.git
cd grace.git

Or download a tar:

wget https://github.com/iffy/grace/tarball/master
tar xf master
cd iffy-grace-*

Then install:

python setup.py install

Usage

XXX no command line stuff is supported yet. Well, except a meaningless message.

Planned usage not yet supported

Start forwarding TCP traffic from port 9000 to port 7500 on the local machine:

grace start tcp:9000 tcp:host=127.0.0.1:port=7500

Switch traffic from port 7500 to port 7600 (without disconnecting anyone still connected to port 7500):

grace switch tcp:host=127.0.0.1:port=7600

List forwarding rules:

grace ls

Wait for previous forwards to finish:

grace wait

Switch traffic from port 7600 to port 7700 and wait for all connections to previous ports (7500 and 7600) to finish:

grace switch --wait tcp:host=127.0.0.1:port=7700

Stop forwarding:

grace stop

Upgrade grace to a new version and swap out the current grace process with a new one:

grace restart

Specify where logs, pid and control socket go (XXX needs more explanation):

grace -d /tmp/foo start tcp:9000 tcp:host=127.0.0.1:port=7500

Running the tests

Use trial to run the tests:

trial grace
Something went wrong with that request. Please try again.