Installing DF/Manager

Before you begin

Before you begin the install, there are few things you need to have and do.

You need access to your site and its directory and software to proceed with the installation. These are:

  • Access to your web server (via shell or FTP)
  • A text editor (Notepad or something similar)
  • An FTP Client
  • Your web browser of choice

Things you need to do to install DF/Manager

Begin your installation by:

  1. Checking to ensure that you and your web host have the minimum requirements to run DF/Manager.
  2. Purchase and download the latest release of DF/Manager.
  3. Unzip the downloaded file to a folder on your hard drive.
  4. Create a database for DF/Manager on your web server, as well as a MySQL user who has all privileges for accessing and modifying it.
  5. Upload the DF/Manager files to your web server.
    If you're using a Mac, please make sure to upload the hidden .htaccess files!
  6. Start the DF/Manager installer in your favorite browser.
  7. Set write permissions on the indicated files/folders.

Installation

Copy files

Place the DF/Manager files in the desired location on your web server. 

  • If you want to integrate DF/Manager into the root of your domain (e.g. http://example.com/), move or upload all contents of the unzipped DF/Manager directory (but excluding the directory itself) into the root directory of your web server. This is usually a directory called public_html or httpdocs.
  • If you want to have your DF/Manager installation in its own subdirectory on your web site (e.g. http://example.com/shop/), create the subdirectory called "shop" inside public_html or httpdocs and upload the DF/Manager files into it.

Windows / IIS

If you're installing DF/Manager on a Windows server using IIS you have to disable 'pretty urls' (this functionality uses the mod_rewrite Apache module, which is obviously not available under IIS):

Open /app/config/core.php and find the line 

//Configure::write('App.baseUrl', env('SCRIPT_NAME'));

Remove the 2 slashes from the start and save the file back to your server,

Start the installer

Now open the site using your favorite browser (all major browsers are supported). The DF/Manager installer will guide you through the rest of the installation process.

The installer will check if the proper privileges have been set on files and folders, with one exception: the installer itself needs write permissions on the config files. Before starting the installer, make sure the config folder (/app/config/) is writable. The installer will fail otherwise.

If the installer cannot write /app/config, or more specifically /app/config/database.txt it will fail.

Everything is ready to start installing DF/Manager.

The installer runs you through a 5-step procedure:

  1. The first step will check some prerequisites on your web server. A number of files and folders need write permissions. Make sure all items under File permissions are colored green before continuing. If you don't know how to set write permissions on files please check the documentation of your FTP application.
    The Software versions section checks for the proper versions of PHP and CakePHP on your web server. If your server does not meet the required specification you may continue the installation. However, some functions may not function properly.
    If you plan to use cron-jobs you should also make sure the items under Optional execute permissions are green. The Next button will appear only if sufficient write permissions have been granted.
     
  2. Enter details about your database. You must, at minimum, enter a database name and account to access the database. If required you can also enter further details about the database, like a table prefix and connection type. Use the Test connection button to see if your database is accessible.
     
  3. The required tables are created in your database. If all goes well you can continue to the next step.
     
  4. Enter a name and password that will function as the administrator account. As you cannot remove this account you are encouraged to enter a name like admin, system or root. You can rename the account later. You are free to add as many accounts as required once DF/Manager is up-and-running.
     
  5. Installation is now finished. You should remove the installer plugin (/app/plugins/installer) to prevent security risks.
    If you updated from a previous DF/Manager version, the installer will instruct you to run the database update script. Follow these instructions after removing the installer plugin.
     

Done!

That's it, DF/Manager is now installed. Navigate to yoursite/admin to sign in to the administrator pages to further configure your site.