General Information
-------------------

This package of Movable Type Open Source supports a single instance out of
the box, automatically configured. It assumes that /usr/lib/cgi-bin
is available as http://yourserver/cgi-bin/ and requires that your web
server serves up /usr/share/movabletype/static as
http:///your-server/mt-static/ . This will be done automatically for
apache2 configuration, but will need additional configuration for
other web servers.

Once you have installed and configured the package and web server, visit

http://your.server/cgi-bin/movabletype/mt.cgi

to set up the admin account for your installation, and start using
movabletype. You can find documentation at

http://www.movabletype.org/documentation/

The configuration for the single instance lives in
/etc/movabletype-opensource/mt-config.cgi (although this is not a CGI
script).

Multiple Instances
------------------

It is possible to configure multiple instances; at the moment this is via
an ad-hoc method which may need additional maintaince when new versions
are released.

Create a new symlink farm somewhere which is visible as a CGI directory, e.g:

mkdir /my/new/cgi-bin
cd /my/new/cgi-bin
find /usr/lib/cgi-bin/movabletype -type f -exec ln -s {} \;
ln -s /usr/share/movabletype/tmpl
ln -s /usr/share/movabletype/default_templates

mkdir /my/new/mt-static
cd /my/new/mt-static
find /usr/share/movabletype/static -maxdepth 1 -type f -exec ln -s {} \;
find /usr/share/movabletype/static -maxdepth 1 -type d -exec ln -s {} \;

Either

mkdir support
and make sure that this directory is writable by the web server, or
ln -s /my/writable/support-dir support

Edit /my/new/cgi-bin/mt-config.cgi, possibly using
/etc/movabletype-opensource/mt-config.cgi as an example, making sure
to set CGIPath, StaticWebPath, StaticFilePath, ObjectDriver and other
database related options correctly.

MT Wizard
---------

Please note that mt-wizard.cgi has been disabled in the default
Apache configuration as it is not normally needed -- configuration is handled
automatically at package installation time.

If you do need to use it you are strongly advised to restrict access to
trusted hosts, since there have been security issues with it in the past.

If you use Movable Type with other web servers you should take steps
to protect this script in the same way.

Flash stats display disabled for licensing reasons
--------------------------------------------------

Movable Type normally ships with Flash plugins which are responsible
for some stats views in the application. However these do not meet[0] all
DFSG[1] guidelines. Because of this, the Debian package includes a small
plugin which disables them, and removes them from the package.

If you are happy with the notion of using the plugins even though they
are not fully DFSG compliant, you may find them on the Debian Project's
Alioth host[2] (md5sum d269f783ef79698f5304428a0e2492e5) or from the
upstream source distributions[3].

Copy the files to somewhere on your system (for example in /usr/local) and
configure your web server to serve them at /mt-static/flash; you can then
disable the NoStats plugin to regain the functionality.

[0] <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=591975>
[1] <http://www.debian.org/social_contract#guidelines>
[2] <http://pkg-mt-om.alioth.debian.org/flash-downloads/movabletype-opensource-flash-4.34.tar.gz>
[3] <http://www.movabletype.org/downloads/>
