Difference between revisions of "Setup:Installation Guide"
[unchecked revision] | [quality revision] |
(→Für Fortgeschrittene) |
(Tag: 2017 source edit) |
Note: For general questions regarding the installation, maintenance, and usage of BlueSpice, go to our SourceForge help forum .
Contents
- 1 MediaWiki Introduction
- 2 BlueSpice 2.27.1 Prerequesites
- 3 Webservices Installing BlueSpice 3
- 4Additional settings Upgrade and optimizationspatch updates
- 5 Security Settings Migration from MediaWiki to BlueSpice
- 6 System Configuration
- 7 Advanced
- 8 BlueSpice free 2.27.0
This installation manual guides you through the installation of BlueSpice and gives you more detailed information about settings and optimizations.
Introduction[edit | edit source]
We are happy that you decided to install the latest version of BlueSpice, our innovative and feature-packed wiki system. Carefully follow our step-by-step instructions, and BlueSpice will be up and running in no time!
After checking your system requirements and preparing your server environment, you will install the BlueSpice application and optionally tweak your configuration to improve your system performance so that your users can enjoy working with their new wiki.
Prerequesites[edit | edit source]
Before installing BlueSpice 3, review that you meet all system requirements and that your server environment is ready. If you need to set up a server environment first, we provide detailed instructions here:
- Check the system requirements
-
Prepare your system for the BlueSpice installation.
To set up your server environment, follow the step-by-step instructions or read our quick reference:
Installing BlueSpice 3[edit | edit source]
-
Installation Manual MediaWiki
Here you can find an installation guide for MediaWiki, the basis of BlueSpice. -
Update Manual MediaWiki 1.23.x to 1.27.x
Here you can find an update guide for MediaWiki from version 1.23.x to 1.27.x.
BlueSpice 2.27.1[edit | edit source]
-
Installation Manual without installer
This is recommended if you install your BlueSpice on an already existing MediaWiki or if you want to install MediaWiki yourself first (see also Installation Manual MediaWiki). -
Installation Manual with installer
This is recommended if you want to install MediaWiki and BlueSpice together in a single installation process. -
Update Manual
Here you can find an update guide for BlueSpice version 2.23.x (or higher)
Please select which installation type you need:
-
Full BlueSpice 3 installation with Installer
- Extended Functions: VisualEditor, ExtendedSearch
- BlueSpice 3 WikiFarm installation
- Docker image
Upgrade and patch updates[edit | edit source]
- BlueSpice 3 upgrade from version 2.27.x to the current version of BlueSpice
- Patch Update from version 3.1.x to a higher version 3.1.x
- Upgrade from BlueSpice free 3.1.x to BlueSpice pro 3.1.x
Migration from MediaWiki to BlueSpice[edit | edit source]
Quick reference: Configuration, services, and optimization[edit | edit source]
Warning: Pages in the namespaces SocialEntity and User are indexed by search engines by default until version 3.1.13. If you run a public wiki with an earlier version, you should exclude these namespaces from being searchable unless you want these pages to be indexed by public search engines.
If you don't need to set up a server environment "from scratch", you can directly refer to the setup instructions for individual system components. Just make sure that you really have everything configured as needed:
Services and system configuration[edit | edit source]
-
Linux
- Introduction
- Apache und PHP
- MariaDB
- Jetty
- Elasticsearch
- Node.js
- Parsoid
- Python
- Memcached
- Texvc (BlueSpice pro only)
- PhantomJS
- Windows
Webservices for Apache Tomcat[edit | edit source]
- Extended Search
- PDF-Export
- VisualDiff (BlueSpice pro only)
- LatexRenderer (BlueSpice pro only)
Additional settings and optimizations[edit | edit source]
Security
Settingssettings[edit | edit source]
System ConfigurationCompendium[edit | edit source]
- Environment Variables (Windows)
- Apache Tomcat
- Memcached
Advanced[edit | edit source]
BlueSpice free 2.27.0[edit | edit source]
This is the current version of BlueSpice.
The installation process depends on the package you downloaded - BlueSpice with or without installer.
BlueSpice without installer can be installed on an already existing MediaWiki. Please make sure you are using a compatible version of MediaWiki. Check the system requirements first. For the installation, follow the steps of theBlueSpice with installer already includes the appropriate MediaWiki in the recommended version. With the installer, the installation process becomes much easier. If you downloaded BlueSpice with installer, please follow the steps of the
Update to BlueSpice free 2.27.0[edit | edit source]
If you are already using BlueSpice in an older version and you want to update your wiki, please follow the steps of the
{{DISPLAYTITLE:Installationshandbuch}} __TOC__ This installation manual guides you through the installation of BlueSpice and gives you more detailed information about settings and optimizations. ==MediaWiki== * [[Setup:Installation Manual/MediaWiki/Installation|Installation Manual MediaWiki]]<br />Here you can find an installation guide for MediaWiki, the basis of BlueSpice. * [[Setup:Installation Manual/MediaWiki/Update from 1.23.x to 1.27.x|Update Manual MediaWiki 1.23.x to 1.27.x]]<br />Here you can find an update guide for MediaWiki from version 1.23.x to 1.27.x. [[File:Badge.png|right|72x71px]] ==BlueSpice 2.27.1== * [[Setup:Installation Manual/2.27.1/Without Installer|Installation Manual without installer]]<br />This is recommended if you install your BlueSpice on an already existing MediaWiki or if you want to install MediaWiki yourself first (see also [[Setup:Installation Manual/MediaWiki|Installation Manual MediaWiki]]). * [[Setup:Installation Manual/2.27.1/With Installer|Installation Manual with installer]]<br />This is recommended if you want to install MediaWiki and BlueSpice together in a single installation process. * [[Setup:Installation Manual/2.27.1/Update to BlueSpice 2.27.1|Update Manual]]<br />Here you can find an update guide for BlueSpice version 2.23.x (or higher) ==Webservices== * [[Setup:Installation Manual/Webservices/Extended Search|Extended Search]] * [[Setup:Installation Manual/Webservices/PDF-Export|PDF-Export]] * [[Setup:Installation Manual/Webservices/VisualDiff|VisualDiff]] '''(BlueSpice pro only)''' ==Additional settings and optimizations== * [[Setup:Installation Manual/Optimization/Caching|Caching]] * [[Setup:Installation Manual/Optimization/Cronjobs|Cronjobs]] * [[Setup:Installation Manual/Optimization/Time Zone|Time Zone]] ==Security Settings== * [[Setup:Installation Manual/Security Settings/File System Permissions|File System Permissions]] * [[Setup:Installation Manual/Security Settings/Deactivating installcheck file|Deactivating installcheck file]] * [[Setup:Installation Manual/Security Settings/Save Directories|Save Directories]] ==System Configuration== * [[Setup:Installation Manual/System Configuration/Environment Variables|Environment Variables]] (Windows) * [[Setup:Installation Manual/System Configuration/Sourceforge}} ==Introduction== We are happy that you decided to install the latest version of BlueSpice, our innovative and feature-packed wiki system. Carefully follow our step-by-step instructions, and BlueSpice will be up and running in no time! After checking your system requirements and preparing your server environment, you will install the BlueSpice application and optionally tweak your configuration to improve your system performance so that your users can enjoy working with their new wiki. ==Prerequesites== Before installing BlueSpice 3, review that you meet all system requirements and that your server environment is ready. If you need to set up a server environment first, we provide detailed instructions here: #[[Setup:System requirements|Check the system requirements]] #Prepare your system for the BlueSpice installation.<br />To set up your server environment, follow the step-by-step instructions or read our [[Setup:Installation Guide#Quick reference: Configuration, services, and optimization|quick reference]]: #*[[Setup:Installation Guide/System Preparation/Linux/Introduction|Linux]] #*[[Setup:Installation Guide/System Preparation/Windows/Introduction|Windows]] ==Installing BlueSpice 3== Please select which installation type you need: *[[Setup:Installation Guide/With Installer|Full BlueSpice 3 installation with Installer]] **Extended Functions: [[Setup:Installation Guide/Advanced/VisualEditor Configuration|VisualEditor]], [[Setup:Installation Guide/Advanced/ExtendedSearch Configuration|ExtendedSearch]] *[[Setup:Installation Guide/Installation BlueSpice WikiFarm|BlueSpice 3 WikiFarm installation]] *[[Setup:Installation Guide/Docker/Docker Hub|Docker image]] ==Upgrade and patch updates== *[[Setup:Installation Guide/Upgrade|BlueSpice 3 upgrade from version 2.27.x to the current version of BlueSpice]] *[[Setup:Installation Guide/Patch Update|Patch Update from version 3.1.x to a higher version 3.1.x]] *[[Setup:Installation Guide/Upgrade free to pro|Upgrade from BlueSpice free 3.1.x to BlueSpice pro 3.1.x]] == Migration from MediaWiki to BlueSpice == * [[Setup:Installation Guide/Migration from MediaWiki to BlueSpice|Migration from MediaWiki to BlueSpice]] ==Quick reference: Configuration, services, and optimization== {{Box Note|boxtype=warning|Note text=Pages in the namespaces ''SocialEntity'' and ''User'' are indexed by search engines by default until version 3.1.13. If you run a public wiki with an earlier version, you should [https://www.mediawiki.org/wiki/Help:Controlling_search_engine_indexing exclude these namespaces from being searchable] unless you want these pages to be indexed by public search engines.}} If you don't need to set up a server environment "from scratch", you can directly refer to the setup instructions for individual system components. Just make sure that you really have everything configured as needed: ===Services and system configuration=== *Linux **[[Setup:Installation Guide/System Preparation/Linux/Introduction|Introduction]] **[[Setup:Installation Guide/System Preparation/Linux/Apache_and_PHP|Apache und PHP]] **[[Setup:Installation Guide/System Preparation/Linux/MariaDB|MariaDB]] **[[Setup:Installation Guide/System Preparation/Linux/Jetty|Jetty]] **[[Setup:Installation Guide/System Preparation/Linux/Elasticsearch|Elasticsearch]] **[[Setup:Installation Guide/System Preparation/Linux/Node.js|Node.js]] **[[Setup:Installation Guide/System Preparation/Linux/Parsoid|Parsoid]] **[[Setup:Installation Guide/System Preparation/Linux/Python|Python]] **[[Setup:Installation Guide/System Preparation/Linux/Memcached|Memcached]] **[[Setup:Installation Guide/System Preparation/Linux/Texvc|Texvc]] '''(BlueSpice pro only)''' **[[Setup:Installation Guide/System Preparation/Linux/PhantomJS|PhantomJS]] *Windows **[[Setup:Installation Guide/System Preparation/Windows/Introduction|Introduction]] **[[Setup:Installation Guide/System Preparation/Windows/IIS Web Server|IIS Web Server]] **[[Setup:Installation Guide/System Preparation/Windows/Visual_C++_Redistributable_for_Visual_Studio_2015|Visual C++ Redistributable for Visual Studio 2015]] **[[Setup:Installation Guide/System Preparation/Windows/PHP Manager|PHP Manager]] **[[Setup:Installation Guide/System Preparation/Windows/PHP 7.3|PHP 7.3]] **[[Setup:Installation Guide/System Preparation/Windows/MariaDB|MariaDB]] **[[Setup:Installation Guide/System Preparation/Windows/OpenJDK|OpenJDK]] **[[Setup:Installation Guide/System Preparation/Windows/Apache Tomcat|Apache Tomcat]] * *[[Setup:Installation ManualGuide/System Configuration/Memcached|Memcached]] ==Advanced== * [[Setup:Installation Manual/Advanced/Configuration Folder settings.d|Configuration Folder settings.d]] ==BlueSpice free 2.27.0== This is the current version of BlueSpice. The installation process depends on the package you downloaded - BlueSpice with or without installer. '''BlueSpice without installer''' can be installed on an already existing MediaWiki. Please make sure you are using a compatible version of MediaWiki. Check the [[Setup:System requirements|system requirements]] first. For the installation, follow the steps of the * [[Setup:Installation without Installer|Installation manual without installer]] '''BlueSpice with installer''' already includes the appropriate MediaWiki in the recommended version. With the installer, the installation process becomes much easier. If you downloaded BlueSpice with installer, please follow the steps of the * [[Setup:Installation with Installer|Installation manual with installer]] ===Update to BlueSpice free 2.27.0=== If you are already using BlueSpice in an older version and you want to update your wiki, please follow the steps of the * [[Setup:Update Manual|Update manualPreparation/Windows/Elasticsearch|Elasticsearch]] **[[Setup:Installation Guide/System Preparation/Windows/Git|Git]] **[[Setup:Installation Guide/System Preparation/Windows/Node.js|Node.js]] **[[Setup:Installation Guide/System Preparation/Windows/Parsoid|Parsoid]] **[[Setup:Installation Guide/System Preparation/Windows/Python|Python]] **[[Setup:Installation Guide/System Preparation/Windows/PhantomJS|PhantomJS]] '''(BlueSpice pro only)''' ===Webservices for Apache Tomcat=== *[[Setup:Installation Guide/Webservices/PDF-Export|PDF-Export]] *[[Setup:Installation Guide/Webservices/VisualDiff|VisualDiff]] '''(BlueSpice pro only)''' *[[Setup:Installation Guide/Webservices/LatexRenderer|LatexRenderer]] '''(BlueSpice pro only)''' ===Additional settings and optimizations=== *[[Setup:Installation Manual/Optimization/Caching|Caching]] *[[Setup:Installation Manual/Optimization/Cronjobs|Cronjobs]] *[[Setup:Installation Manual/Optimization/Time Zone|Time Zone]] ===Security settings=== *[[Setup:Installation Guide/Security Settings/File System Permissions|File System Permissions]] *[[Setup:Installation Manual/Security Settings/Deactivating installcheck file|Deactivating installcheck file]] *[[Setup:Installation Manual/Security Settings/Save Directories|Save Directories]]<br /> ===Compendium=== {{Special:PrefixIndex/Setup:Installation Guide/Advanced/ |hideredirects=1 |stripprefix=1}} [[en:{{FULLPAGENAME}}]] [[de:Setup:Installationsanleitung]] [[Category:Setup]]
(99 intermediate revisions by 9 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{Sourceforge}} |
− | + | ==Introduction== | |
− | + | We are happy that you decided to install the latest version of BlueSpice, our innovative and feature-packed wiki system. Carefully follow our step-by-step instructions, and BlueSpice will be up and running in no time! | |
− | + | After checking your system requirements and preparing your server environment, you will install the BlueSpice application and optionally tweak your configuration to improve your system performance so that your users can enjoy working with their new wiki. | |
− | |||
− | |||
− | + | ==Prerequesites== | |
− | + | Before installing BlueSpice 3, review that you meet all system requirements and that your server environment is ready. If you need to set up a server environment first, we provide detailed instructions here: | |
− | |||
− | |||
− | |||
− | + | #[[Setup:System requirements|Check the system requirements]] | |
− | + | #Prepare your system for the BlueSpice installation.<br />To set up your server environment, follow the step-by-step instructions or read our [[Setup:Installation Guide#Quick reference: Configuration, services, and optimization|quick reference]]: | |
− | * [[Setup:Installation | + | #*[[Setup:Installation Guide/System Preparation/Linux/Introduction|Linux]] |
− | * [[Setup:Installation | + | #*[[Setup:Installation Guide/System Preparation/Windows/Introduction|Windows]] |
− | == | + | ==Installing BlueSpice 3== |
− | + | Please select which installation type you need: | |
− | |||
− | |||
− | + | *[[Setup:Installation Guide/With Installer|Full BlueSpice 3 installation with Installer]] | |
− | * [[Setup:Installation | + | **Extended Functions: [[Setup:Installation Guide/Advanced/VisualEditor Configuration|VisualEditor]], [[Setup:Installation Guide/Advanced/ExtendedSearch Configuration|ExtendedSearch]] |
− | * [[Setup:Installation | + | *[[Setup:Installation Guide/Installation BlueSpice WikiFarm|BlueSpice 3 WikiFarm installation]] |
− | * [[Setup:Installation | + | *[[Setup:Installation Guide/Docker/Docker Hub|Docker image]] |
− | == | + | ==Upgrade and patch updates== |
− | |||
− | |||
− | |||
− | + | *[[Setup:Installation Guide/Upgrade|BlueSpice 3 upgrade from version 2.27.x to the current version of BlueSpice]] | |
− | * [[Setup:Installation | + | *[[Setup:Installation Guide/Patch Update|Patch Update from version 3.1.x to a higher version 3.1.x]] |
+ | *[[Setup:Installation Guide/Upgrade free to pro|Upgrade from BlueSpice free 3.1.x to BlueSpice pro 3.1.x]] | ||
− | ==BlueSpice | + | == Migration from MediaWiki to BlueSpice == |
− | |||
− | + | * [[Setup:Installation Guide/Migration from MediaWiki to BlueSpice|Migration from MediaWiki to BlueSpice]] | |
+ | ==Quick reference: Configuration, services, and optimization== | ||
+ | {{Box Note|boxtype=warning|Note text=Pages in the namespaces ''SocialEntity'' and ''User'' are indexed by search engines by default until version 3.1.13. If you run a public wiki with an earlier version, you should [https://www.mediawiki.org/wiki/Help:Controlling_search_engine_indexing exclude these namespaces from being searchable] unless you want these pages to be indexed by public search engines.}} | ||
− | ' | + | If you don't need to set up a server environment "from scratch", you can directly refer to the setup instructions for individual system components. Just make sure that you really have everything configured as needed: |
− | + | ===Services and system configuration=== | |
− | '''BlueSpice | + | *Linux |
+ | **[[Setup:Installation Guide/System Preparation/Linux/Introduction|Introduction]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Linux/Apache_and_PHP|Apache und PHP]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Linux/MariaDB|MariaDB]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Linux/Jetty|Jetty]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Linux/Elasticsearch|Elasticsearch]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Linux/Node.js|Node.js]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Linux/Parsoid|Parsoid]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Linux/Python|Python]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Linux/Memcached|Memcached]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Linux/Texvc|Texvc]] '''(BlueSpice pro only)''' | ||
+ | **[[Setup:Installation Guide/System Preparation/Linux/PhantomJS|PhantomJS]] | ||
+ | *Windows | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/Introduction|Introduction]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/IIS Web Server|IIS Web Server]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/Visual_C++_Redistributable_for_Visual_Studio_2015|Visual C++ Redistributable for Visual Studio 2015]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/PHP Manager|PHP Manager]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/PHP 7.3|PHP 7.3]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/MariaDB|MariaDB]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/OpenJDK|OpenJDK]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/Apache Tomcat|Apache Tomcat]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/Elasticsearch|Elasticsearch]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/Git|Git]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/Node.js|Node.js]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/Parsoid|Parsoid]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/Python|Python]] | ||
+ | **[[Setup:Installation Guide/System Preparation/Windows/PhantomJS|PhantomJS]] '''(BlueSpice pro only)''' | ||
− | + | ===Webservices for Apache Tomcat=== | |
− | + | *[[Setup:Installation Guide/Webservices/PDF-Export|PDF-Export]] | |
− | + | *[[Setup:Installation Guide/Webservices/VisualDiff|VisualDiff]] '''(BlueSpice pro only)''' | |
+ | *[[Setup:Installation Guide/Webservices/LatexRenderer|LatexRenderer]] '''(BlueSpice pro only)''' | ||
− | * [[Setup: | + | ===Additional settings and optimizations=== |
+ | |||
+ | *[[Setup:Installation Manual/Optimization/Caching|Caching]] | ||
+ | *[[Setup:Installation Manual/Optimization/Cronjobs|Cronjobs]] | ||
+ | *[[Setup:Installation Manual/Optimization/Time Zone|Time Zone]] | ||
+ | |||
+ | ===Security settings=== | ||
+ | |||
+ | *[[Setup:Installation Guide/Security Settings/File System Permissions|File System Permissions]] | ||
+ | *[[Setup:Installation Manual/Security Settings/Deactivating installcheck file|Deactivating installcheck file]] | ||
+ | *[[Setup:Installation Manual/Security Settings/Save Directories|Save Directories]]<br /> | ||
+ | |||
+ | ===Compendium=== | ||
+ | |||
+ | {{Special:PrefixIndex/Setup:Installation Guide/Advanced/ |hideredirects=1 |stripprefix=1}} | ||
+ | |||
+ | |||
+ | [[en:{{FULLPAGENAME}}]] | ||
+ | [[de:Setup:Installationsanleitung]] | ||
+ | [[Category:Setup]] |