Difference between revisions of "Setup:Installation Guide"
[quality revision] | [quality revision] |
(Tag: 2017 source edit) |
Note: For general questions regarding the installation, maintenance, and usage of BlueSpice, go to our SourceForge help forum .
Contents
This installation manual guides you through the installation of BlueSpice 3 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 of BlueSpice 3Before 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]
Update of BlueSpice 3Please 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]
- Update Manual of 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 Tomcat
- ElasticSearch
- Git
- Memcached
-
Windows
- Introduction
- IIS Web Server
- Visual C++ Redistributable for Visual Studio 2015
- PHP Manager
- PHP 7.3
- MariaDB
- OpenJDK
- Apache Tomcat
- Elasticsearch
- Git
- Node.js
- Parsoid
- Python
- PhantomJS (BlueSpice pro only)
Webservices for Apache Tomcat[edit | edit source]
- PDF-Export
- VisualDiff (BlueSpice pro only)
- LatexRenderer (BlueSpice pro only)
Additional settings and optimizations[edit | edit source]
Security settings[edit | edit source]
Compendium[edit | edit source]
Installation manual archive[edit | edit source]
BlueSpice 2.27.3[edit | edit source]
- Installation without installer.pdf
- Installation with installer.pdf
- Installation local test system without installer.pdf
- Installation local test system with installer.pdf
- Update.pdf
BlueSpice 2.27.2[edit | edit source]
- Installation without installer.pdf
- Installation with installer.pdf
- Installation local test system without installer.pdf
- Installation local test system with installer.pdf
- Update.pdf
BlueSpice 2.27.1[edit | edit source]
BlueSpice 2.27.0[edit | edit source]
BlueSpice 2.23.3[edit | edit source]
BlueSpice Mobile[edit | edit source]
{{DISPLAYTITLE:Installation Manual}} __TOC__ This installation manual guides you through the installation of BlueSpice 3 and gives you more detailed information about settings and optimizations. ==BlueSpice 3== ===Installation of BlueSpice 3=== *[[Setup:Installation Manual/With Installer|Installation Manual with installer]] ===Update of BlueSpice 3=== *[[Setup:Installation_Manual/Update|Update Manual]] of BlueSpice from version 2.27.x to the current version BlueSpice 3 ==Services and system configuration== *[[Setup:Installation Manual/System Configuration/Apache Tomcat|Apache Tomcat]] *[[Setup:Installation Manual/System Configuration/ElasticSearch|ElasticSearch]] *[[Setup:Installation Manual/Services/Git|Git]] *[[Setup:Installation Manual/System Configuration/Memcached|Memcached]] *[[Setup:Installation_Manual/Services/Node.js|Node.js]] *[[Setup:Installation_Manual/Services/Parsoid|Parsoid]] *[[Setup:Installation Manual/Services/Python|Python]] *[[Setup:Installation Manual/System Configuration/Environment Variables|Environment Variables]] (Windows) ==Webservices for Apache Tomcat== *[[Setup:Installation Manual/Webservices/PDF-Export|PDF-Export]] *[[Setup:Installation Manual/Webservices/VisualDiff|VisualDiff]] '''(BlueSpice pro only)''' *[[Setup:Installation Manual/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 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]]<br /> ==Compendium== *[[Setup:Installation Manual/Advanced/Configuration Folder settings.d|Configuration Folder settings.d]] *[[Setup:Installation Manual/Advanced/Folder_structure_under_Windows|Folder structure under Windows]] *[[Setup:Installation Manual/Advanced/Rebuilding the search index|Rebuilding the search index]] <bs:universalexport:noexport> ==Installation manual archive== ===BlueSpice 2.27.3=== * [[Media:BlueSpice 2.27.3 - Installation without installer.pdf|Installation without installer.pdf]] * [[Media:BlueSpice 2.27.3 - Installation with installer.pdf|Installation with installer.pdf]] * [[Media:BlueSpice 2.27.3 - Installation local test system without installer.pdf|Installation local test system without installer.pdf]] * [[Media:BlueSpice 2.27.3 - Installation local test system with installer.pdf|Installation local test system with installer.pdf]] * [[Media:BlueSpice 2.27.3 - Update.pdf|Update.pdf]] ===BlueSpice 2.27.2=== *[//en.wiki.bluespice.com/nsfr_img_auth.php/7/73/BlueSpice_2.27.2_-_Installation_without_installer.pdf Installation without installer.pdf] *[//en.wiki.bluespice.com/nsfr_img_auth.php/7/7a/BlueSpice_2.27.2_-_Installation_with_installer.pdf Installation with installer.pdf] *[//en.wiki.bluespice.com/nsfr_img_auth.php/c/c9/BlueSpice_2.27.2_-_Installation_local_test_system_without_installer.pdf Installation local test system without installer.pdf] *[//en.wiki.bluespice.com/nsfr_img_auth.php/9/90/BlueSpice_2.27.2_-_Installation_local_test_system_with_installer.pdf Installation local test system with installer.pdf] *[//en.wiki.bluespice.com/nsfr_img_auth.php/0/0c/BlueSpice_2.27.2_-_Installation_Update.pdf Update.pdf] ===BlueSpice 2.27.1=== *[//en.wiki.bluespice.com/nsfr_img_auth.php/0/0c/BlueSpice2.27.2-Installation_without_Installer.pdf Installation without installer.pdf] *[//en.wiki.bluespice.com/nsfr_img_auth.php/3/3c/BlueSpice2.27.2-Installation_with_Installer.pdf Installation with installer.pdf] *[//en.wiki.bluespice.com/nsfr_img_auth.php/a/a1/BlueSpice2.27.1-Update.pdf Update.pdf] ===BlueSpice 2.27.0=== *[//en.wiki.bluespice.com/nsfr_img_auth.php/5/5b/BlueSpice2.27.0-Installation_without_Installer.pdf Installation without installer.pdf] *[//en.wiki.bluespice.com/nsfr_img_auth.php/7/74/BlueSpice2.27.0-Installation_with_Installer.pdf Installation with installer.pdf] *[//en.wiki.bluespice.com/nsfr_img_auth.php/c/ce/BlueSpice2.27.0-Update.pdf Update.pdf] ===BlueSpice 2.23.3=== *[//en.wiki.bluespice.com/nsfr_img_auth.php/a/a1/BlueSpice_2.23.3_-_Installation_without_installer.pdf Installation without installer.pdf] *[//en.wiki.bluespice.com/nsfr_img_auth.php/0/00/BlueSpice_2.23.3_-_Installation_with_installer.pdf Installation with installer.pdf] *[//en.wiki.bluespice.com/nsfr_img_auth.php/c/c3/BlueSpice_2.23.3_-_Update.pdf Update.pdf] ===BlueSpice Mobile=== *[//en.wiki.bluespice.com/nsfr_img_auth.php/c/cb/BlueSpiceMobile-Installation.pdf Installation.pdf] </bs:universalexport:noexport> 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 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]]
(53 intermediate revisions by 6 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 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 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}}]] | [[en:{{FULLPAGENAME}}]] | ||
[[de:Setup:Installationsanleitung]] | [[de:Setup:Installationsanleitung]] | ||
+ | [[Category:Setup]] |