--------------------------------------------------
CMS Made Simple PHAR Based Installation Assistant
--------------------------------------------------
This document describes using the CMS Made Simple PHAR Based installation assistant.
The PHAR based installation assistant is a stand-alone PHP application built to provide
the ability to install, upgrade, or freshen CMS Made Simple from within a single
easy-to-use PHP script.
-------------------
NOTE:
-------------------
The PHAR based installation assistant is a binary file and must be transferred in binary mode!
-------------------
Requirements
-------------------
1. The installation assistant requires a PHP environment with a minimum version of PHP 7.1.
2. The website's PHP environment must include the PHAR extension.
3. For new installations of CMS Made Simple you should create a new mysql database and database user.
- The database user must have ALL PRIVILEGES to all tables within the new database.
- Your database user account must have a password.
4. CMS Made Simple itself requires at least PHP 7.1 with numerous libraries enabled
(the install assistant will check for these) including json, tokenizer, xml, and gd.
-------------------
Instructions
-------------------
1. Upload the cmsms-<version>-install.php file to your website top directory.
2. In your web browser, navigate to <your web directory>/cmsms-<version>-install.php
For example: http://www.mywebsite.site/cmsms-3.44.55-install.php
You should now be presented with a welcome screen. If, instead, you see a white screen it probably means that your
server is running old, or incompatible, software and that you may be forced to use the traditional installer. It is a good
hint that if the Phar installer will not run you may have further problems with CMS Made Simple on that server.
The installation assistant can then be used to guide you through the process of installing a new version of CMSMS,
Upgrading an existing installation of CMSMS, or freshening an existing version of CMSMS. There are various options
for each path through the installation assistant and 9 steps
Step 1:
The first step asks you to select a language and optionally allows you to enable "Advanced Mode". Advanced Mode
enables several additional options throughout the assistant and increases the verbosity of status output.
Step 2:
The second step does checks for existing software in your installation directory. If an existing installation of
CMS Made Simple is detected you will be presented with options to proceed through the "upgrade" or "freshen" paths
(depending upon the version detected). If no version of CMS Made Simple is installed you will be guided through the
"installation" process.
Step 3:
Step 3 performs various tests on your PHP environment to try to ensure that it is compatible with
CMS Made Simple. If important tests fail, you will be notified of them and not allowed to continue. However, if
some non-critical tests fail you will be allowed to continue. We recommend that you adjust your PHP environment
(you may need to contact your host for assistance) until all tests pass.
Step 4:
This step is used only during installation and freshen sessions. It asks you to provide basic configuration information
for the CMS Made Simple environment. This includes database information and credentials, and a server time zone.
As mentioned in the requirements above, CMSMS requires a mysql database to store data, and user credentials to access
that mysql database. The user account provided must have ALL PRIVILEGES to the database. You can normally create
databases, and create user accounts for database from within your web host's control panel.
Additionally, you are asked to specify the time zone of the server (not your local time zone). You may need to ask your
host for information about this.
Upon submit, the installation assistant will validate your database credentials, and check the database to ensure
you are not accidentally overwriting an existing installation of CMSMS.
Step 5:
This step is used only during an installation session. It asks you to provide basic credentials of the first admin user
account. This admin user account allows you to log in to the CMSMS admin console with all privileges and access to all
of its functionality. From within the CMSMS admin console you can create user groups, and further user accounts
for additional site managers or editors.
Unless you have enabled "advanced mode" in step 1, you must also provide an email address. The email address will be
used to send you your login credentials in the event of a lost or forgotten password.
Step 6:
This step asks you for a human readable name for your website, and allows you to select additional language packs to install.
Additional language packs allow users who login to the CMSMS admin console to display the output in their native language.
Please note: although there are multiple languages available, not all of them are complete.
Step 7:
This step copies all of the CMSMS core files from within the installation assistant into your CMS Made Simple install.
It also cleans up those files.
Step 8:
This step interacts with the database to ensure that all tables and initial content are created properly.
During the installation process numerous tables and indexes are created in the database, and necessary initial data are installed.
Additionally (if so selected) sample site-content is installed. That provides useful instruction on how to interact with,
and build sites with, CMS Made Simple. It is recommended reading.
During an upgrade session, any necessary database changes are performed to ensure that the database tables, and their contents,
are compatible with the new version of CMSMS.
Step 9:
This step finishes the installation and performs a clean-up.
During the installation process all core modules and selected non-core modules (if any) are installed, necessary temporary directories created, and the configuration file
is written.
During the upgrade process core modules and selected non-core modules (if any) are upgraded if necessary, and a new version of the configuration file is written.
Any existing configuration file is backed up for safety. Additionally, the CMSMS cache is cleared.
After everything is complete you will be presented with links to either visit the CMSMS website, or to log in to its admin console.
-----------
Afterwards
-----------
After confirming that the site is working as expected, confirm that the installer .php file and related folder (with all its contents)
have been deleted from the server. If not so, delete them manually, using the site's file manager (in cPanel or the like).
Likewise for any intaller.ini file, in the site-root folder, that was used to facilitate the installer session.
---------------------
Additional Features
---------------------
The single installation assistant package provides these features:
1. Installing a new version of CMSMS into an empty directory.
2. Upgrading an existing version of CMSMS to a new version
3. Freshening (or repairing) an existing installation of CMSMS
This option may be useful for fixing a corrupted installation of CMSMS. Only available when the current version of CMSMS and the new version are identical, it will replace all of the core files with those distributed by the system and re-generate a new config.php file.
4. Installing additional language packages
As part of the "Freshen" functionality, when repairing an installation you have the option to install additional language packs.
5. Advanced vs. Simple mode
---------------------------
Parameter Details
---------------------------
1. tmpdir=/absolute/path
Specify the absolute path to the directory to be used for temporary files. This directory must be writable by the PHP process. This option should not be needed on most hos