Starting the Web Server

This documentation assumes that you know what MAT_PKG_HOME refers to. See the "Conventions" section in your platform-specific instructions in the "Getting Started" section of the documentation.

NOTE: In most cases, the MAT UI relies on MAT tasks to guide your work. The tasks must be installed before you start the Web server in order for the MAT UI to know about them. MAT comes with few sample tasks to get you started, but these tasks are not installed by default. See tutorial 1 for instructions on how to install the sample tasks.

All platforms

You have two options for running the Web infrastructure. In all cases, you can run the MATWeb script in a shell; in some cases, if your distribution comes with the appropriate tools, you can start up a multipane terminal application using the --spawn_tabbed_terminal option to MATWeb. To find out whether tabbed terminals are available in your installation, invoke MATWeb with the --help option and consult the details for --spawn_tabbed_terminal.

If you have tabbed terminals and you choose to use them, you'll be presented with four panes:

Either in pane 1, or in the console if you've just started up MATWeb without the multipane terminal, you'll see something like this:

Web server started on port 7801.

Web server command loop. Commands are:

exit - exit the command loop and stop the Web server
loopexit - exit the command loop, but leave the Web server running
taggerexit - shut down the tagger service, if it's running
restart - restart the Web server
ws_key - show the workspace key
help, ? - this message

Workspace key is S6KHBrVEk3RI1dM5XU7q5CQ8vNILokXI
Command:

The workspace key is an element of workspace security; a new key is generated each time the user starts the Web server (but is preserved if the user issues the "restart" command in the command loop).

The MAT Web server is NOT SECURE

The MAT Web server is not an enterprise-secure implementation, and will never be one. It does not use SSL; in workspace mode, it does not perform any sort of user authentication beyond the workspace key; it does not provide any security logging or traceability. You should assume that anyone who has access to your network can see your Web server traffic, and either observe or (in the case of workspaces) overwrite your data.

Details for each platform follow.

Unix

Once you've built the toolkit, if you have a tabbed terminal application, you can start up the server in a tabbed terminal as follows. If you don't have a tabbed terminal application, MATWeb will gracefully revert to a single terminal:

% cd $MAT_PKG_HOME
% bin/MATWeb --spawn_tabbed_terminal &

This will launch the mrxvt tabbed terminal application. To shut down the server, exit the mrxvt application (closing the window ought to do it).

If you prefer to run your application in a single terminal, or you want to specify additional arguments to MATWeb, or if you don't have a tabbed terminal application, do this instead:

% cd $MAT_PKG_HOME
% bin/MATWeb

You'll see the output of the Web server console, interspersed with other status messages from the Web server. To shut down MATWeb, type "exit" or hit Ctrl-C.

MacOS X

Once you've built the toolkit, if you have a tabbed terminal application, you can start up the server in a tabbed terminal as follows. If you don't have a tabbed terminal application, MATWeb will gracefully revert to a single terminal:

% cd $MAT_PKG_HOME
% bin/MATWeb --spawn_tabbed_terminal &

This will launch the Terminator tabbed terminal application. To shut down the toolkit, exit the Terminator application via Terminator -> Quit Terminator (or Apple-Q). You'll be prompted with warnings about the applications that will be shutting down; press the Close button for each warning.

If you prefer to run your application in a single terminal, or you want to specify additional arguments to MATWeb, or if you don't have a tabbed terminal application, do this instead:

% cd $MAT_PKG_HOME
% bin/MATWeb

You'll see the output of the Web server console, interspersed with other status messages from the Web server. To shut down MATWeb, type "quit" or hit Ctrl-C.

Windows native

Once you've built the toolkit, you can start it up by double-clicking on %MAT_PKG_HOME%\bin\mat_controller.bat on your desktop. This will start up a cmd window, and then, if you have a  tabbed terminal application, a few seconds later, it'll shut down, and you'll see the Console tabbed terminal application showing the four panes described above. To shut down Console, press the "x" in the upper right corner.

If you prefer to run your application in a single terminal, or you want to specify additional arguments to MATWeb, open a cmd shell, via Start -> Run -> "cmd". In this shell, type the following at the command prompt if you want to start up your server in a single console:

> cd %MAT_PKG_HOME%
> bin\MATWeb.cmd

or, if you want to start up the tabbed terminal:

> cd %MAT_PKG_HOME%
> bin\MATWeb.cmd --spawn_tabbed_terminal

If you choose the console option, you'll see the output of the Web server console, interspersed with other status messages from the Web server. You can exit this application by typing "exit" or hit Ctrl-C.