mongoProc

Downloads

Running

Windows

On Windows, MongoProc comes packaged with two shortcuts: one for GUI mode and one for Console mode. Opening either of these will start MongoProc.

Mac OS X

On Mac OS X, MongoProc comes in the form of an application bundle. All you need to do is double click on the green leaf.

If you wish to run MongoProc in console mode, you must take the following steps:

Open Terminal or any terminal like application

cd to the directory that mongoProc.app is in

Execute './mongoProc.app/Contents/MacOS/mongoProc --console'

Linux

On Linux, MongoProc comes with a shell script called mongoProc.sh. Executing this will open MongoProc in GUI mode. To open it in Console mode, just execute './mongoProc.sh --console'. Note: Make sure mongoProc.sh is executable (chmod +x mongoProc.sh).

Logging In

Starting up MongoProc presents you with a login dialog.

You must login with the same credentials you use to access MongoDB University

Settings

Servers

After logging in with MongoProc, you have the ability to configure server settings from within the application.

Using the + and - buttons, you can add and remove as many servers as you would like. MongoProc comes with two servers by default: one destined for a web server at localhost:8082 and one destined for a mongod instance at localhost:27017

Here you can configure the server's name, address (host), and port.

Network Proxy

If you require a proxy to access resources on the internet, then you may want to configure MongoProc to use a proxy. This is accomplished by editing the user_settings.json file. The location of this file varies by OS and is provided below.

Testing/Submitting an Assignment

After completing an assignment that uses MongoProc, you will want to test and submit your assignment using MongoProc. In order to do so, navigate to the assignment using the left-side pane.

The test button will perform the same validation as the grade button except you will not actually be submitting an attempt. This is useful to check if you have done the assignment correctly. It also allows for iterative development on your assignments. Both test and grade will provide you with feedback relating to the assignment at hand. This feedback ranges from error messages to messages letting you know everything looks good.

When you are ready to submit your assignment for a grade, just click grade and you're good to go!

Common Issues

"Failed to check for updates."

The most common cause seen for this issue is that you require a proxy to connect to the internet. Please see Proxy Settings above to configure a proxy for MongoProc.

"The process failed to start. Either the invoked program is missing, or you may have insufficient permissions to invoke the program"

This is most likely caused by running MongoProc from the wrong location. The "Running" section specifies how to run MongoProc on each supported Operating System.

MongoProc is telling you that your assignment is not correct.

MongoProc carefully validates your solutions and tries to provide helpful feedback. If it is saying something is wrong, chances are you may have overlooked a small detail in the assignment. If you are sure you are correct, feel free to head over to the discussion board and ask for help.

MongoProc is telling you that it cannot connect to a server when testing/grading.

Verify that your settings reflect the server(s) you are running for the assignment. Be sure not to change the default server names provided.

This happens when MongoProc cannot find the xcb plugin that is required for the application to draw windows. To resolve this dependency you will need libx11-xcb1. For Ubuntu (or Debian based) users, you can run the following:

sudo apt-get install libx11-xcb1

On Linux: "error while loading shared libraries: libGL.so.1: cannot open shared object file: No such file or directory"

This typically happens on a server that doesn't have any graphics libraries (which is normal) but MongoProc requires them to operate as a dual-mode application. For Ubuntu (or Debian based) users, you can run the following:

sudo apt-get install libgl1-mesa-dev

Proxy connection refused

mongoProc couldn't connect to the host and port combo.

SSL Handshake failed

Likely means that your proxy is intercepting SSL and presenting its own certificate to MiTM.
MongoProc doesn't support this type of proxy.