glFusion Wiki

Site Tools


glfusion:installation:install_wizard

Running the glFusion Installation Wizard

We are now ready to begin the glFusion installation. To access the installation wizard, navigate to the following URL with your browser (replace the www.yoursitehere.com with your actual URL). Open your browser and navigate to the glFusion installation wizard at /admin/install/index.php. The path to this file will depend on where you chose to put the glFusion files on your web server. The default location is:

http://www.yoursitehere.com/admin/install/index.php

The glFusion installation wizard was designed to automate the install process. Simply follow the installation steps.

glFusion Main Installation Screen

This panel allows you to select the language and the task to perform. For a new installation, choose New Installation then select the Next button.




glFusion Path Selection Screen

You will be asked for the location of the private directory, this is the directory where the db-config.php or db-config.php.dist file resides. Type in the full path to this directory and press Next.

Advanced Settings – Generally you do not need to enter anything here, glFusion will figure out where the files belong based on the path to the private/ directory. In some situations, you may want to move the default locations for the logs, language, backup, or data directories. In this case, you can specify the absolute path to these directories.

Path to private/ directory

glFusion must know where you have installed the private/ directory. This is the directory that contains the db-config.php.dist file. Please enter the full, absolute path to this directory. The absolute path is the full path on the server (not your site's web address). If you don't know the absolute path, check with your hosting provider to obtain this information. Generally, the installer can find the path to your public_html/ folder automatically. In the right panel of this screen we display the absolute path to your current public_html/ directory. This might help you determine the correct path to your private/ directory.

Absolute Path Definition

Also known as the full path, the absolute path is a path that contains the root directory and all other sub directories required to get into the directory you're currently in or wish to get to. Below is a basic example of a generic path and an absolute path. Absolute path:

/home/users/c/computerhope/public_html/cgi-bin

Non absolute path (relative path):

public_html/cgi-bin

As can be seen from the above example, the absolute path contains the full path instead of a few directories contained within the absolute path.


glFusion Host Environment Check Screen

This panel performs a check of the hosting environment to ensure everything is setup properly. Any errors will be highlighted in Red.

During the installation or upgrade process, the glFusion installer will check various attributes of your hosting environment to ensure everything is properly configured. This will ensure that glFusion functions properly and works as it should.

PHP Settings

The installer will check several PHP settings to ensure everything is properly configured both for security and compatibility with glFusion.

If any items are highlighted in red, you should adjust those settings before continuing. Changing the PHP settings varies from host to host, so you should check with your host's technical support for assistance in modifying any PHP settings.

Attribute Suggested Value Description
PHP Version 5.3.3+ glFusion requires PHP version 5.3.3 or newer. It is highly recommended that you run one of the more recent versions of PHP such as v7.0 or newer.
register_globals Off If PHP's register_globals is enabled, it can create security issues. It is highly recommended that you turn off register_globals.
safe_mode Off If PHP's safe_mode is enabled, some functions of glFusion may not work correctly. Specifically the Media Gallery plugin. glFusion can run with safe mode enabled, but we may ask that you turn it off if there are support issues.
open_basedir Off If open_basedir restrictions are enabled on your site, it may cause permission problems during the install. The File System Check will attempt to validate that glFusion has the proper permissions for all its directories, but you may need to ask your host to either turn off these restrictions or allow full read/write access to your entire web space.
memory_limit 64M It is recommended that you have at least 64M of memory enabled on your site. Depending on which plugins you have loaded and if you are uploading large images, 64M or more memory will be required.
file_uploads On Many features of glFusion require the ability to upload files, this should be enabled.
upload_max_filesize 8M glFusion allows you to upload plugins, images, and files. You should allow at least 8M for the upload size. This setting controls how large of a file you can upload.
post_max_size 8M post_max_size controls how large a single submit can be. If this value is smaller that upload_max_size, it will limit the size of the file you can upload. Also, if you are uploading multiple files on a single form (in Media Gallery for example), the total size of all items cannot exceed this value.

File System Check

The glFusion installer will test several directories to ensure it has the necessary permissions to read and write. If any issues are found they will be highlighted. You cannot continue the installation or upgrade process until these issues are resolved.

glFusion must be able to write to several areas of your site. For example, to upload and install plugins using the automated install process, glFusion must be able to write all the plugin's source files into the proper private/plugins/ and public_html/pluginname/ directories.

If your site has open_basedir restrictions enabled, you may need to contact your hosting provider and ask that they add the necessary glFusion directories to the allowed directory list.

Also, you can override some of the default directory location in the Path and Settings Screen. By overriding the default directories you may be able to resolve some permission issues caused by open_basedir restrictions.

open_basedir Restrictions

Some hosting services enable a PHP security feature known as open_basedir restriction. What this means is that the provider has set up a list of directories that PHP can write to. If a directory is not in the list, it simply will not allow any files to be created or modified in that directory.

Generally, when a provider implements open_basedir restrictions, they will allow the web server to write to files in the public_html/ directory, but may not allow files in the private/ directory to be modified. This can cause a problem when installing glFusion since we separate out several files into the private/ directory.

Fortunately, there is a simple solution. Move all the private/ files into a directory under your public_html/ directory. Don't call it private, instead make up a name that no one would be able to easily guess. It is only important that you know the directory name. Try to install glFusion again, this time when asked for the private/ directory path, give it the path of your new directory under public_html/. 99% of the time this will resolve open_basedir permission problems.

Changing the PHP settings

How you change the PHP settings such as memory_limit varies from provider to provider. The best option is to contact the host's technical support or system administrator for assistance with changing the PHP settings.


Site Information Screen

The Site Information panel allows you to enter the database information and the general site information.

Database Type

glFusion supports the MySQL database or MariaDB, a drop-in replacement for MySQL. There are two types of indexes which can be used, ISAM and InnoDB. For larger sites, InnoDB may provide better performance. If you are not sure, select MySQL installation (without InnoDB). You can always convert later if needed.

You should configure your database to use UTF-8 encoding (i.e.; utf8mb4_unicode_ci). If you are running an older version of MySQL that does not support UTF8MB4 - use utf8_general_ci.

Database Hostname

Enter the hostname of the database server. This may not be the same as your web server, so check with your hosting provider if you are not sure. For most users this will be localhost.

Database Name

Enter the name of the database that will be used to hold the glFusion tables. This database must already exist.

Database Username

Enter the username to connect to the database. If you do not know the database username, contact your hosting provider.

Database Password

Enter the password to connect to the database. If you do not know the database password, contact your hosting provider.

Database Table Prefix

Enter a table prefix to be used for the database tables. This is helpful to separate multiple sites or systems when using a single database.

UTF-8

UTF-8 encoding will allow your site to display characters in multiple languages. Generally this should be checked.

It is also important to ensure your database is setup to handle UTF-8 encoding as well. When you create the database for glFusion, select utf8mb4_unicode_ci if available, or utf8_unicode_ci if the utf8mb4 option is not available, as the collation. You may need to check with your hosting provider to ensure you database can and does support UTF-8 encoding.

Site Information

This section contains information about your site; URLs, paths, etc. Much of this information will automatically be entered by the installation wizard, in those cases you simply need to validate that it is correct.

Site Name

This is the name of your site and will be displayed in the site header and as part of the page title. You can change the Site Name at any time using the Online Configuration.

Site Slogan

This is a short description about your site. It will be displayed in the site header and also used in emails generated by your site.

Site Email

Enter your site's main email address. This is the email address for the default Admin account. Don't worry; it can always be changed later.

Site No Reply Email

Enter your site's no reply email address. It will be used to automatically send new user, password reset, and other notification emails. Don't worry; it can always be changed later.

Site URL

Please confirm that this is the web address or URL used to access the homepage of your site.

Site Admin URL

Please confirm that this is the web address or URL used to access the admin section of your site.


Content & Plugins Screen

Once you hit this screen, the installation process has completed the core installation and now needs to know which of the bundled plugins you would like to install.

Also, glFusion comes with some sample content to help show off some of its unique features. It is recommended if you are new to glFusion, you should load the sample content. It can all be deleted once you have seen how it all works and are ready to build your own customized site.

Options

Load Sample Site Content?
If checked, install sample content such as blocks, stories, and static pages. This is recommended for new users of glFusion.
Load Calendar Plugin?
An online calendar / event system. Includes a site wide calendar and personal calendars for site users.
Load FileMgmt Plugin?
File Download Manager. An easy way to provide file downloads, organized by category.
Load Forum Plugin?
An online community forum system. Provides community collaboration and interactivity.
Load Links Plugin?
A links management system. Provides links to other interesting sites, organized by category.
Load Media Gallery Plugin?
A multi-media management system. Can be used as a simple photo gallery or a robust media management system supporting audio, video, and images.
Load Polls Plugin?
An online polling system. Provides polls for your site users to vote on various topics.

Success!

Once the installation is complete, please do the following:

  • Login with the default username / password (admin / password) and immediately change the password.

  • Check out the Quick Start page and browse through the documentation to see what all you can do with your glFusion site.

glfusion/installation/install_wizard.txt · Last modified: 2017/04/12 21:11 (external edit)

Page Tools