Installation and update

Requirements

  • Apache web server 1.3.34 or above with the ability to use local .htaccess files (mod_rewrite module is optional, but recommended)
  • MySQL database 5.0 or above
  • PHP 5.4 or above with PDO, pdo_mysql and gd extensions

Getting the sources

At the moment there are several options to get the source of Mibew.

Prebuilt version

This version should be used in the most cases. The installation package is just a .zip (.tar.gz) archive with all Mibew's files. It contains all third-party dependencies. The current stable version is available at SourceForge here.

Building from sources

Prebuilt version cannot suit all needs of the community. In some cases a user may be interested in the latest development version of Mibew or in using custom (patched) version of the Core.

The following instructions are addressed to users who have basic knowledge about node.js, npm, Gulp and Composer.

There are several actions one should do before use the latest version of Mibew from the repository:

  1. Obtain a copy of the repository using git clone, download button, or another way.
  2. Make sure PHP is installed and can be used in CLI mode.
  3. Install node.js and npm.
  4. Install Gulp.
  5. Navigate to src/ directory of the local copy of the repository.
  6. Install npm dependencies using npm install.
  7. Run Gulp to build Mibew using gulp default.

Finally .tar.gz and .zip archives of the ready-to-use Mibew will be available in src/release directory.

Installation

When the archive with Mibew is downloaded the installation process can be started. Here are the instructions:

  1. Create folder with name 'mibew' in the root of your website.
  2. Upload all the files contained in installation archive (retaining the directory structure) into created folder. Be sure to chmod the mibew folder to 0755.
  3. On unix/linux platforms change the owner of /mibew/files/avatar and /mibew/cache folders to the user, under which the web server is running (for instance, www). The owner should have all rights on the folders /mibew/files/avatar and /mibew/cache (chmod 0700 /mibew/files/avatar && chmod 0700 /mibew/cache).
  4. Add a MySQL database with the name mibew
  5. Copy /mibew/configs/default_config.yml to /mibew/configs/config.yml
  6. Edit /mibew/configs/config.yml to the information needed to connect to the database
  7. Using your web browser visit http://<yourdomain>/mibew/install and perform step-by-step installation.
  8. Remove /mibew/install.php file from your server
  9. Logon as
     user: admin
     password: <your password>
    
  10. Configure periodically running tasks by setting up an automated process to visit the page http://<yourdomain>/cron?cron_key=<key>

    The full URL including the secret "cron key" used to protect against unauthorized access can be seen on the 'General' tab at the 'Settings' page.

Update

Mibew starting from 2.0.0-beta.1 version can be updated to later versions using built-in update tool.

Notice that there are neither migration tools nor updtate guides from 1.6.x versions.

  1. Backup your mibew/configs/config.yml
  2. Backup your mibew/files/avatar folder.
  3. Backup your database. Although it's not required, it's strongly recommended to to so.
  4. Disable all plugins
  5. Delete all items in mibew folder on the server.
  6. Upload all files contained in the downloaded archive (retaining the directory structure) into mibew folder.
  7. On unix/linux platforms change the owner of /mibew/files/avatar and /mibew/cache folders to the user, under which the web server is running (for instance, www). The owner should have all rights on the folders /mibew/files/avatar and /mibew/cache (chmod 0700 /mibew/files/avatar && chmod 0700 /mibew/cache).
  8. Restore all settings in mibew/configs/config.yml
  9. Restore contents of mibew/files/avatar folder.
  10. Visit http://<yourdomain>/mibew/update/ and follow the instructions to update the database tables (if needed).
  11. Remove mibew/install.php file from your server.
  12. Enable disabled plugins.

Start work

Congratulations! You finished the installation/update process. Now you should perform several steps to start work:

  1. Get button code at http://<yourdomain>/mibew/operator/button-code.
  2. Add HTML code of the button setup to the target's site markup.
  3. Wait for your visitors on "Pending users" (http://<yourdomain>/mibew/operator/users) page.