Difference between revisions of "Setup:Installation Guide"
[unchecked revision] | [quality revision] |
RichardHeigl (talk | contribs) (→System Configuration) |
(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 4
- 2 BlueSpice 2.27.1
- 3 Webservices
- Prerequesites
- 3 Installing BlueSpice 3
- 4 Upgrade and patch updates
- 5 Migration from MediaWiki to BlueSpice
- 6 Quick reference: Configuration, services, and optimization 5
- Settings
- System Configuration
- 7 Advanced
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]
-
Installation Manual MediaWiki
Here you can find an installation guide for MediaWiki, the basis of BlueSpice. -
Update Manual MediaWiki
Here you can find an update guide for MediaWiki from version 1.23.x to 1.27.x.
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]
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]
-
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 (BlueSpice free only)
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)
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]
Advanced[edit | edit source]
{{DISPLAYTITLE:Installation Manual}} __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|Update Manual MediaWiki]]<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]] <b>(BlueSpice free only)</b><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|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 ManualSourceforge}} ==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 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 ManualGuide/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 Manualsettings=== *[[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]] ==System Configuration== * [[Setup:Installation Manual/System Configuration/Environment Variables|Environment Variables]] (Windows) * [[Setup:Installation Manual/System Configuration/Apache Tomcat|Apache Tomcat]] * [[Setup:Installation Manual/System Configuration/Memcached|Memcached]] * [[Improve_speed_performance|Improve speed performance]] ==Advanced== * [[Setup:Installation Manual/Advanced/Configuration Folder settings.d|Configuration Folder settings.d]] * [[Setup:Installation Manual/Advanced/Activation and deactivation of BlueSpice-extensions|Activation and deactivation of BlueSpice-extensions<br /> ===Compendium=== {{Special:PrefixIndex/Setup:Installation Guide/Advanced/ |hideredirects=1 |stripprefix=1}} [[en:{{FULLPAGENAME}}]] [[de:Setup:Installationsanleitung]] [[Category:Setup]]
(89 intermediate revisions by 8 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 | + | *[[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 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)''' | ||
+ | |||
+ | ===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]] |