install-script

Install one third-party script

This program performs the actual upgrade or install of a script into a virtual server. The required parameters are --domain (followed by the domain name), --type (followed by the script's short name, like drupal or squirrelmail), and --version (followed by the version number or the word latest). Don't use the script's longer description with the --type parameter - only the short name (as shown by list-available-scripts --multiline) will work.

All scripts will also need the --path parameter, which must be followed by a URL path such as /drupal. This determines the directory where the script is installed. The directory can be overridden by the --force-dir option though, which must be followed by a full path. However, this is not recommended, and should only be used when you have a web server alias setup to map the path to the forced directory.

Those that use a database require the --db parameter, which must be followed by the database type and name, such as --db mysql foo. If this is missing and the script requires it, the install-script command will fail with an error message. By default the database must already exist under the virtual server, but if the --newdb parameter is given it will be created as part of the script installation process.

If upgrading an existing script in this virtual server, you must supply the --upgrade parameter, followed by the install ID. This can be found from the list-scripts command, documented below.

If the script makes use of the Ruby on Rails framework and your system supports multiple proxy balancer backends (as in Apache 2), the --mongrels flag can be given, followed by the number of mongrel_rails processes to configure and start to serve the script.

Most application that Virtualmin can install have an initial username and password for administration. By default these are taken from the domain's Virtualmin login and password, but they can be overridden with the --user and --pass flags.

When the command is run it will display the progress of the installation process as the needed files are downloaded, validated and installed.

Command Line Help

virtualmin install-script --domain domain.name
                          --type name
                          --version number|"latest" [--unsupported]
                         [--path url-path]
                         [--db "type name"]
                         [--opt "name value"]
                         [--upgrade id]
                         [--force-dir directory]
                         [--mongrels number]
                         [--user username --pass password]
                         [--log-only]