LiveWhale

Changing the FTP or database configuration

How to change the FTP or database configuration for LiveWhale.

This setting can be adjusted using the master LiveWhale configuration. (Please see “Configuring LiveWhale” for more information.)

If you ever need to change the FTP or database settings for any LiveWhale host after their initial configuration, you may do that by editing the master LiveWhale config file. FTP and database settings are set on a host-by-host basis. (Please see “Adding a subdomain to the LiveWhale configuration” for information on how to add additional hosts.)

Open the master LiveWhale config (/livewhale/core/config.php) using an FTP client or via the command line.

Find the HOSTS array, containing any hosts configured for LiveWhale, and locate the particular host you wish to modify. (You may only have one.)

The four options related to database access are:

  • DATABASE_HOST

Set this to the hostname for the database server. If the database server is running on the same server as your web site, this may simply be set to “localhost”.

  • DATABASE_USER

Set this to the database user with unrestricted access to the LiveWhale database.

  • DATABASE_PASS

Set this to the password for the associated database user.

  • DATABASE_DB

Set this to the name of the LiveWhale database. For security purposes, it is wise to identify and use a single database for the CMS that does not contain sensitive data used for other purposes.

The six options related to FTP access are:

  • FTP_HOST

Set this to the hostname for the FTP server. If the FTP server is running on the same server as your web site, this may simply be set to “localhost”.

  • FTP_PORT

If a different port is used for the FTP server than the default for the protocol, you may supply it here.

  • FTP_USER

Set this to the user that LiveWhale should masquerade as when committing FTP transactions to this web site.

  • FTP_PASS

Set this to the password for the associated FTP user.

  • FTP_PUB

Set this to the full FTP path to the public web root of this web site.

  • FTP_CMS

Set this to the full FTP path to the LiveWhale installation directory (containing the core and client directories).

  • FTP_MODE

Set this to the desired FTP mode. It can be one of “ftp”, “ssl”, “sftp”. If your FTP server supports sftp, this is recommended. If not, use “ftp”.

Note: LiveWhale’s FTP layer will automatically go into “accelerated mode” for read-only commands if the FTP files are also accessible locally. This greatly boosts performance for some FTP actions when supported. Also, if the FTP API is utilized by developers, and an FTP connection is accidentally left open, LiveWhale will automatically detect, close, and log the leaked FTP connection.

Need more help? We’re here for you! If this document doesn’t address your question, or if you’d just like to know more, please send an email to support@livewhale.com and we’ll get back to you with more information!