Checker Framework live demo webserver
This is the live demo webserver for the Checker Framework.
Production Server Deployment
Some notes on how to install these two modules in RHEL 7 and Ubuntu please see here: https://github.com/eisop/webserver/blob/master/README-eisop.txt
- Clone this project in the
git clone https://github.com/eisop/webserver.git
- In the clone, run
./shell-scripts/deploy-checkerweb.shwith one of these options:
If you want to deploy this server with the newest development version of the Checker Framework from
If you want to deploy this server with the newest released version of the Checker Framework from
./shell-scripts/deploy-checkerweb.sh -r <url of the released Checker Framework zip>
./shell-scripts/deploy-checkerweb.sh -r http://types.cs.washington.edu/checker-framework/current/checker-framework-1.9.13.zip
If you want to deploy this server with an existing local copy of the Checker Framework, run:
./shell-scripts/deploy-checkerweb.sh -l <path to checker-framework>
./shell-scripts/deploy-checkerweb.sh -l ../jsr308/checker-framework
- Customize the vhost configuration file: wsgi-scripts/checkerweb-wsgi.conf
- Link this file to the apache2 vhost directory:
In RHEL 7 do:
cd /etc/httpd/conf.d ln -s /var/www/checkerweb/wsgi-scripts/checkerweb-wsgi.conf .
In Ubuntu do:
cd /etc/apache2/sites-enabled ln -s /var/www/checkerweb/wsgi-scripts/checkerweb-wsgi.conf .
- Restart the apache2 server:
In RHEL 7 do:
sudo apachectl restart
In Ubuntu do:
sudo service apache2 restart
Setting Up a Test Server
For developers, there are two ways of setting up a test server. One way is running a server in a terminal to see changes immediately, and the other way is to deploy a test/development version server to apache2.
Follow steps 1 and 2 above to clone and install the web server, then make your changes.
in step 2 when running
deploy-checkerweb.sh, if you use the
-loption to link your local copy of Checker Framework, the
deploy-checkerweb.shwill pass this location to
build-checker-framework.shand link this location to
webserver/enabled-checker-framework, which means it is your responsibility to ensure the passed location is correct.
You can simply 're-plug' the Checker Framework by running
build-checker-framework.sh -l <new location of cf>
Running a server in a terminal using Bottle Server
In the clone, directly run:
This will active a bottle server listening on port 8081, and can be stopped by ctrl-C in the terminal.
This is the easiest way to run a test server to have a look at your changes immediately.
Deploy a test/development server on port 8081 on apache2
This version needs installation of python mod_wsgi first.
In the clone, run:
Then you will have a server running apache2 and listening on port 8081.
Loading modifications to the test server
When you're done with modifications and you want to see the changes, in the clone, do:
- No need to restart apache2
- If you have modified
CheckerPrinter, in the clone, execute
make -C CheckerPrinter clean allfirst.