@FORGENAME@ for Debian
-=================
+======================
@FORGENAME@ is packaged for Debian, and was formerly packaged under
the 'gforge' source package name. Even though a transition is in
progress towards renaming it widely, only high-level meta-packages are
-named with the '@FORGENAME@' prefix. The rest of the packages are
+named with the '@PACKAGE@' prefix. The rest of the packages are
still named with the 'gforge-' prefix, so expect most paths and
filenames to still be named in relation to 'gforge'.
Status
------
-Want to know what the status of this package is? Read
+Want to know what the status of this package is? Read
/usr/share/doc/@PACKAGE@/TODO.Debian or (even better)
-<https://fusionforge.org/plugins/mediawiki/wiki/fusionforge/index.php/Roadmap>. If you miss a
-feature, or find a bug, or want to help, don't hesitate to contact me
-(Roland Mas <lolando@debian.org>) . Plenty of features are missing,
-I'm working on some, but if you don't tell me which ones you miss the
-most I might process them in the wrong order for you.
+<https://fusionforge.org/plugins/mediawiki/wiki/fusionforge/index.php/Roadmap>.
+If you miss a feature, or find a bug, or want to help, don't hesitate
+to contact me (Roland Mas <lolando@debian.org>) . Plenty of features
+are missing, I'm working on some, but if you don't tell me which ones
+you miss the most I might process them in the wrong order for you.
Please read the bug reports on the Debian bug-tracking system (at
<URL:http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=@PACKAGE@>)
Note on documentation
---------------------
+See contents of /usr/share/doc/@OLDPACKAGE@-common/ first.
+
Although a few documentation files from upstream are included, they
are either very out of date or practically useless. I mostly include
them for completeness's sake (and per request, too). The files I'm
Do *not* delete the /etc/@PACKAGE@/*.template files. They are
needed. Do not alter them either unless you *know* what you're doing.
+ See /usr/share/doc/@PACKAGE@-web-apache2/README.Debian(.gz) for
+more details about the Apache webserver configuration options for
+FusionForge.
Custom local configuration
--------------------------
With default Debian settings, a set of conf files have been generated,
and will contain the desired settings for runtime :
- - /etc/gforge/local.inc
- - ... (TO BE DOCUMENTED PROPERLY !)
-
-Should these settings not suit you, it is possible to change
-configuration options by :
+ - /etc/fusionforge/config.ini
+ - /etc/fusionforge/config.ini.d/*.ini
- 1. modifying /etc/@FORGENAME@/@FORGENAME@.conf which contains the
- basic settings
- ( 2. Optional : copy some template files from
- /usr/share/gforge/etc/local.d/ to /etc/gforge/local.d/ (TO BE
- DOCUMENTED PROPERLY !) )
- 3. regenerate the runtime config files by issueing :
- # fusionforge-config
+They are standard Windows-style *.ini files, and can be updated with
+any text editor. They should be taken into account immediately by the
+web part of the forge and any subsequent runs of the cron jobs. Note
+however that some require manual intervention: for instance, if you
+change the name of the database, you will need to perform the
+appropriate steps in the database server too.
-Customizations in /etc/@FORGENAME@/@FORGENAME@.conf may include :
- - switching to HTTPS with 'sys_use_ssl=true',
- - setting a custom URL prefix with 'sys_urlprefix=/@FORGENAME@/' for
- instance,
- etc.
+Instead of changing the contents of the existing file, you may wish to
+add only your custom local settings which differ from the packaged
+defaults in a dedicated overriding file, for example in the provided
+/etc/@PACKAGE@/config.ini.d/zzzz-local.ini. This will make it
+easier to track local customizations.
Adminning notes
---------------
- Once @FORGENAME@ is setup, it pretty much runs by itself. There
+ Once @FORGENAME@ is set up, it pretty much runs by itself. There
should be relatively few things to do for the administrator. The
following are random notes trying to document them.
adapted and fixed all the scripts related to SCM, DNS, SSH accounts,
and probably more.
- -- Roland Mas <lolando@debian.org>, Thu Jul 24 21:33:33 2003
+ -- Olivier Berger <obergix@debian.org>, Thu, 16 Aug 2012 12:55:46 +0200
# Local Variables:
# mode: text