Foswiki on GitHub is open for business! Next release meeting: Monday September 15, 1300Z

Manually Installing Extensions

Sometimes you need to be able to install extensions manually, from the command-line. This might be because the extensions hasn't been packaged using BuildContrib, or because you are having problems installing from configure (this can sometimes happen on hosted sites, or because the server configuration is unusual).

For Foswiki 1.1+

See System.InstallationGuide#Installing_extensions

For Foswiki 1.0.x

So install an extension manually:
  1. Download one of the .zip or .tgz archives
  2. Unpack the archive in the root directory of your installation.
  3. Run the installer script
    • perl <module>_installer
    • If the installer script fails, keep going anyway. Some extensions don't need the installer script to run to completion to be correctly installed
  4. Run configure
    • Enable the module if it is a plugin.
    • Set up any configuration options required for the extension
    • Save the configuration
  5. Repeat for any missing dependencies.

Troubleshooting

If you are still having problems, then:
  1. Make sure that the file permissions allow the webserver user to access all files.
  2. Check in any installed files that have existing ,v files in your existing install (take care not to lock the files when you check in)
  3. Manually edit LocalSite.cfg to set any configuration variables.

BasicForm edit

TopicClassification SupplementalDoc
Topic Summary Describes how to install extensions from the command-line
Extension
Interested Parties
Related Topics
Topic revision: r3 - 18 Sep 2012, PaulHarvey
 
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. see CopyrightStatement. Creative Commons License