Difference between revisions of "Setup:Installation Guide/With Installer"

{{DISPLAYTITLE:Installation Manual Bluespice 2.27.2 With Installer}}
        
        __TOC__
        
        
        
        
        
        This document describes the steps for the installation of MediaWiki 1.27.1 and BlueSpice 2.27.2 with installer.
        
        
        
        ==Tip for this Document==
        
        * Please, read this manual completely and work through the single installtion steps one after another. 
        
        * For editing the configuration files with a text editor, the files must be saved in UTF-8 coding without BOM (Byte Order Mark).
        
        * The placeholder <code>&lt;installpath-bluespice&gt;</code> stands for the path to your BlueSpice installation, e.g <code>C:\inetpub\wwwroot\bluespice</code> (Windows) or <code>/var/www/bluespice</code> (Linux).
        
        * The placeholder <code>&lt;bluespice-url&gt;</code> stands for the URL to your future BlueSpice installation, e.g. http://localhost/bluespice.
        
        
        
        ==Requirements==
        
        ===Web server===
        
        The system must already be running a Web server (IIS / Apache) that is configured to access <code>&lt;bluespice-url&gt;</code>.
        
        
        
        ===PHP===
        
        PHP must be embedded in the web server. Ensure that the following modules are enabled:
        
        
        
        * php-curl
        
        * php-gd
        
        * php-tidy
        
        
        
        ===MariaDB/MySQL===
        
        A database server (MariaDB oder MySQL) must be set up and available. You need administrative access (root).
        
        
        
        == Download BlueSpice ==
        
        Download the current version of BlueSpice directly at [https://sourceforge.net/projects/bluespice/files/ Sourceforge]. The package is named '''BlueSpice-free-2.27.2.zip'''.
        
        
        
        ==Unzip and Copy BlueSpice==
        
        Unzip the downloaded archive with BlueSpice. Note that the relevant content is located in the subfolder "bluespice-free-installer". Move the complete content to <code>&lt;installpath-bluespice&gt;</code> and integrate it into existing folders.
        
        
        
        ==Renaming of Relevant Folders==
        
        Rename the following folders in <code>&lt;installpath-bluespice&gt;</code> as follows:
        
        
        
        * extensions/BlueSpiceFoundation/data.template<br />--> extensions/BlueSpiceFoundation/data
        
        * extensions/BlueSpiceFoundation/config.template<br />--> extensions/BlueSpiceFoundation/config
        
        
        
        ==Adjusting File System Permissions==
        
        Make sure that the following folders in <code>&lt;installpath-bluespice&gt;</code> are accessible and writable by the webserver:
        
        
        
        * cache
        
        * images
        
        * extensions/BlueSpiceFoundation/data
        
        * extensions/BlueSpiceFoundation/config
        
        
        
        Detailed information about the file system permissions can also be found in our installation manual at the [[Setup:Installation Manual/Security Settings/File System Permissions|security settings]]. 
        
        
        
        ==Starting the installation==
        
        Open <code>&lt;bluespice-url&gt;</code> in your browser. You should get the start page for installation:<br /><br />
        
        
        
        [[File:Setup:Setup_mediawiki_start_installation.jpg|center|250x188px|border]]<br />
        
        
        
        Continue by clicking "set up the wiki".
        
        
        
        ==Language selection==
        
        You will be asked for the language during the installation process and the system language of your installation<br /><br />
        
        
        
        [[File:Setup:Setup_installer_languageselect.jpg|center|400x313px|border]]<br />
        
        
        
        Select the required language and click "Next".<br /><br />
        
        
        
        [[File:Hint.jpg|left]] '''If you want to run your Wiki in German, please note that you have the choice between informal ("de") and formal ("de-formal") mode.'''<br style="clear: left;" />
        
        
        
        ==Checking the Installation Environment==
        
        The following page should allow you to skip with "Next" in most cases. If errors (red font) are displayed, there is a need for action at your server environment. Please do the necessary corrections.
        
        
        
        ==Database Settings==
        
        On the following page, you will be prompted to enter your database settings.
        
        
        
        * If the database server is on the same PC as the MediaWiki installation, please do not use "localhost" but "127.0.0.1".
        
        * The database itself is created in the further process if it does not already exist. You do not have to create the database in advance.
        
        * The database table prefix does not have to be specified. This only makes sense if you need the database for other database tables than for your MediaWiki installation.
        
        * Please enter the user name and password of the administrative database user (usually root).<br /><br />
        
        
        
        [[File:Setup:Setup_installer_database.jpg|400x313px|center|border]]<br />
        
        
        
        Click "Next".
        
        
        
        On the second page about the database it is recommended to create your own database user for your installation. Deactivate the checkbox "Use the same database account as during the installation process" and enter a username and password of your choice. Activate the checkbox "If not already existing, you have to create the account now".<br /><br />
        
        
        
        [[File:Setup:Setup_installer_database2.jpg|400x313px|center|border]]<br />
        
        
        
        Then click "Next".
        
        
        
        ==Wiki Settings==
        
        Now enter a name of your choice for your wiki.
        
        You can also define an administrative user and his password here. You can change the email address of this user at any time in the user settings.
        
        Leave all the other settings as they are and click "Next".<br /><br />
        
        
        
        [[File:Setup:Setup_installer_settings.jpg|400x313px|center|border]]<br />
        
        
        
        ==Extended Settings==
        
        The settings on the now displayed page should be set as shown in the following screenshot. Please adjust the email address according to your needs, the paths in the section "Uploading Images and Files" are automatically filled and should be left as they are.<br /><br />
        
        
        
        [[File:Hint.jpg|left]] '''At this point, no MediaWiki standard extensions will be chosen. The neccessary extensions for BlueSpice will be integrated during the BlueSpice setup. '''<br style="clear: left;" /><br />
        
        
        
        [[File:Setup:Setup_installer_advanced.jpg|center|border|400x598px]]<br />
        
        
        
        Then click on "Next".
        
        Also confirm the following pages with "Next". 
        
        
        
        All necessary settings are made now. Please confirm with "Next" again.
        
        
        
        ==Deposit LocalSettings.php==
        
        Finally, the "LocalSettings.php"  will be provided for downloading it. Please do this and move the file to <code>&lt;installpath-bluespice&gt;</code>.
        
        
        
        ==Checking the Installation Requirements==
        
        Call up the file installcheck.php at <code>&lt;bluespice-url&gt;</code> in your browser (example: http://localhost/installcheck.php).
        
        Correct all red (error) and ideally yellow (warning) declared messages (mostly in the php.ini) like specified. Please note, that changes in the php.ini may require a restart of the webserver. <span id="result_box" class="" lang="en"><span class="">Do not continue until you have been able to remove at least all errors (red). </span></span><br /><br />
        
        
        
        [[File:Setup:Setup_bluespice_installcheck.jpg|center|border|400x313px]]
        
        
        
        ==Check Installation==
        
        Call <code>&lt;bluespice-url&gt;</code> in your browser. BlueSpice should now be successfully installed and a login with your access data should be possible.<br /><br />
        
        
        
        [[File:Setup:Setup_bluespice_finished.jpg|center|border|400x313px]]
        
        
        
        ==Further configuration==
        
        Your BlueSpice installation is now ready to use. You can also do some further configuraiton: 
        
        
        
        * Setup of the [[Setup:Installation Manual/Webservices/Extended Search|extended search ]]
        
        * Setup of the [[Setup:Installation Manual/Webservices/PDF-Export|PDF export]]
        
        * Setup of [[Setup:Installation Manual/Webservices/VisualDiff|VisualDiff]] '''(BlueSpice pro only)'''
        
        
        
            
            
        * Setup of [[Setup:Installation Manual/Webservices/LatexRenderer|LatexRenderer]] '''(BlueSpice pro only)'''
            
            
            
            
        Also, some [[Setup:Installation Manual/Security Settings|security settings]] are recommended.