Version: 0.2.0 (Released on August 30, 2018)
Official Website | Tech Support | Change Log
Note: The continuous integration (CI) process is facing challenges as a result of bugs in the upstream activemq-broker.
Update: Verwandlung Online Judge now supports Docker. You can use Verwandlung Online Judge with ONLY 4 bash commands.
docker pull zjhzxhz/voj.web
docker pull zjhzxhz/voj.judger
docker run -d --name voj.web -p 8080:8080 zjhzxhz/voj.web
docker run -d --name voj.judger --link voj.web zjhzxhz/voj.judger
Tell me more about voj@Docker.
It is a cross-platform online judge system based on Spring MVC Framework.
The application used following open-source projects:
- Spring MVC famework
- MyBatis persistence framework
- Apache ActiveMQ message queue
- Druid database connection pool
- Flat UI
- jQuery
- FontAwesome
- CodeMirror
- Highlight.js
In 2011, LinkedIn Inc. launched a message queue called Kafka, which is written in Scala and available as open-source software.
A year later, Alibaba Inc. introduced a message queue named MetaQ which is built on top of Kafka and implemented in Java. The name "MetaQ" is derived from the title of a renowned literary work, "Metamorphosis", authored by Franz Kafka.
Since message queues are vital components in an application, the name of the application was chosen as "Verwandlung", which is the German translation for "Metamorphosis".
The Verwandlung application consists of two primary components:
- Web Application
- Judger (compatible with both Windows and Linux operating systems)
The overall architecture of the application can be illustrated by the diagram provided below:
As depicted in the diagram, the Verwandlung Online Judge features support for multiple judgers. These judgers are responsible for communicating with the web application through the use of ActiveMQ.
- CPU: 2.0 GHz or faster 32-bit (x86) or 64-bit (x64) processor
For Web Application (including Database and Message Queue):
- RAM: 2.0 GB RAM on Windows, 1.0 GB RAM on Linux.
For Judger:
- RAM: 1.0 GB RAM on Windows, 512 MB RAM on Linux.
For Web Application (including Database and Message Queue):
- Operating System: Windows, Linux or Mac
- Database: MySQL 5.5+ or MariaDB 5.5+
- Java Runtime: Oracle JRE 17+ or Oracle JDK 17+
- Message Queue: ActiveMQ 5.18+
- Web Server: Tomcat 10+
For Judger:
- Operating System: Windows or Linux
- Java Runtime: Oracle JRE 17+ or Oracle JDK 17+
Now you can easily use Verwandlung Online Judge with Docker.
See the installation instructions here.
NOTE:
- Maven 3+ and GCC 4.8+ with POSIX thread model is required.
- Make sure
mvn(Maven),g++andmakeare added to the PATH.
After download source code from this repository, run following commands from a terminal:
For Web Application:
cd web
mvn package -DskipTests
If the build is successful, the terminal will display a message as following:
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 10.168 s
[INFO] Finished at: 2015-11-26T13:20:09+08:00
[INFO] Final Memory: 24M/210M
[INFO] ------------------------------------------------------------------------
And you'll get a package named voj.web.war in the target folder.
For Judger:
Windows:
cd %JAVA_HOME%\include\win32
copy jawt_md.h ..
copy jni_md.h ..
cd judger
mvn package -DskipTests
Linux:
cd $JAVA_HOME/include/linux
cp jawt_md.h jni_md.h ..
cd SOURCE_CODE_PATH/judger
mvn package -DskipTests
If the build is successful, the terminal will display a message as following:
[INFO] Executing tasks
jni:
[echo] Generating JNI headers
[exec] mkdir -p target/cpp
[exec] g++ -c -std=c++11 -Wall -fPIC -I ... -o target/cpp/Judger.Core.Runner.o
[INFO] Executed tasks
...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 12.432 s
[INFO] Finished at: 2015-11-26T13:22:46+08:00
[INFO] Final Memory: 81M/513M
[INFO] ------------------------------------------------------------------------
And you'll get a package named voj.judger.jar in the target folder.
To reduce the memory of ActiveMQ, you can edit activemq.xml in ACTIVEMQ_HOME\conf.
Please find following content in this file, and change it to proper values that suitable for your servers.
<systemUsage>
<systemUsage>
<memoryUsage>
<!-- Change this value -->
<memoryUsage limit="128 mb" />
</memoryUsage>
<storeUsage>
<!-- Change this value -->
<storeUsage limit="4 gb"/>
</storeUsage>
<tempUsage>
<!-- Change this value -->
<tempUsage limit="4 gb"/>
</tempUsage>
</systemUsage>
</systemUsage>
Create a database in MySQL, import voj.sql.
Edit the values in /WEB-INF/classes/voj.properties of the file voj.web.war.
You can open it with archive manager software such as WinRAR.
After then, you can copy this file voj.web.war to TOMCAT_HOME/webapps.
IMPORTANT: For Windows users, please edit server.xml of your Tomcat configuration:
<Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1"
redirectPort="8443" useBodyEncodingForURI="true">
</Connector>
Edit the values in /voj.properties of the file voj.judger.jar.
You can run the judger using following command :
Windows:
javaw -jar voj.judger.jar
Linux:
sudo java -jar voj.judger.jar
Important:
If you are using Linux, please run following commands using root:
# Shutdown and Kill process is not allowed for non-root user
chmod 700 /sbin/init
chmod 700 /sbin/poweroff
chmod 700 /usr/bin/pkill
We're glad that you want to improve this project.
- We NEED TRANSLATORS for multi-language support(English and Chinese have supported).
- You can report bugs here.
- You can also create a pull request if you can fix the bug.
- If you want to add features to the project, please tell us in the issues page before developing.
Thanks for your corporation.
This project is open sourced under GNU GPL v3.