APL Wiki|
Size: 3369
Comment: Cosmetics
|
Size: 3570
Comment: Added install package compatible with Dyalog version 12.1
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 2: | Line 2: |
| = MildServer: Getting Started = == Download The MildServer == The MildServer requires [[http://www.dyalog.com|Dyalog APL]] for 32-bit Windows, Unicode Edition, Version 12.0.3 or later. Free educational licenses and low-cost personal or non-commercial licenses are available from the Dyalog [[http://www.dyalog.com/download-zone.htm|Download Zone]].<<BR>> ||''Date'' ||''Link'' ||''Comments'' || ||2010-02-28 ||[[attachment:MildServer-20100228.zip]] ||Revised for Dyalog version 12.1 || ||2009-01-02 ||[[attachment:MildServer-20090102.zip]] ||Original version for Dyalog 12.0 || |
|
| Line 3: | Line 9: |
| = MildServer: Getting Started = | |
| Line 5: | Line 10: |
| == Download The MildServer == | |
| Line 7: | Line 11: |
| The MildServer requires [[http://www.dyalog.com|Dyalog APL]] for 32-bit Windows, version 12.0.3 or later. Free educational licenses and low-cost personal or non-commercial licenses are available from the Dyalog [[http://www.dyalog.com/download-zone.htm|Download Zone]].<<BR>><<BR>> ||''Date''||''Comments''|| ||2009-01-02||[[attachment:MildServer-20090102.zip]]|| |
|
| Line 17: | Line 17: |
| To start the !MildServer, )load the mserver workspace, and run the function Boot.Demo. This will start a demo system, listening on TCP Port 8080 on your machine. If you have a firewall installed, it will probably pop up and ask whether the Dyalog application should be allowed to access the network, you have to grant permission for the server to work. If you want to use a different port (for example, use port 80 to make the !MildServer the default web server on a machine), you need to edit the file server.xml in the Config folder. | To start the !MildServer, )load the mserver workspace, and run the function Boot.Demo. This will start a demo system, listening on TCP Port 8080 on your machine. If you have a firewall installed, it will probably pop up and ask whether the Dyalog application should be allowed to access the network, you have to grant permission for the server to work. If you want to use a different port (for example, use port 80 to make the !MildServer the default web server on a machine), you need to edit the file server.xml in the Config folder. |
| Line 19: | Line 19: |
| Once the server is started, you should be able to start a web browser on your machine and direct it to [[http://localhost:8080]]. If the !MildServer is running, you should see a pale blue page with the header "Welcome to the !MildServer". | Once the server is started, you should be able to start a web browser on your machine and direct it to http://localhost:8080. If the !MildServer is running, you should see a pale blue page with the header "Welcome to the !MildServer". |
| Line 23: | Line 23: |
| ||Parameter ||Example ||<70% style="text-align: center">Explanation || ||!ClassName ||!DemoServer ||The name of the Class which will implement the server. This must either be ''!MildServer'', or a name of class which exists in the server workspace. Class scripts in the ''Code'' folder are automatically loaded when the server starts (see ''Demo\Code\!DemoServer.dyalog'' || ||Address ||http://localhost:8080 ||Not currently used, but set it to the address that the server will be reachable at. || ||Root ||Demo ||The application root folder - if not a full path name, relative the !MildServer folder || ||Port ||8080 ||The port on which the server will listen for incoming connections. Port 80 is the default port number used by HTTP servers, so it you don't already have a web server installed you might as well use 80, then you won't need to specify a port number when browsing the site. || ||!SessionHandler ||!SimpleSessions ||The name of the class which will handle sessions (see MildServerSessions for more information || ||Authentication ||!SimpleAuth ||The name of the class which will handle authentication (see MildServerAuthentication for more information || ||!DefaultPage ||index.dyalog ||The name of the page to return if no page name is given by the browser. || |
|
| Line 24: | Line 32: |
| ||Parameter||Example||<:70%> Explanation|| ||!ClassName||!DemoServer||The name of the Class which will implement the server. This must either be ''!MildServer'', or a name of class which exists in the server workspace. Class scripts in the ''Code'' folder are automatically loaded when the server starts (see ''Demo\Code\!DemoServer.dyalog''|| ||Address||http://localhost:8080 ||Not currently used, but set it to the address that the server will be reachable at.|| ||Root||Demo||The application root folder - if not a full path name, relative the !MildServer folder|| ||Port||8080||The port on which the server will listen for incoming connections. Port 80 is the default port number used by HTTP servers, so it you don't already have a web server installed you might as well use 80, then you won't need to specify a port number when browsing the site.|| ||!SessionHandler||!SimpleSessions||The name of the class which will handle sessions (see MildServerSessions for more information|| ||Authentication||!SimpleAuth||The name of the class which will handle authentication (see MildServerAuthentication for more information|| ||!DefaultPage||index.dyalog||The name of the page to return if no page name is given by the browser.|| |
MildServer: Getting Started
Download The MildServer
The MildServer requires Dyalog APL for 32-bit Windows, Unicode Edition, Version 12.0.3 or later. Free educational licenses and low-cost personal or non-commercial licenses are available from the Dyalog Download Zone.
Date |
Link |
Comments |
2010-02-28 |
Revised for Dyalog version 12.1 |
|
2009-01-02 |
Original version for Dyalog 12.0 |
All of the source code is in the form of UTF-8 text files, so even if you do not have Dyalog installed, you should be able to inspect the application.
Installation Instructions
You should be able to locate the MildServer anywhere you like (but all development and testing has been done using C:\MildServer, so if you have any problems you might want to try using this folder and reporting the failure to MortenKromberg).
To start the MildServer, )load the mserver workspace, and run the function Boot.Demo. This will start a demo system, listening on TCP Port 8080 on your machine. If you have a firewall installed, it will probably pop up and ask whether the Dyalog application should be allowed to access the network, you have to grant permission for the server to work. If you want to use a different port (for example, use port 80 to make the MildServer the default web server on a machine), you need to edit the file server.xml in the Config folder.
Once the server is started, you should be able to start a web browser on your machine and direct it to http://localhost:8080. If the MildServer is running, you should see a pale blue page with the header "Welcome to the MildServer".
Server Configuration
When the MildServer starts, it expects the application folder (by default, C:\MildServer\Demo) to contain a folder called Config, which contains configuration files in XML format. The main server configuration file is called server.xml, and defines the following parameters:
Parameter |
Example |
Explanation |
ClassName |
DemoServer |
The name of the Class which will implement the server. This must either be MildServer, or a name of class which exists in the server workspace. Class scripts in the Code folder are automatically loaded when the server starts (see Demo\Code\DemoServer.dyalog |
Address |
Not currently used, but set it to the address that the server will be reachable at. |
|
Root |
Demo |
The application root folder - if not a full path name, relative the MildServer folder |
Port |
8080 |
The port on which the server will listen for incoming connections. Port 80 is the default port number used by HTTP servers, so it you don't already have a web server installed you might as well use 80, then you won't need to specify a port number when browsing the site. |
SessionHandler |
SimpleSessions |
The name of the class which will handle sessions (see MildServerSessions for more information |
Authentication |
SimpleAuth |
The name of the class which will handle authentication (see MildServerAuthentication for more information |
DefaultPage |
index.dyalog |
The name of the page to return if no page name is given by the browser. |
Continue to Debugging MildServer Pages.
Return to the main MildServer page.