$VER: MiamiDxWebCP.readme 2.3 (3.7.2000) (W) by Martin Steigerwald

MiamiDx Web Control Panel 2.3 (3.7.2000) (W) by Martin Steigerwald



What is it?
-----------

MiamiDx Web Control Panel implements some of the functionality of the
original Control Panel for MiamiDx via ARexx cgi-bin scripts (see
"Example.html" or german language user "Beispiel.html"). So if you have a
local network with your Amiga as internet router, anyone at one of the
other machines of your local network can tell MiamiDx on your Amiga to go
online or offline. Also you self can use the Web Control Panel.

Why not dial on demand? Well easy. In germany most internet providers give
dynamic IP addresses and also charge costs by time. This makes it dificult
to configure dial on demand in a satisfying way. If the time it stays
online without traffic is to short, you might loose your ICQ connections
and stuff, cause on next connect the IP is changed. If it is too long, you
loose money. And then there are applications that think they should query
the internet from time to time without user interaction to check for
updates or whatever. With a Web Control Panel the local users actually
have *full* control when your Amiga goes online.


Requires
--------

MiamiDx 1.0c with properly set up IP Nat routing (well otherwise it would
not make much sense):

http://www.nordicglobal.com

A web server with working ARexx gateway.

I recommend Apache 1.3.12 or later:

http://amiga-apache.home.pages.de


Installation
------------

Install the webserver and configure it properly so that arexx cgi scripts
will work. In »Apache:conf/httpd.conf« search the line »AddHandler
cgi-script .cgi«. Add a the following line after it:

AddHandler cgi-script .rexx

Usually cgi-scripts are either located in your cgi-bin directory or have
to have one of the extensions given by those »AddHandler cgi-script«
directives.

Add a proper directory entry to »httpd.conf«, like this:

Alias "/MiamiDxWebCP" "/Miami/MiamiDxWebCP"
<Directory "/Miami/MiamiDxWebCP">
    Options Indexes FollowSymLinks MultiViews ExecCGI
    AllowOverride Limit
    Order allow,deny
    Allow from 127.0.0.1 192.168.1
</Directory>

It is important to only allow your local users access to this directory!
Especially if you want people from the net have access to other
directories of your local web server. If you do not want this, you can
raise up automatic firewall from MiamiDx under »TCP/IP«, »LAN-Connect« to
be completely sure.

Dearchive the script into »Miami:MiamiDxWebCP« and adapt it to your needs.
Just place your favorite ppp interfaces you want to make accessible or at
last queryable into the list in "MiamiDxWebCP.rexx" and set how many you
have. For each interface you can define whether:

interface.1="ppp0"              - This is the MiamiDx interface name
interface.1.name="Freenet"      - This is the name shown to the user
                                  of MiamiDxWebCP
interface.1.access="yes"        - Controls whether a MiamiDxWebCP user may
                                  switch the interface on- or offline remotely.
interface.1.description= "..."  - Some description also shown to the user.
                                  Could for example contain an info on how
                                  much the internet costs using this
                                  interface are.

You may also want to adapt BeginHTML() and EndHTML() and the interfaces
table generation code to your taste.

Have fun. You can now test the MiamiDx Web Control Panel by pointing your
browser to the following URL:

http://localhost/MiamiDxWebCP/MiamiDxWebCP.rexx

German users may want to use:

http://localhost/MiamiDxWebCP/MiamiDxWebCP.rexx?lang=de


Security
--------

The directory directive shown above makes sure that only users on local
computers may access MiamiDxWebCP. The ".htaccess" file in the
MiamiDxWebCP directory may act as a safeguard when you configured the
MiamiDxWebCP directory incorrectly in »httpd.conf«. If your computers are
on another network than "192.168.1" with netmask "255.255.255.0" you have
to adapt this file.

Another easy and very safe way to make sure that MiamiDxWebCP is not
accessed from outside your local network is to enable the MiamiDx
automatic firewall setup and make sure that there is no http in the
exception list. But then all your local pages are blocked.


Future
------

I will only add features when I need and/or have fun while adding features
that other users of MiamiDxWebCP suggest.


History
-------

revision 2.3
date: 2000/07/03 13:03:57;  author: helios;  state: Exp;  lines: +12 -12
- changed my internet provider settings

revision 2.2
date: 2000/06/05 20:11:25;  author: helios;  state: Exp;  lines: +47 -27
- put in design from Leo
- admin.name and admin.email configurable at beginning of the script
- uses font face "Arial, Helvetica"
- also outputs version info on the webpage

revision 2.1
date: 2000/06/01 18:11:48;  author: helios;  state: Exp;
- made 10 scripts into one script by using CGI argument parsing
- two-language support: english and german
- changed variable names a bit


Thanks
------

Holger Kruse for MiamiDx.

The developers of Apache and the makers of its Amiga port.


Martin 'Helios' Steigerwald - mailto:Martin-Steigerwald@gmx.net
http://helios.home.pages.de

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 1365    1694  80.6% -lh5- 1557 Jun  2  2000 MiamiDxWebCP.info
[generic]                   45      45 100.0% -lh0- 7b76 Jun  5  2000 MiamiDxWebCP/.htaccess
[generic]                  741    2418  30.6% -lh5- f06b Jul  3  2000 MiamiDxWebCP/Beispiel.html
[generic]                 2117    2488  85.1% -lh5- 65fb Jul  3  2000 MiamiDxWebCP/Beispiel.html.info
[generic]                  742    2418  30.7% -lh5- ca9a Jul  3  2000 MiamiDxWebCP/Example.html
[generic]                 2117    2488  85.1% -lh5- 65fb Jul  3  2000 MiamiDxWebCP/Example.html.info
[generic]                 2404    5506  43.7% -lh5- ac57 Jul  3  2000 MiamiDxWebCP/MiamiDxWebCP.readme
[generic]                 1286    1696  75.8% -lh5- 97c0 Apr 19  2000 MiamiDxWebCP/MiamiDxWebCP.readme.info
[generic]                 2354    6761  34.8% -lh5- 915b Jul  3  2000 MiamiDxWebCP/MiamiDxWebCP.rexx
[generic]                 2326    2326 100.0% -lh0- 927e Jul  3  1996 MiamiDxWebCP/pictures/apache_pb.gif
[generic]                 1972    2029  97.2% -lh5- 9fc7 May 25  2000 MiamiDxWebCP/pictures/BuiltWithAmiga.png
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        11 files   17469   29869  58.5%            Jul  5  2000