BlueSpice Wiki - User contributions [en]

BlueSpice free

2019-08-07T13:40:57Z

Angelika:

__NOTOC__

'''BlueSpice free''' is an open source and free of charge MediaWiki distribution, which is developed especially for companies and business. MediaWiki is still the basis and BlueSpice is installed on top to enrich the function range of the wiki with lots of useful features. Even if BlueSpice extends the functionality of MediaWiki and also gives it a completely new look, MediaWiki remains unaffected as the technical basis of the BlueSpice wiki!

==License==
The free software gratis and licensed under the GNU General Public License (GPL) v2 or higher.

==Releases==
The current release of BlueSpice is version 2.27.0.

==Features==
'''BlueSpice free''' is composed of different extensions. Therefore, this is also applies to its functionality, which means that the features of '''BlueSpice free''' arise from the particular feature of the extension.

For a more clearly presentation of the single extensions, we registered them in an extra article in which you can find a short description about the functionality for every extension. The extension names are, of course, linked to the appropriate extension article.

[[Image:ExtensionsFunktionen_en.png|link=http://help.blue-spice.org/index.php/BlueSpice_free_Extensions]]

'''Professional Editing'''

* [[Reference:VisualEditor|Visual Editor (WYSIWYG)]] for editing, formating and content as well as creating tables without wiki code
* Comfortable including [[InsertImage|images]], [[Reference:InsertFile|files]], [[Reference:InsertLink|links]] and [[Reference:InsertCategory|categories]], [[Reference:InsertMagic|wiki commands, wiki tags and Magic Words]], as well as a formatting help for editing without wiki code
* [[ParserFunctions|Parser Functions]] - special functions for creating info boxes and page templates
* [[Reference:RSSFeeder|RSS Import]] enables user to subscribe to pages, categories, namespaces or recent changes

'''Process Support'''

* [[Reference:ReviewExtended|Review]] functionality to review and release articles
* Creating [[Reference:PageTemplates|page templates]] to guarantee a standardized structure of the content
* [[Reference:CategoryTree|Overview of the categories]] in a hierarchic structure, displaying all main categories an sub-categories of the wiki
* Create [[Reference:ImageMap|imagemaps]] and set link on specific areas of an image
* [[Reference:UniversalExport|PDF export]] of single pages in best quality

'''Quality Management'''

* [[StateBar|Status bar]] and [[Reference:Authors|author information]] gives you additional information about an article (e.g. the recent changes, category of the article etc.) and shows the authors of the article with images
* [[MailChanges|Mail notification]] about new articles, edits, deleted or moved articles as well as new users (configurable for every account)
* Display of the [[RecentChanges|recent changes]] can be shown on every wiki page you want or integrated in your widget or menu
* [[Reference:ExtendedStatistics|Statistics]] and graphs for actions with several filter options
* Quality assurance for the content due to the possibility to define [[ResponsibleEditors|responsible editors]] for articles

'''Administration'''

* [[Reference:UserManager|User management]], [[Reference:GroupManager|group management]] and [[Reference:PermissionManager|rights management]] enables you to create user accounts with passwords, provide those with appropriate rights and organize the users in groups with special group rights
* [[Reference:NamespaceManager|Namespace manager]] to organize your namespaces, with which you can define areas in your wiki (you can set seperate read and write rights for every namespace)
* [[UserPreferences|Extendes user preferences]] for personal data, search settings, watchlists etc.
* [[LDAPAuthentication|LDAP authentication]] via Acitve Directory
* [[ExtensionInfo|Extensions information]] gives you an overview about the installed extensions with info about the version, status and a short description
* [[SecureFileStore|Security for images and files]] - your uploaded files can not be found by search engines and can only be accessed with the appropriate authorization

'''Communication and Collaboration'''

* [[Blog|Wiki internal blog]] enables you to write blog articles and to publish news
* [[Shoutbox]] provides an extra area in every article to leave comments and therefore supports discussions and the interaction between the users
* [[Reference:WhoIsOnline|Who is online?]] The answer to this question can be found at a glance, because BlueSpice displays the active users
* Create a [[Reference:Quiz|Quiz]] with multiple choice questions

==Installation==
* [http://sourceforge.net/projects/bluespice/files Download at sourceforge]
* [[Setup:System_requirements|System requirements]]
* [[Setup:Installation_Manual|Installation manual]]

==Join the BlueSpice Community==
'''BlueSpice''' is an open source project and we appreciate every kind of participation on this project. To keep up-to-date and to get the current information, you can use the following channels:

{| style="height: 59px; width: 180px;" border="0" cellspacing="0" cellpadding="0" align="left"
|-
| style="text-align: left;"|[[File:Facebook.png|link=http://www.facebook.com/BlueSpice.for.MediaWiki]]
| style="text-align: center;"|[[File:Twitter.png|link=http://www.twitter.com/BlueSpiceTweets|32x32px]]
| style="text-align: right;"|[[File:Youtube.png|link=http://www.youtube.com/user/BlueSpiceVideo]]
| style="text-align: right;"|[[File:GooglePlus_128_Red.png|link=http://plus.google.com/102189038724381341308/posts|32x32px]]
| style="text-align: right;"|[[File:Wordpress.png|link=http://blog.blue-spice.org|32x32px]]
|}
[[en:{{FULLPAGENAME}}]][[de:BlueSpice free]]

User:Angelika/Books/test

2019-06-24T10:04:35Z

Angelika: Created page with "<bookmeta/> * Software Catalogue * Installation"

<bookmeta/>
* [[Setup:Software Catalogue|Software Catalogue]]
* [[How to become a BlueSpice hacker/Installation|Installation]]

Reference:Math

2019-01-29T14:29:35Z

Angelika:

{{BSExtensionInfobox
|desc=Render mathematical formulas between math-tags
|status=stable
|type=MediaWiki
|edition=BlueSpice
|active=No
|compatible=MediaWiki
|category=Rich Articles
|license=GPL v2+
|docu=https://www.mediawiki.org/wiki/Extension:Math
}}
{{MWlink|https://www.mediawiki.org/wiki/Extension:Math}}
[[en:{{FULLPAGENAME}}]][[de:Referenz:Math]]

[[Category:BlueSpice]]
[[Category:Extension]]

Reference:CustomMenu

2019-01-29T14:29:04Z

Angelika:

{{BSExtensionInfobox
|desc=Provides customizable menus
|status=stable
|developer=HalloWelt
|type=BlueSpice
|edition=BlueSpice
|active=No
|compatible=BlueSpice
|category=Search and Navigation
|license=GPL v3 only
}}
[[en:{{FULLPAGENAME}}]][[de:Referenz:CustomMenu]]

[[Category:BlueSpice]]
[[Category:Extension]]

Reference:BlueSpicePrivacy

2019-01-29T14:28:22Z

Angelika:

{{BSExtensionInfobox
|status=stable
|developer=HalloWelt
|type=BlueSpice
|edition=BlueSpice
|active=No
|compatible=BlueSpice
|category=Security
|license=GPL v3 only
}}
[[en:{{FULLPAGENAME}}]][[de:Referenz:Privacy]]

[[Category:BlueSpice]]
[[Category:Extension]]

Setup:Portal

2018-10-17T16:35:08Z

Angelika:

==Setting up your BlueSpice==
Welcome! This page will help you to set up your own BlueSpice wiki.

{| class="contenttable-darkblue cuscosky"
|-
| style="width: 30%;"|
[[File:information_50px.png|center|link=BlueSpice_3.0|50px]]

<div style="text-align: center;">[[BlueSpice_3.0|Learn more about the latest version of BlueSpice]]</div>
| style="width: 30%;"|
[[File:cog_50px.png|center|link=Setup:System requirements|50px]]

<div style="text-align: center;">[[Setup:System requirements|Check your system requirements]]</div>
| style="width: 30%;"|
[[File:download_50px.png|center|link=Setup:Download|50px]]

<div style="text-align: center;">[[Setup:Download|Download the latest version of BlueSpice]]</div>
|-
||
[[File:book_50px.png|center|link=Setup:Installation Manual|50px]]

<div style="text-align: center;">[[Setup:Installation Manual|Need help with the installation or update? See our installation manuals!]]</div>
||
[[File:pencil_50px.png|center|link=Setup:Release Notes|50px]]

<div style="text-align: center;">[[Setup:Release Notes|Here you can find the release notes of our latest version.]]</div>
||
[[File:stack1_50px.png|center|link=Setup:Release_History|50px]]

<div style="text-align: center;">[[Setup:Release_History|Interested in the development of BlueSpice? Take a look at the release history!]]</div>
|}
[[en:{{FULLPAGENAME}}]][[de:Setup:Portal]]
[[Category:Portal]]

Setup:Installation Manual/Optimization/Cronjobs

2018-10-17T15:59:12Z

Angelika:

{{DISPLAYTITLE:Cronjobs}}
__TOC__

This document describes cronjobs an related configurations, which should be set for your BlueSpice (depending on the used version).

==Tips for this Document==
{{Setup-document-note}}

==runJobs.php==
Time-consuming processes will be moved to a processing queue in the background of BlueSpice. With every page impression, a part of these will be processed. For the case that there are lots of processes in the queue and there are relatively litte page impressions, the tasks will not be processed promptly.

For this reason, the queue should be processed regularly by cronjob.

Now create a cronjob (Windows: "Scheduled task") depending on your operating system. The command to execute is:

php <code><installpath-bluespice></code>/maintenance/runJobs.php ''(Linux)''
php.exe <code><installpath-bluespice></code>\maintenance\runJobs.php ''(Windows)''

{{Hint
|text=It is recommended to specify the complete path to php.exe under Windows. For more information, see the [[Setup:Installation Manual/System Configuration/Environment Variables|environment variables]] document.
}}

Execute the cronjob every '''15 minutes'''.

==processBsEmailBatch.php==
For reports via email sent from MediaWiki, please create a cronjob and run it daily. The command for this is:

php <code><installpath-bluespice></code>/extensions/BlueSpiceEchoConnector/maintenance/processBsEmailBatch.php ''(Linux)''
php.exe <code><installpath-bluespice></code>\extensions\BlueSpiceEchoConnector\maintenance\processBsEmailBatch.php ''(Windows)''

{{Hint
|text=It is recommended to specify the complete path to php.exe under Windows. For more information, see the [[Setup:Installation Manual/System Configuration/Environment Variables|environment variables]] document.
}}

==runNotifications.php (only BlueSpice pro)==
The BlueSpiceReminder notifies the users by email about upcoming tasks in BlueSpice. For this, a cronjob needs to be executed once a day. This is the command:

php <code><installpath-bluespice></code>/extensions/BlueSpiceReminder/Reminder/maintenance/runNotifications.php ''(Linux)''
php <code><installpath-bluespice></code>\extensions\BlueSpiceReminder\Reminder\maintenance\runNotifications.php ''(Windows)''

{{Hint
|text=It is recommended to specify the complete path to php.exe under Windows. For more information, see the [[Setup:Installation Manual/System Configuration/Environment Variables|environment variables]] document.
}}

[[en:{{FULLPAGENAME}}]][[de:Setup:Installationsanleitung/Optimierungen/Cronjobs]]

Setup:Installation Manual/Optimization/Time Zone

2018-10-17T15:56:25Z

Angelika:

{{DISPLAYTITLE:Time Zone}}
__TOC__

Even if every user can change his time zone himself in the user settings, BlueSpice sets the default time zone "Europe/Berlin" when the user first logs in. This document describes how to change this if necessary.

==Tips for this Document==
{{Setup-document-note}}

==Changing the Time Zone==
Copy the file <code><installpath-bluespice></code>/settings.d/001-DefaultSettings.php to <code><installpath-bluespice></code>/settings.d/001-DefaultSettings.local.php and open it. In delivery stat, you can find these two lines there:

$wgLocaltimezone = 'Europe/Berlin';
$wgDefaultUserOptions['timecorrection'] = 'ZoneInfo|' . (date("I") ? 120 : 60) . '|Europe/Berlin';

Replace "Europe / Berlin" with your time zone. An overview of all possible time zones can be found in the [http://php.net/manual/en/timezones.php official PHP documentation].<br />Save and close the file.

[[en:{{FULLPAGENAME}}]][[de:Setup:Installationsanleitung/Optimierungen/Zeitzone]]

Setup:Installation Manual/Optimization/Time Zone

2018-10-17T15:25:28Z

Angelika:

{{DISPLAYTITLE:Time Zone}}
__TOC__

Even if every user can change his time zone himself in the user settings, BlueSpice sets the default time zone "Europe/Berlin" when the user first logs in. This document describes how to change this if necessary.

==Tips for this Document==
{{Setup-document-note}}

==Changing the Time Zone==
Open the file <code><installpath-bluespice></code>/settings.d/001-DefaultSettings.php. In delivery stat, you can find these two lines there:

$wgLocaltimezone = 'Europe/Berlin';
$wgDefaultUserOptions['timecorrection'] = 'ZoneInfo|' . (date("I") ? 120 : 60) . '|Europe/Berlin';

Replace "Europe / Berlin" with your time zone. An overview of all possible time zones can be found in the [http://php.net/manual/en/timezones.php official PHP documentation].<br />Save and close the file.

[[en:{{FULLPAGENAME}}]][[de:Setup:Installationsanleitung/Optimierungen/Zeitzone]]

Setup:Installation Manual/Optimization/Caching

2018-10-17T15:16:56Z

Angelika:

{{DISPLAYTITLE:Caching}}
__TOC__

This document describes different caching options to enhance the performance of your BlueSpice installation.

==Tips for the Document==
* Please, read this manual completely and work through the single installation 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><installpath-bluespice></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).

==Linux vs. Windows==
Please note that with equal hardware conditions, BlueSpice empirically runs more performantly on Linux than on Windows servers.

==Indicate Cache-Directory==
This forces BlueSpice to use the filesystem instead of the database for some internal caches.
To do this, create the file <code><installpath-bluespice></code>/settings.d/001-Directories.php and add the following content:

<source lang="php">
<?php

$wgCacheDirectory = "$IP/cache";
</source>

Save and close the file.

[[File:Hint.jpg|left]] '''Note that the directory "cache" in <code><installpath-bluespice></code> must be writable by the web server. For more information, read the [[Setup:Installation Manual/Security Settings/File System Permissions|file system permissions]].'''

==Name Resolution of the Database==
If this hasn't already been done while setting up MediaWiki, please make sure that the database server will be adressed via IP if it runs on the same server than BlueSpice. Especially Windows has problems with the resolution of "localhost".

To do this, open <code><installpath-bluespice></code>/LocalSettings.php and locate the variable '''$wgDBserver'''. The line should ideally be:

$wgDBserver = "127.0.0.1";

==Activate Memcached==
Create the file <code><installpath-bluespice></code>/settings.d/001-Memcached.php and add the following content:

<source lang="php">
<?php

$wgMainCacheType = CACHE_MEMCACHED;
$wgSessionCacheType = CACHE_DB;
$wgMemCachedServers = [ "127.0.0.1:11211" ];
</source>

Save and close the file.<br /><br />

[[File:Hint.jpg|left]]'''The prerequisite is an installed and configured memcached server on the BlueSpice server. Read the [[Setup:Installation Manual/System Configuration/Memcached|memcached]] article for more information.'''

==Increase PHP Memory Limit==
A higher memory limit of PHP results in a faster execution. ¶ This can be changed in php.ini. Locate and adjust the following option:

memory_limit = 512M ''(means 512 MB - varies from the available memory)''

After saving and closing php.ini, the web server must be restarted.

==Activate Bytecode Cache in PHP==
Since PHP 5.5 the bytecode cache "opcache" is included.

This needs to be activated in the php.ini first. Check if the module is integrated there. This is done via the line:

zend_extension=opcache.dll (Windows)
zend_extension=opcache.so (Linux)

[[File:Hint.jpg|left]] '''Please also note the specification of the distributor for activating PHP modules under Linux.'''

Please, do the following configuration of the opcache in php.ini. Normally, all options should already exist, but are commented out by semicolon (;) at the beginning of the line. Locate the respective option in php.ini, remove the semicolon at the beginning of the line and adjust the settings as follows:

opcache.enable=1
opcache.memory_consumption=512 ''(means 512 MB - varies from the available memory)''
opcache.max_accelerated_files=5000
opcache.validate_timestamps=1
opcache.revalidate_freq=2

After saving and closing php.ini, the web server must be restarted.

==Deactivate JobQueue==
For this, read the [[Setup:Installation Manual/Optimization/Cronjobs#runJobs.php|paragraph "runJobs.php" in the "Cronjobs" article]].

[[en:{{FULLPAGENAME}}]][[de:Setup:Installationsanleitung/Optimierungen/Caching]]

Setup:Installation Manual/Optimization/Caching

2018-10-17T15:09:19Z

Angelika:

{{DISPLAYTITLE:Caching}}
__TOC__

This document describes different caching options to enhance the performance of your BlueSpice installation.

==Tips for the Document==
* Please, read this manual completely and work through the single installation 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><installpath-bluespice></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).

==Linux vs. Windows==
Please note that with equal hardware conditions, BlueSpice empirically runs more performantly on Linux than on Windows servers.

==Indicate Cache-Directory==
This forces BlueSpice to use the filesystem instead of the database for some internal caches.
To do this, create the file <code><installpath-bluespice></code>/settings.d/001-Directories.php and add the following content:

<source lang="php">
<?php

$wgCacheDirectory = "$IP/cache";
</source>

Save and close the file.

[[File:Hint.jpg|left]] '''Note that the directory "cache" in <code><installpath-bluespice></code> must be writable by the web server. For more information, read the [[Setup:Installation Manual/Security Settings/File System Permissions|file system permissions]].'''

==Name Resolution of the Database==
If this hasn't already been done while [[Setup:Installation_Manual/MediaWiki|setting up MediaWiki]], please make sure that the database server will be adressed via IP if it runs on the same server than BlueSpice. Especially Windows has problems with the resolution of "localhost".

To do this, open <code><installpath-bluespice></code>/LocalSettings.php and locate the variable '''$wgDBserver'''. The line should ideally be:

$wgDBserver = "127.0.0.1";

==Activate Memcached==
Create the file <code><installpath-bluespice></code>/settings.d/001-Memcached.php and add the following content:

<source lang="php">
<?php

$wgMainCacheType = CACHE_MEMCACHED;
$wgSessionCacheType = CACHE_DB;
$wgMemCachedServers = [ "127.0.0.1:11211" ];
</source>

Save and close the file.<br /><br />

[[File:Hint.jpg|left]]'''The prerequisite is an installed and configured memcached server on the BlueSpice server. Read the [[Setup:Installation Manual/System Configuration/Memcached|memcached]] article for more information.'''

==Increase PHP Memory Limit==
A higher memory limit of PHP results in a faster execution. ¶ This can be changed in php.ini. Locate and adjust the following option:

memory_limit = 512M ''(means 512 MB - varies from the available memory)''

After saving and closing php.ini, the web server must be restarted.

==Activate Bytecode Cache in PHP==
Since PHP 5.5 the bytecode cache "opcache" is included.

This needs to be activated in the php.ini first. Check if the module is integrated there. This is done via the line:

zend_extension=opcache.dll (Windows)
zend_extension=opcache.so (Linux)

[[File:Hint.jpg|left]] '''Please also note the specification of the distributor for activating PHP modules under Linux.'''

Please, do the following configuration of the opcache in php.ini. Normally, all options should already exist, but are commented out by semicolon (;) at the beginning of the line. Locate the respective option in php.ini, remove the semicolon at the beginning of the line and adjust the settings as follows:

opcache.enable=1
opcache.memory_consumption=512 ''(means 512 MB - varies from the available memory)''
opcache.max_accelerated_files=5000
opcache.validate_timestamps=1
opcache.revalidate_freq=2

After saving and closing php.ini, the web server must be restarted.

==Deactivate JobQueue==
For this, read the [[Setup:Installation Manual/Optimization/Cronjobs#runJobs.php|paragraph "runJobs.php" in the "Cronjobs" article]].

[[en:{{FULLPAGENAME}}]][[de:Setup:Installationsanleitung/Optimierungen/Caching]]

Setup:Installation Manual/Optimization/Caching

2018-10-17T15:07:52Z

Angelika:

{{DISPLAYTITLE:Caching}}
__TOC__

This document describes different caching options to enhance the performance of your BlueSpice installation.

==Tips for the Document==
* Please, read this manual completely and work through the single installation 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><installpath-bluespice></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).

==Linux vs. Windows==
Please note that with equal hardware conditions, BlueSpice empirically runs more performantly on Linux than on Windows servers.

==Indicate Cache-Directory==
This forces BlueSpice to use the filesystem instead of the database for some internal caches.
To do this, create the file <code><installpath-bluespice></code>/settings.d/001-Directories.php and add the following content:

<source lang="php">
<?php

$wgCacheDirectory = "$IP/cache";
</source>

Save and close the file.

[[File:Hint.jpg|left]] '''Note that the directory "cache" in <code><installpath-bluespice></code> must be writable by the web server. For more information, read the [[Setup:Installation Manual/Security Settings/File System Permissions|file system permissions]].'''

==Name Resolution of the Database==
If this hasn't already been done while [[Setup:Installation_Manual/MediaWiki|setting up MediaWiki]], please make sure that the database server will be adressed via IP if it runs on the same server than BlueSpice. Especially Windows has problems with the resolution of "localhost".

To do this, open <code><installpath-bluespice></code>/LocalSettings.php and locate the variable '''$wgDBserver'''. The line should ideally be:

$wgDBserver = "127.0.0.1";

==Activate Memcached==
Create the file <code><installpath-bluespice></code>/settings.d/001-Memcached.php and add the following content:

Save and close the file.<br /><br />

[[File:Hint.jpg|left]]'''The prerequisite is an installed and configured memcached server on the BlueSpice server. Read the [[Setup:Installation Manual/System Configuration/Memcached|memcached]] article for more information.'''

==Increase PHP Memory Limit==
A higher memory limit of PHP results in a faster execution. ¶ This can be changed in php.ini. Locate and adjust the following option:

memory_limit = 512M ''(means 512 MB - varies from the available memory)''

After saving and closing php.ini, the web server must be restarted.

==Activate Bytecode Cache in PHP==
Since PHP 5.5 the bytecode cache "opcache" is included.

This needs to be activated in the php.ini first. Check if the module is integrated there. This is done via the line:

zend_extension=opcache.dll (Windows)
zend_extension=opcache.so (Linux)

[[File:Hint.jpg|left]] '''Please also note the specification of the distributor for activating PHP modules under Linux.'''

Please, do the following configuration of the opcache in php.ini. Normally, all options should already exist, but are commented out by semicolon (;) at the beginning of the line. Locate the respective option in php.ini, remove the semicolon at the beginning of the line and adjust the settings as follows:

opcache.enable=1
opcache.memory_consumption=512 ''(means 512 MB - varies from the available memory)''
opcache.max_accelerated_files=5000
opcache.validate_timestamps=1
opcache.revalidate_freq=2

After saving and closing php.ini, the web server must be restarted.

==Deactivate JobQueue==
For this, read the [[Setup:Installation Manual/Optimization/Cronjobs#runJobs.php|paragraph "runJobs.php" in the "Cronjobs" article]].

[[en:{{FULLPAGENAME}}]][[de:Setup:Installationsanleitung/Optimierungen/Caching]]

Setup:Installation Guide

2018-10-17T14:59:33Z

Angelika:

{{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>

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung]]

Setup:Installation Manual/Services and system configuration/Git

2018-10-17T14:58:30Z

Angelika:

{{DISPLAYTITLE:Installation of Git}}
__TOC__

Git is a version management tool that can be used, among other things, to record changes to files and restore them if necessary.

Git is required for some extensions if they are to be obtained directly from the publisher and are not to be installed using a ready-made installation package.

==Linux==

Under Debian/Ubuntu you can install Git with the following command:
apt install git

==Windows==

===Download Git for Windows===
Download the latest version of Git (64-bit Git for Windows Setup) from the [https://git-scm.com/download/win official project website].

===Installation of Git under Windows===
Install Git into the folder ''\bluespice\bin\git'' with the default settings of the installer. Please pay attention to our notes on the page [[Setup:Installation_Manual/Advanced/Folder_structure_under_Windows|Folder structure under Windows]], which we use in this complete installation manual - do not use spaces and special characters in folder names.

Setup:Installation Manual/Services and system configuration/Git

2018-10-17T14:58:09Z

Angelika: Created page with "{{DISPLAYTITLE:Installation of Git}} __TOC__ Git is a version management tool that can be used, among other things, to record changes to files and restore them if necessary...."

{{DISPLAYTITLE:Installation of Git}}
__TOC__

Git is a version management tool that can be used, among other things, to record changes to files and restore them if necessary.

Git is required for some extensions if they are to be obtained directly from the publisher and are not to be installed using a ready-made installation package.

==Linux==

Under Debian/Ubuntu you can install Git with the following command:
apt install git

==Windows==

===Download Git for Windows===
Download the latest version of Git (64-bit Git for Windows Setup) from the [https://git-scm.com/download/win official project website].

===Installation of Git under Windows===
Install Git into the folder ''\bluespice\bin\git'' with the default settings of the installer. Please pay attention to our notes on the page [[Setup:Installation_Manual/Advanced/Folder_structure_under_Windows|Folder_structure under Windows]], which we use in this complete installation manual - do not use spaces and special characters in folder names.

Setup:Installation Manual/Services and system configuration/Node.js

2018-10-17T14:54:52Z

Angelika:

{{DISPLAYTITLE:Installation of Node.js}}
__TOC__

==System requirements==
The installation of Node.js under Windows can be done via [[Setup:Installation Manual/Services/Git|Git]]. Alternatively, the installation package can be obtained directly from [https://nodejs.org NodeJS].<br>During the installation you have to make sure to install the Node Packet Manager NPM as well.

Under Debian/Ubuntu Nodejs and NPM can be installed as follows:
apt install npm
npm -g install npm@latest

==Download Node.js for Windows==
Download the current package of Node.js from the [https://nodejs.org/en/download/ Project website]. Please use the 64bit version if possible.

==Installation of Node.js==
Install Node.js into the ''\bluespice\bin\nodejs'' folder using the default settings of the installer. When selecting this folder, be sure to pay attention to our instructions on the page [[Setup:Installation_Manual/Advanced/Folder_structure_under_Windows|Folder Structure under Windows]], which we apply in this complete installation manual.

Open a console with administrator rights and change to the installation directory of NodeJS (usually C:\Program Files (x86)\nodejs). Execute the following commands there:
npm install --global --production windows-build-tools
npm -g install npm@latest

Setup:Installation Manual/Services and system configuration/Parsoid

2018-10-17T14:52:44Z

Angelika:

The installation of Parsoid requires the [[Setup:Installation_Manual/Services/Node.js|installation of Node.js]].

The installation can be verified by

<source lang="bash">
$ nodejs --version
$ node -v
$ npm -v
</source>

==Installation and Configuration==
===Linux===

====Install Parsoid====
There is no installation from package sources of the distribution. Parsoid is installed under ''/usr/local''.

For this we move to<source lang="bash">
$ cd /usr/local
</source>

Getting Parsoid:

<source lang="bash">
$ git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid parsoid
</source>

Installing Parsoid:

<source lang="bash">
$ cd parsoid
$ npm install
</source>

Checking the installation:

<source lang="bash">
$ npm test
</source>

Default configuration:

<source lang="bash">
$ cp config.example.yaml config.yaml
</source>

====Configuring Parsoid====
Opening the file config.yaml:

<source lang="bash">
$ vi /usr/local/parsoid/config.yaml
</source>

For the basic installation of Parsoid it is sufficient to adjust the URL to the MediaWiki api ('''uri:''') and the domain ('''domain:'''). We strongly recommend never to work with "localhost" but with the actual vhost alias, with which the MediaWiki can also be reached from outside. This avoids additional Apache configurations.

{{Hint
|text=When using the alias, it is essential to store it with a loopback IP (127.0.0.1) in /etc/hosts! Please also make sure that the web server does not bind to the external IP.
}}

====Start Parsoid manually====
Parsoid can be started manually with console output:

<source lang="bash">
$ npm start
</source>

====Start Parsoid as Daemon====
There are several ways to do this. Most likely pm2 is the best choice, because it combines several applications/services in nodejs.

Installation of pm2:<source lang="bash">
$ npm install -g pm2
</source>

Starting Parsoid as Daemon via pm2:

<source lang="bash">
$ pm2 start /usr/local/parsoid/bin/server.js
</source>

Save the pm2 process list - this will add Parsoid to the pm2 services:

<source lang="bash">
$ pm2 save
</source>

pm2 in den System-Autostart legen:

<source lang="bash">
# Render startup-script for a specific platform, the [platform] could be one of:
# ubuntu|centos|redhat|gentoo|systemd|darwin|amazon
$ pm2 startup [platform]
</source>

===Windows===
Open a console with administrator permissions and change to the installation directory of Node.js (if you followed our recommendations for the [[Setup:Installation_Manual/Advanced/Folder_structure_under_Windows|folder structure under Windows]] ''\bluespice\bin\nodejs''). Execute the command npm install parsoid there.

The configuration of Parsoid under Windows is almost identical to Parsoid under Linux. In this manual, however, there is a distinction between the corresponding articles due to the different paths in the file system. Here, too, we adhere to the above folder structure and assume the paths in this documentation accordingly.

====Creating the configuration file====
Create the file ''\bluespice\etc\parsoid.yaml''. Copy the following content into it:

<pre>worker_heartbeat_timeout: 300000

logging:
level: info

services:
# Enter the absolute path of the index.js in "module".
# in the subfolder "lib" of the parsoid module of nodejs
# The first "/" represents the top level of your drive.
# Don't user "\" but "/"
- module: /bluespice/bin/nodejs/node_modules/parsoid/lib/index.js
entrypoint: apiServiceWorker
conf:
mwApis:
# For "uri", enter the URL where you want the api.php of your MediaWiki
# installation. This must not be a public address, you can use it with
# "localhost", provided that your web server is configured accordingly.
- uri: 'http://localhost/api.php'
domain: 'bluespice'</pre>The two relevant changes that you have to adjust yourself ("module" and "uri") are explained in the corresponding comment above.

Save and close the file.

==Activating VisualEditor in BlueSpice==
Change to the directory ''<installpath-bluespice>/settings.d''. Open the files

'''020-BlueSpiceVisualEditorConnector.php and'''

'''020-VisualEditor.php'''

in a text editor.

In the second line you will find a code that deactivates both extensions:
return; // Disabled. Needs Parsoid
Add a comment character '''(#)''' to the beginning of this line or delete this line completely, save the two files and exit them again.

Now open a command line and change to the folder ''<installpath-bluespice>''. Execute the following command there:
php maintenance/update.php ''(Linux)''
php maintenance\update.php ''(Windows))''

{{Hint
|text=On Windows, make sure that the [[Setup:Installation_Manual/System_Configuration/Environment_Variables|environment variables]] are set correctly to access the php command.}}{{Hint
|text=Note that under Linux, after you run update.php, you must re-customize the [[Setup:Installation_Manual/Security_Settings/File_System_Permissions#Assignment_of_Permissions_with_Linux|file system permisisons]].}}

As soon as the script is completed with the message "Done", the VisualEditor is successfully activated.<br /><br />

Setup:Installation Manual/Services and system configuration/Parsoid

2018-10-17T14:51:53Z

Angelika:

The installation of Parsoid requires the [[Setup:Installation_Manual/Services/Node.js|installation of Node.js]].

The installation can be verified by

<source lang="bash">
$ nodejs --version
$ node -v
$ npm -v
</source>

==Installation and Configuration==
===Linux===

====Install Parsoid====
There is no installation from package sources of the distribution. Parsoid is installed under ''/usr/local''.

For this we move to<source lang="bash">
$ cd /usr/local
</source>

Getting Parsoid:

<source lang="bash">
$ git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid parsoid
</source>

Installing Parsoid:

<source lang="bash">
$ cd parsoid
$ npm install
</source>

Checking the installation:

<source lang="bash">
$ npm test
</source>

Default configuration:

<source lang="bash">
$ cp config.example.yaml config.yaml
</source>

====Configuring Parsoid====
Opening the file config.yaml:

<source lang="bash">
$ vi /usr/local/parsoid/config.yaml
</source>

For the basic installation of Parsoid it is sufficient to adjust the URL to the MediaWiki api ('''uri:''') and the domain ('''domain:'''). We strongly recommend never to work with "localhost" but with the actual vhost alias, with which the MediaWiki can also be reached from outside. This avoids additional Apache configurations.

{{Hint
|text=When using the alias, it is essential to store it with a loopback IP (127.0.0.1) in /etc/hosts! Please also make sure that the web server does not bind to the external IP.
}}

====Start Parsoid manually====
Parsoid can be started manually with console output:

<source lang="bash">
$ npm start
</source>

====Start Parsoid as Daemon====
There are several ways to do this. Most likely pm2 is the best choice, because it combines several applications/services in nodejs.

Installation of pm2:<source lang="bash">
$ npm install -g pm2
</source>

Starting Parsoid as Daemon via pm2:

<source lang="bash">
$ pm2 start /usr/local/parsoid/bin/server.js
</source>

Save the pm2 process list - this will add Parsoid to the pm2 services:

<source lang="bash">
$ pm2 save
</source>

pm2 in den System-Autostart legen:

<source lang="bash">
# Render startup-script for a specific platform, the [platform] could be one of:
# ubuntu|centos|redhat|gentoo|systemd|darwin|amazon
$ pm2 startup [platform]
</source>

===Windows===
__TOC__

Open a console with administrator permissions and change to the installation directory of Node.js (if you followed our recommendations for the [[Setup:Installation_Manual/Advanced/Folder_structure_under_Windows|folder structure under Windows]] ''\bluespice\bin\nodejs''). Execute the command npm install parsoid there.

The configuration of Parsoid under Windows is almost identical to Parsoid under Linux. In this manual, however, there is a distinction between the corresponding articles due to the different paths in the file system. Here, too, we adhere to the above folder structure and assume the paths in this documentation accordingly.

====Creating the configuration file====
Create the file ''\bluespice\etc\parsoid.yaml''. Copy the following content into it:

<pre>worker_heartbeat_timeout: 300000

logging:
level: info

services:
# Enter the absolute path of the index.js in "module".
# in the subfolder "lib" of the parsoid module of nodejs
# The first "/" represents the top level of your drive.
# Don't user "\" but "/"
- module: /bluespice/bin/nodejs/node_modules/parsoid/lib/index.js
entrypoint: apiServiceWorker
conf:
mwApis:
# For "uri", enter the URL where you want the api.php of your MediaWiki
# installation. This must not be a public address, you can use it with
# "localhost", provided that your web server is configured accordingly.
- uri: 'http://localhost/api.php'
domain: 'bluespice'</pre>The two relevant changes that you have to adjust yourself ("module" and "uri") are explained in the corresponding comment above.

Save and close the file.

==Activating VisualEditor in BlueSpice==
Change to the directory ''<installpath-bluespice>/settings.d''. Open the files

'''020-BlueSpiceVisualEditorConnector.php and'''

'''020-VisualEditor.php'''

in a text editor.

In the second line you will find a code that deactivates both extensions:
return; // Disabled. Needs Parsoid
Add a comment character '''(#)''' to the beginning of this line or delete this line completely, save the two files and exit them again.

Now open a command line and change to the folder ''<installpath-bluespice>''. Execute the following command there:
php maintenance/update.php ''(Linux)''
php maintenance\update.php ''(Windows))''

{{Hint
|text=On Windows, make sure that the [[Setup:Installation_Manual/System_Configuration/Environment_Variables|environment variables]] are set correctly to access the php command.}}{{Hint
|text=Note that under Linux, after you run update.php, you must re-customize the [[Setup:Installation_Manual/Security_Settings/File_System_Permissions#Assignment_of_Permissions_with_Linux|file system permisisons]].}}

As soon as the script is completed with the message "Done", the VisualEditor is successfully activated.<br /><br />

Setup:Installation Manual/Services and system configuration/Parsoid

2018-10-17T14:48:28Z

Angelika:

The installation of Parsoid requires the [[Setup:Installation_Manual/Services/Node.js|installation of Node.js]].

The installation can be verified by

<source lang="bash">
$ nodejs --version
$ node -v
$ npm -v
</source>

==Installation and Configuration==
===Linux===

====Install Parsoid ====
There is no installation from package sources of the distribution. Parsoid is installed under ''/usr/local''.

For this we move to<source lang="bash">
$ cd /usr/local
</source>

Getting Parsoid:

<source lang="bash">
$ git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid parsoid
</source>

Installing Parsoid:

<source lang="bash">
$ cd parsoid
$ npm install
</source>

Checking the installation:

<source lang="bash">
$ npm test
</source>

Default configuration:

<source lang="bash">
$ cp config.example.yaml config.yaml
</source>

====Configuring Parsoid ====
Opening the file config.yaml:

<source lang="bash">
$ vi /usr/local/parsoid/config.yaml
</source>

For the basic installation of Parsoid it is sufficient to adjust the URL to the MediaWiki api ('''uri:''') and the domain ('''domain:'''). We strongly recommend never to work with "localhost" but with the actual vhost alias, with which the MediaWiki can also be reached from outside. This avoids additional Apache configurations.

{{Hint
|text=Bei Benutzung des Alias sollte dieser unbedingt mit einer Loopback-IP (127.0.0.1) in der /etc/hosts hinterlegt werden! Dabei ist außerdem darauf zu achten, dass der Webserver nicht auf die externe IP bindet.
}}

====Start Parsoid manually====
Parsoid can be started manually with console output:

<source lang="bash">
$ npm start
</source>

====Start Parsoid as Daemon====
There are several ways to do this. Most likely pm2 is the best choice, because it combines several applications/services in nodejs.

Installation of pm2:<source lang="bash">
$ npm install -g pm2
</source>

Starting Parsoid as Daemon via pm2:

<source lang="bash">
$ pm2 start /usr/local/parsoid/bin/server.js
</source>

Save the pm2 process list - this will add Parsoid to the pm2 services:

<source lang="bash">
$ pm2 save
</source>

pm2 in den System-Autostart legen:

<source lang="bash">
# Render startup-script for a specific platform, the [platform] could be one of:
# ubuntu|centos|redhat|gentoo|systemd|darwin|amazon
$ pm2 startup [platform]
</source>

===Windows===
__TOC__
Open a console with administrator permissions and change to the installation directory of Node.js (if you followed our recommendations for the [[Setup:Installation_Manual/Advanced/Folder_structure_under_Windows|folder structure under Windows]] ''\bluespice\bin\nodejs''). Execute the command npm install parsoid there.

The configuration of Parsoid under Windows is almost identical to Parsoid under Linux. In this manual, however, there is a distinction between the corresponding articles due to the different paths in the file system. Here, too, we adhere to the above folder structure and assume the paths in this documentation accordingly.

====Creating the configuration file====
Create the file ''\bluespice\etc\parsoid.yaml''. Copy the following content into it:

<pre>worker_heartbeat_timeout: 300000

logging:
level: info

services:
# Enter the absolute path of the index.js in "module".
# in the subfolder "lib" of the parsoid module of nodejs
# The first "/" represents the top level of your drive.
# Don't user "\" but "/"
- module: /bluespice/bin/nodejs/node_modules/parsoid/lib/index.js
entrypoint: apiServiceWorker
conf:
mwApis:
# For "uri", enter the URL where you want the api.php of your MediaWiki
# installation. This must not be a public address, you can use it with
# "localhost", provided that your web server is configured accordingly.
- uri: 'http://localhost/api.php'
domain: 'bluespice'</pre>The two relevant changes that you have to adjust yourself ("module" and "uri") are explained in the corresponding comment above.

Save and close the file.

==Activating VisualEditor in BlueSpice==
Change to the directory ''<installpath-bluespice>/settings.d''. Open the files

'''020-BlueSpiceVisualEditorConnector.php and'''

'''020-VisualEditor.php'''

in a text editor.

In the second line you will find a code that deactivates both extensions:
return; // Disabled. Needs Parsoid
Add a comment character '''(#)''' to the beginning of this line or delete this line completely, save the two files and exit them again.

Now open a command line and change to the folder ''<installpath-bluespice>''. Execute the following command there:
php maintenance/update.php ''(Linux)''
php maintenance\update.php ''(Windows))''
{{Hint
|text=On Windows, make sure that the [[Setup:Installation_Manual/System_Configuration/Environment_Variables|environment variables]] are set correctly to access the php command.}}

{{Hint
|text=Note that under Linux, after you run update.php, you must re-customize the [[Setup:Installation_Manual/Security_Settings/File_System_Permissions#Assignment_of_Permissions_with_Linux|file system permisisons]].}}

As soon as the script is completed with the message "Done", the VisualEditor is successfully activated.<br /><br />

Setup:Installation Manual/Services and system configuration/Python

2018-10-17T14:43:07Z

Angelika:

==Download Python==
Download the current Python package from the [https://www.python.org/downloads/ project website].
==Installation of Python==
Install Python and be sure to do this for each user. Install into the folder ''\bluespice\bin\python'' - when selecting this folder, be sure to follow our instructions on the page [[Setup:Installation_Manual/Advanced/Folder_structure_under_Windows|Folder Structure under Windows]].

The most important information about installing Python can be found in these screenshots:
<div style="text-align: center;">[[File:bs3-install-windows-python-01.png|frameless]] [[File:bs3-install-windows-python-02.png|frameless]]</div>

<div style="text-align: center;"></div>
==Installation of Pygmentize==
Open the command prompt with admin privileges. Change to the ''\bluespice\bin\python\Scripts'' folder and enter the command ''"pip install pygments"''. Wait until the following process is complete.

You may be informed that your version of ''pip.exe'' is outdated. You can update it with the command ''python -m pip install --upgrade pip'':
[[File:bs3-install-windows-python-03.png|center|frameless]]

Setup:Installation Guide

2018-10-17T14:39:14Z

Angelika:

{{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]] for BlueSpice version 2.23.x (or higher)

==Services and system configuration==

*[[Setup:Installation Manual/System Configuration/Apache Tomcat|Apache Tomcat]]
*[[Setup:Installation Manual/System Configuration/Apache Tomcat|ElasticSearch]]
*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/Activation and deactivation of BlueSpice-extensions|Activation and deactivation of BlueSpice-extensions]]
*[[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>

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung]]

Setup:Installation Manual/Services and system configuration/Node.js

2018-10-17T14:37:21Z

Angelika:

{{DISPLAYTITLE:Installation of Node.js}}
__TOC__

==System requirements==
The installation of Node.js under Windows can be done via [[Setup:Installation Manual/Services/Git|Git]]. Alternatively, the installation package can be obtained directly from [https://nodejs.org NodeJS].<br>During the installation you have to make sure to install the Node Packet Manager NPM as well.

Under Debian/Ubuntu Nodejs and NPM can be installed as follows:
apt install npm
npm -g install npm@latest

==Download Node.js for Windows==
Download the current package of Node.js from the [https://nodejs.org/en/download/ Project website]. Please use the 64bit version if possible.

==Installation of Node.js==
Install Node.js into the ''\bluespice\bin\nodejs'' folder using the default settings of the installer. When selecting this folder, be sure to pay attention to our instructions on the Folder Structure under Windows page, which we apply in this complete installation manual.

Open a console with administrator rights and change to the installation directory of NodeJS (usually C:\Program Files (x86)\nodejs). Execute the following commands there:
npm install --global --production windows-build-tools
npm -g install npm@latest

Setup:Installation Manual/Services and system configuration/Node.js

2018-10-17T14:32:35Z

Angelika:

{{DISPLAYTITLE:Installation of Node.js}}
__TOC__

==System requirements==
Die Installation von Node.js unter Windows kann über [[Setup:Installationsanleitung/Dienste/Git|Git]] erfolgen. Alternativ kann das Installationspaket für direkt von der [https://nodejs.org NodeJS] bezogen werden.<br>
Bei der Installation ist darauf zu achten, auch den Node Packet Manager NPM zu installieren.

Unter Debian/Ubuntu lässt sich Nodejs und NPM wie folgt installierten:
apt install npm
npm -g install npm@latest

==Download von Node.js für Windows==
Downloaden Sie das aktuelle Paket von Node.js von der [https://nodejs.org/en/download/ Projektwebseite]. Bitte nutzen Sie nach Möglichkeit die 64bit-Version.

==Installation von Node.js==
Installieren Sie Node.js mit den Standardvorgaben des Installers in den Ordner '''\bluespice\bin\nodejs'''. Achten Sie bei dieser Ordnerauswahl unbedingt auf unsere Hinweise auf der Seite [[Setup:Installationsanleitung/Kompendium/Ordnerstruktur_unter_Windows|Ordnerstruktur unter Windows]], die wir in diesem kompletten Installationshandbuch so anwenden.

Öffnen Sie eine Konsole mit Administratorberechtigungen und wechseln Sie dort in das Installationsverzeichnis von NodeJS (im Regelfall C:\Program Files (x86)\nodejs).
Führen Sie dort die folgenden Befehle aus:
npm install --global --production windows-build-tools
npm -g install npm@latest

Setup:Installation Manual/Services and system configuration/Node.js

2018-10-17T14:31:55Z

Angelika: Created page with "{{DISPLAYTITLE:Installation von Node.js}} __TOC__ ==Systemvoraussetzung== Die Installation von Node.js unter Windows kann über Setup:Installationsanleitung/Dienste/Git|Git..."

{{DISPLAYTITLE:Installation von Node.js}}
__TOC__

==Systemvoraussetzung==
Die Installation von Node.js unter Windows kann über [[Setup:Installationsanleitung/Dienste/Git|Git]] erfolgen. Alternativ kann das Installationspaket für direkt von der [https://nodejs.org NodeJS] bezogen werden.<br>
Bei der Installation ist darauf zu achten, auch den Node Packet Manager NPM zu installieren.

Unter Debian/Ubuntu lässt sich Nodejs und NPM wie folgt installierten:
apt install npm
npm -g install npm@latest

==Download von Node.js für Windows==
Downloaden Sie das aktuelle Paket von Node.js von der [https://nodejs.org/en/download/ Projektwebseite]. Bitte nutzen Sie nach Möglichkeit die 64bit-Version.

==Installation von Node.js==
Installieren Sie Node.js mit den Standardvorgaben des Installers in den Ordner '''\bluespice\bin\nodejs'''. Achten Sie bei dieser Ordnerauswahl unbedingt auf unsere Hinweise auf der Seite [[Setup:Installationsanleitung/Kompendium/Ordnerstruktur_unter_Windows|Ordnerstruktur unter Windows]], die wir in diesem kompletten Installationshandbuch so anwenden.

Öffnen Sie eine Konsole mit Administratorberechtigungen und wechseln Sie dort in das Installationsverzeichnis von NodeJS (im Regelfall C:\Program Files (x86)\nodejs).
Führen Sie dort die folgenden Befehle aus:
npm install --global --production windows-build-tools
npm -g install npm@latest

Setup:Installation Guide

2018-10-17T14:30:20Z

Angelika:

{{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]] for BlueSpice version 2.23.x (or higher)

==Services and system configuration==

*[[Setup:Installation Manual/System Configuration/Apache Tomcat|Apache Tomcat]]
*[[Setup:Installation Manual/System Configuration/Apache Tomcat|ElasticSearch]]
*Git
*[[Setup:Installation Manual/System Configuration/Memcached|Memcached]]
*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/Activation and deactivation of BlueSpice-extensions|Activation and deactivation of BlueSpice-extensions]]
*[[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>

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung]]

Setup:Installation Manual/Services and system configuration/Parsoid

2018-10-17T14:29:33Z

Angelika: Angelika moved page Setup:Installation Manual/Servicese/Parsoid to Setup:Installation Manual/Services/Parsoid without leaving a redirect

The installation of Parsoid requires the installation of Node.js.

The installation can be verified by

<source lang="bash">
$ nodejs --version
$ node -v
$ npm -v
</source>

==Installation and Configuration==
===Linux===

====Install Parsoid ====
There is no installation from package sources of the distribution. Parsoid is installed under ''/usr/local''.

For this we move to<source lang="bash">
$ cd /usr/local
</source>

Getting Parsoid:

<source lang="bash">
$ git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid parsoid
</source>

Installing Parsoid:

<source lang="bash">
$ cd parsoid
$ npm install
</source>

Checking the installation:

<source lang="bash">
$ npm test
</source>

Default configuration:

<source lang="bash">
$ cp config.example.yaml config.yaml
</source>

====Configuring Parsoid ====
Opening the file config.yaml:

<source lang="bash">
$ vi /usr/local/parsoid/config.yaml
</source>

For the basic installation of Parsoid it is sufficient to adjust the URL to the MediaWiki api ('''uri:''') and the domain ('''domain:'''). We strongly recommend never to work with "localhost" but with the actual vhost alias, with which the MediaWiki can also be reached from outside. This avoids additional Apache configurations.

{{Hint
|text=Bei Benutzung des Alias sollte dieser unbedingt mit einer Loopback-IP (127.0.0.1) in der /etc/hosts hinterlegt werden! Dabei ist außerdem darauf zu achten, dass der Webserver nicht auf die externe IP bindet.
}}

====Start Parsoid manually====
Parsoid can be started manually with console output:

<source lang="bash">
$ npm start
</source>

====Start Parsoid as Daemon====
There are several ways to do this. Most likely pm2 is the best choice, because it combines several applications/services in nodejs.

Installation of pm2:<source lang="bash">
$ npm install -g pm2
</source>

Starting Parsoid as Daemon via pm2:

<source lang="bash">
$ pm2 start /usr/local/parsoid/bin/server.js
</source>

Save the pm2 process list - this will add Parsoid to the pm2 services:

<source lang="bash">
$ pm2 save
</source>

pm2 in den System-Autostart legen:

<source lang="bash">
# Render startup-script for a specific platform, the [platform] could be one of:
# ubuntu|centos|redhat|gentoo|systemd|darwin|amazon
$ pm2 startup [platform]
</source>

===Windows===
__TOC__
Open a console with administrator permissions and change to the installation directory of Node.js (if you followed our recommendations for the [[folder structure under Windows]] ''\bluespice\bin\nodejs''). Execute the command npm install parsoid there.

The configuration of Parsoid under Windows is almost identical to Parsoid under Linux. In this manual, however, there is a distinction between the corresponding articles due to the different paths in the file system. Here, too, we adhere to the above folder structure and assume the paths in this documentation accordingly.

====Creating the configuration file====
Create the file ''\bluespice\etc\parsoid.yaml''. Copy the following content into it:

<pre>worker_heartbeat_timeout: 300000

logging:
level: info

services:
# Enter the absolute path of the index.js in "module".
# in the subfolder "lib" of the parsoid module of nodejs
# The first "/" represents the top level of your drive.
# Don't user "\" but "/"
- module: /bluespice/bin/nodejs/node_modules/parsoid/lib/index.js
entrypoint: apiServiceWorker
conf:
mwApis:
# For "uri", enter the URL where you want the api.php of your MediaWiki
# installation. This must not be a public address, you can use it with
# "localhost", provided that your web server is configured accordingly.
- uri: 'http://localhost/api.php'
domain: 'bluespice'</pre>The two relevant changes that you have to adjust yourself ("module" and "uri") are explained in the corresponding comment above.

Save and close the file.

==Activating VisualEditor in BlueSpice==
Change to the directory ''<installpath-bluespice>/settings.d''. Open the files

'''020-BlueSpiceVisualEditorConnector.php and'''

'''020-VisualEditor.php'''

in a text editor.

In the second line you will find a code that deactivates both extensions:
return; // Disabled. Needs Parsoid
Add a comment character '''(#)''' to the beginning of this line or delete this line completely, save the two files and exit them again.

Now open a command line and change to the folder ''<installpath-bluespice>''. Execute the following command there:
php maintenance/update.php ''(Linux)''
php maintenance\update.php ''(Windows))''
{{Hint
|text=On Windows, make sure that the [[Setup:Installation_Manual/System_Configuration/Environment_Variables|environment variables]] are set correctly to access the php command.}}

{{Hint
|text=Note that under Linux, after you run update.php, you must re-customize the [[Setup:Installation_Manual/Security_Settings/File_System_Permissions#Assignment_of_Permissions_with_Linux|file system permisisons]].}}

As soon as the script is completed with the message "Done", the VisualEditor is successfully activated.<br /><br />

Setup:Installation Guide

2018-10-17T14:28:13Z

Angelika:

{{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]] for BlueSpice version 2.23.x (or higher)

==Services and system configuration==

*[[Setup:Installation Manual/System Configuration/Apache Tomcat|Apache Tomcat]]
*[[Setup:Installation Manual/System Configuration/Apache Tomcat|ElasticSearch]]
*Git
*[[Setup:Installation Manual/System Configuration/Memcached|Memcached]]
*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/Activation and deactivation of BlueSpice-extensions|Activation and deactivation of BlueSpice-extensions]]
*[[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>

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung]]

Setup:Installation Guide

2018-10-17T14:27:10Z

Angelika:

{{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]] for BlueSpice version 2.23.x (or higher)

==Services and system configuration==

*[[Setup:Installation Manual/System Configuration/Apache Tomcat|Apache Tomcat]]
*[[Setup:Installation Manual/System Configuration/Apache Tomcat|ElasticSearch]]
*Git
*[[Setup:Installation Manual/System Configuration/Memcached|Memcached]]
*Node.js
*[[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/Activation and deactivation of BlueSpice-extensions|Activation and deactivation of BlueSpice-extensions]]
*[[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>

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung]]

Setup:Installation Manual/Services and system configuration/Parsoid

2018-10-17T14:26:26Z

Angelika:

Setup:Installation Manual/Services and system configuration/Parsoid

2018-10-17T13:46:26Z

Angelika:

The installation of Parsoid requires the installation of Node.js.

The installation can be verified by

<source lang="bash">
$ nodejs --version
$ node -v
$ npm -v
</source>

==Installation und Konfiguration==
===Linux===
====Parsoid installieren====
Es wird auf die Installation aus Paketquellen der Distribution verzichtet. Installiert wird Parsoid unter /usr/local.

Hierzu wechseln wir dorthin

<source lang="bash">
$ cd /usr/local
</source>

Holen von Parsoid:

<source lang="bash">
$ git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid parsoid
</source>

Installation von Parsoid:

<source lang="bash">
$ cd parsoid
$ npm install
</source>

Überprüfung der Installation:

<source lang="bash">
$ npm test
</source>

Anlegen der Default-Konfiguration:

<source lang="bash">
$ cp config.example.yaml config.yaml
</source>

====Parsoid konfigurieren====
Öffnen der Datei config.yaml:

<source lang="bash">
$ vi /usr/local/parsoid/config.yaml
</source>

Für die grundlegende Installation von Parsoid ist das Anpassen der URL zur MediaWiki api ('''uri:''') und der domain ('''domain:''') ausreichend. Wir empfehlen unbedingt, niemals mit "localhost" zu arbeiten sondern mit dem tatsächlichen vhost-Alias, mit dem das MediaWiki auch von außen erreichbar ist. So vermeiden werden zusätzliche Apache-Konfigurationen vermieden.

{{Hint
|text=Bei Benutzung des Alias sollte dieser unbedingt mit einer Loopback-IP (127.0.0.1) in der /etc/hosts hinterlegt werden! Dabei ist außerdem darauf zu achten, dass der Webserver nicht auf die externe IP bindet.
}}

====Parsoid manuell starten====
Parsoid kann manuell mit Konsolenausgabe gestartet werden:

<source lang="bash">
$ npm start
</source>

====Parsoid als Daemon starten====
Hierzu gibt es mehrere Möglichkeiten. Am ehesten bietet sich pm2 an, da dies mehrere Anwendungen/Dienste in nodejs vereinigt.

Installation von pm2:

<source lang="bash">
$ npm install -g pm2
</source>

Starten von Parsoid als Daemon via pm2:

<source lang="bash">
$ pm2 start /usr/local/parsoid/bin/server.js
</source>

Speichern der pm2 Prozessliste - dies fügt Parsoid zu den pm2-Diensten fest hinzu:

<source lang="bash">
$ pm2 save
</source>

pm2 in den System-Autostart legen:

<source lang="bash">
# Render startup-script for a specific platform, the [platform] could be one of:
# ubuntu|centos|redhat|gentoo|systemd|darwin|amazon
$ pm2 startup [platform]
</source>

===Windows===
Öffnen Sie eine Konsole mit Administratorberechtigungen und wechseln Sie dort in das Installationsverzeichnis von Node.js (wenn Sie sich an unsere [[Setup:Installationsanleitung/Kompendium/Ordnerstruktur_unter_Windows|Empfehlungen zur Ordnerstruktur unter Windows]] gehalten haben ''\bluespice\bin\nodejs'').
Führen Sie dort den Befehl ''npm install parsoid'' aus.

__TOC__

Die Konfiguration von Parsoid unter Windows ist nahezu identisch zu Parsoid unter Linux. In dieser Anleitung gibt es dennoch eine Unterscheidung der entsprechenden Artikel aufgrund der unterschiedlichen Pfade im Dateisystem. Auch hier halten wir uns an oben erwähnte Ordnerstruktur und gehen entsprechend von den Pfaden in dieser Dokumentation aus.

====Anlegen der Konfigurationsdatei====
Legen Sie die Datei ''\bluespice\etc\parsoid.yaml'' an. Kopieren Sie folgenden Inhalt in diese:

<pre>worker_heartbeat_timeout: 300000

logging:
level: info

services:
# Geben Sie hier bei "module" den absoluten Pfad der index.js
# im Unterordner "lib" des parsoid-Moduls von nodejs an.
# Der erste "/" stellt dabei die oberste Ebene Ihres Laufwerks
# dar. Nutzen Sie keine "\" sondern "/"
- module: /bluespice/bin/nodejs/node_modules/parsoid/lib/index.js
entrypoint: apiServiceWorker
conf:
mwApis:
# Geben Sie bei "uri" die URL an, unter der Sie die api.php
# Ihrer MediaWiki-Installation erreichen können. Dies muss
# keine öffentliche Adresse sein, Sie können durchaus mit
# "localhost" arbeiten, sofern Ihr Webserver entsprechend
# darauf konfiguriert ist.
- uri: 'http://localhost/api.php'
domain: 'bluespice'</pre>

Die beiden relevanten Änderungen, die Sie selber bei Bedarf anpassen müssen ("module" und "uri") sind im entsprechenden Kommentar darüber erklärt.

Speichern und schließen Sie die Datei.

==Aktivieren von VisualEditor in BlueSpice==

Wechseln Sie in das Verzeichnis <code><installpath-bluespice>/settings.d</code>.
Öffnen Sie die Dateien <br>'''020-BlueSpiceVisualEditorConnector.php''' und <br>'''020-VisualEditor.php'''<br> in einem Texteditor.

In der zweiten Zeile finden Sie einen Code, der bei beiden Erweiterungen diese deaktiviert:
return; // Disabled. Needs Parsoid

Fügen Sie wahlweise ein Kommentarzeichen ('''#''') an den Anfang dieser Zeile ein oder löschen Sie diese Zeile komplett, speichern die beiden Dateien und verlassen Sie diese wieder.

Öffnen Sie nun eine Kommandozeile und wechseln in den Ordner <code><installpath-bluespice></code>. Führen Sie dort folgenden Befehl aus:

php maintenance/update.php ''(Linux)''
php maintenance\update.php ''(Windows))''
{{Hint
|text=Achten Sie unter Windows darauf, dass die [[Setup:Installationsanleitung/Systemkonfigurationen/Umgebungsvariablen|Umgebungsvariablen]] korrekt gesetzt sind, um auf den Befehl "php" zugreifen zu können.}}

{{Hint
|text=Beachten Sie unter Linux, dass Sie nach dem Ausführen der update.php die [[Setup:Installationsanleitung/Sicherheitseinstellungen/Dateisystemrechte#Verrechtung_unter_Linux|Dateisystemrechte]] neu anpassen müssen.}}

Sobald das Script mit der Meldung "Done" abgeschlossen ist, ist der VisualEditor erfolgreich aktiviert.<br /><br />

Setup:Installation Manual/Services and system configuration/Parsoid

2018-10-17T13:41:30Z

Angelika: Created page with "The installation of Parsoid requires the installation of Node.js. The installation can be verified by"

The installation of Parsoid requires the installation of Node.js.

The installation can be verified by

Setup:Installation Guide

2018-10-17T13:29:40Z

Angelika:

{{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]] for BlueSpice version 2.23.x (or higher)

==Services and system configuration==

*[[Setup:Installation Manual/System Configuration/Apache Tomcat|Apache Tomcat]]
*[[Setup:Installation Manual/System Configuration/Apache Tomcat|ElasticSearch]]
*Git
*[[Setup:Installation Manual/System Configuration/Memcached|Memcached]]
*Node.js
*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/Activation and deactivation of BlueSpice-extensions|Activation and deactivation of BlueSpice-extensions]]
*[[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>

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung]]

Setup:Installation Manual/Services and system configuration/Python

2018-10-17T13:28:59Z

Angelika: Angelika moved page Setup:Installation Manual/System Configuration/Python to Setup:Installation Manual/Services/Python without leaving a redirect

==Download Python==
Download the current Python package from the [https://www.python.org/downloads/ project website].
==Installation of Python==
Install Python and be sure to do this for each user. Install into the folder ''\bluespice\bin\python'' - when selecting this folder, be sure to follow our instructions on the Folder Structure under Windows page.

The most important information about installing Python can be found in these screenshots:
<div style="text-align: center;">[[File:bs3-install-windows-python-01.png|frameless]] [[File:bs3-install-windows-python-02.png|frameless]]</div>

<div style="text-align: center;"></div>
==Installation of Pygmentize==
Open the command prompt with admin privileges. Change to the ''\bluespice\bin\python\Scripts'' folder and enter the command ''"pip install pygments"''. Wait until the following process is complete.

You may be informed that your version of ''pip.exe'' is outdated. You can update it with the command ''python -m pip install --upgrade pip'':
[[File:bs3-install-windows-python-03.png|center|frameless]]

Setup:Installation Guide

2018-10-17T13:26:49Z

Angelika: /* Services and system configuration */

{{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]] for BlueSpice version 2.23.x (or higher)

==Services and system configuration==

*[[Setup:Installation Manual/System Configuration/Apache Tomcat|Apache Tomcat]]
*[[Setup:Installation Manual/System Configuration/Apache Tomcat|ElasticSearch]]
*Git
*[[Setup:Installation Manual/System Configuration/Memcached|Memcached]]
*Node.js
*Parsoid
*[[Setup:Installation Manual/System Configuration/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/Activation and deactivation of BlueSpice-extensions|Activation and deactivation of BlueSpice-extensions]]
*[[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>

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung]]

Setup:Installation Manual/Services and system configuration/Python

2018-10-17T13:25:44Z

Angelika:

==Download Python==
Download the current Python package from the [https://www.python.org/downloads/ project website].
==Installation of Python==
Install Python and be sure to do this for each user. Install into the folder ''\bluespice\bin\python'' - when selecting this folder, be sure to follow our instructions on the Folder Structure under Windows page.

The most important information about installing Python can be found in these screenshots:
<div style="text-align: center;">[[File:bs3-install-windows-python-01.png|frameless]] [[File:bs3-install-windows-python-02.png|frameless]]</div>

<div style="text-align: center;"></div>
==Installation of Pygmentize==
Open the command prompt with admin privileges. Change to the ''\bluespice\bin\python\Scripts'' folder and enter the command ''"pip install pygments"''. Wait until the following process is complete.

You may be informed that your version of ''pip.exe'' is outdated. You can update it with the command ''python -m pip install --upgrade pip'':
[[File:bs3-install-windows-python-03.png|center|frameless]]

Setup:Installation Manual/Services and system configuration/Python

2018-10-17T13:24:37Z

Angelika:

==Download Python==
Download the current Python package from the [https://www.python.org/downloads/ project website].
==Installation of Python==
Install Python and be sure to do this for each user. Install into the folder ''\bluespice\bin\python'' - when selecting this folder, be sure to follow our instructions on the Folder Structure under Windows page.

The most important information about installing Python can be found in these screenshots:

[[File:bs3-install-windows-python-01.png|frameless]]

[[File:bs3-install-windows-python-02.png|frameless]]

<div style="text-align: center;"></div>
==Installation of Pygmentize==
Open the command prompt with admin privileges. Change to the ''\bluespice\bin\python\Scripts'' folder and enter the command ''"pip install pygments"''. Wait until the following process is complete.

You may be informed that your version of ''pip.exe'' is outdated. You can update it with the command ''python -m pip install --upgrade pip'':
[[File:bs3-install-windows-python-03.png|center|frameless]]

File:bs3-install-windows-python-03.png

2018-10-17T13:24:13Z

Angelika:

Python Installation

File:bs3-install-windows-python-02.png

2018-10-17T13:23:10Z

Angelika:

Phython Installation

File:bs3-install-windows-python-01.png

2018-10-17T13:22:14Z

Angelika:

Python Installation

Setup:Installation Manual/Services and system configuration/Python

2018-10-17T13:00:56Z

Angelika: Created page with " ==Download Python== Download the current Python package from the [https://www.python.org/downloads/ project website]. ==Installation of Python== Install Python and be sure to..."

==Download Python==
Download the current Python package from the [https://www.python.org/downloads/ project website].
==Installation of Python==
Install Python and be sure to do this for each user. Install into the folder ''\bluespice\bin\python'' - when selecting this folder, be sure to follow our instructions on the Folder Structure under Windows page.

The most important information about installing Python can be found in these screenshots:<div style="text-align: center;">[[Datei:Setup:bs3-install-windows-python-01.png|400px|link=https://de.wiki.bluespice.com/wiki/Datei:Setup:bs3-install-windows-python-01.png]] [[Datei:Setup:bs3-install-windows-python-02.png|400px|link=https://de.wiki.bluespice.com/wiki/Datei:Setup:bs3-install-windows-python-02.png]]</div>
==Installation of Pygmentize==
Open the command prompt with admin privileges. Change to the ''\bluespice\bin\python\Scripts'' folder and enter the command ''"pip install pygments"''. Wait until the following process is complete.

You may be informed that your version of ''pip.exe'' is outdated. You can update it with the command ''python -m pip install --upgrade pip'':<div style="text-align: center;">[[Datei:Setup:bs3-install-windows-python-03.png|405x405px|link=https://de.wiki.bluespice.com/wiki/Datei:Setup:bs3-install-windows-python-03.png]]</div>

Setup:Installation Guide

2018-10-17T12:19:43Z

Angelika:

{{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]] '''(BlueSpice free only)'''

=== Update of BlueSpice 3 ===

* [[Setup:Installation_Manual/Update|Update Manual]] for BlueSpice version 2.23.x (or higher)

== Services and Configuration ==

* Git
* Parsoid
* Node.js
* Python
* ElasticSearch
*[[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]]

== 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]]<br />

==Compendium==

*[[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]]
*[[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>

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung]]

File:BlueSpice 2.27.3 - Installation local test system with installer.pdf

2018-10-17T12:18:53Z

Angelika:

Installation local test system with installer

File:BlueSpice 2.27.3 - Installation local test system without installer.pdf

2018-10-17T12:11:42Z

Angelika:

Installation local test system without installer

File:BlueSpice 2.27.3 - Installation with installer.pdf

2018-10-17T12:10:32Z

Angelika:

Installation with installer

Setup:Installation Guide

2018-10-17T12:05:57Z

Angelika:

{{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]] '''(BlueSpice free only)'''

=== Update of BlueSpice 3 ===

* [[Setup:Installation_Manual/Update|Update Manual]] for BlueSpice version 2.23.x (or higher)

== Services and Configuration ==

* Git
* Parsoid
* Node.js
* Python
* ElasticSearch
*[[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]]

== 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]]<br />

==Compendium==

*[[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]]
*[[Setup:Installation Manual/Advanced/Rebuilding the search index|Rebuilding the search index]]

<bs:universalexport:noexport>
==Installation manual archive==
===BlueSpice 2.27.3===

* [[File:BlueSpice 2.27.3 - Installation without installer.pdf|Installation without installer.pdf]]
* Installation with Installer.pdf
* Installation lokales Testsystem ohne Installer.pdf
* Installation lokales Testsystem mit Installer.pdf
* [[File: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>

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung]]

File:BlueSpice 2.27.3 - Installation without installer.pdf

2018-10-17T12:05:11Z

Angelika:

Installation without installer

File:BlueSpice 2.27.3 - Update.pdf

2018-10-17T12:03:57Z

Angelika:

Update manual

Setup:System requirements

2018-10-10T12:12:11Z

Angelika:

__NOTOC__
For a trouble-free installation of the current version BlueSpice 3, we recommend the following system requirements. The application BlueSpice is tested by Hallo Welt! for Windows and Linux. If you are using a different operating system, please contact us.

==MediaWiki==
* Version 1.31.x (LTS -Long Term Support)

==Browser==
* Internet Explorer 11 or higher (without compatibility view)
* Microsoft Edge
* Google Chrome
* Firefox 38+

==Server environment==
* Operating System: Microsoft Windows Server 2012+ or Linux (established distributions)
* Webserver: Apache 2+, IIS 8+
* PHP 7.0+
* MySQL 5.6+ or MariaDB 10+
* Main Memory: > 8 GB (depends on the usage)
** Recommended: 16 GB
* Hard Drive: > 20 GB (depends on the planned storage of data)
* CPU: 4 cores
** Recommended: 8 cores
* Apache Tomcat 8 (for PDF export, version comparison and LaTexRenderer)
* ElasticSearch 6+
* Java 8+
* NodeJS 6+

==Database access==
* Host/IP adress and port
* User name and password for root user (Create/Drop statements) and wiki user (has possibly been created during the MediaWiki installation)
* Name of the database
* The table prefix of the database

<bs:universalexport:noexport>
==Archive: System requirements of older BlueSpice versions==
* [[Media:BlueSpice_System_Requirements_V2273.pdf|BlueSpice version 2.27.3]]
* [[Media:BlueSpice_System_Requirements_V2272.pdf|BlueSpice version 2.27.2]]
* [[Media:BlueSpice_System_Requirements_V2271.pdf|BlueSpice version 2.27.1]]
* [[Media:BlueSpice_System_Requirements_V2270.pdf|BlueSpice version 2.27.0]]
* [[Media:BlueSpice_System_Requirements_V2233.pdf|BlueSpice version 2.23.3]]
* [[Media:BlueSpice_System_Requirements_V2232.pdf|BlueSpice version 2.23.2]]
* [[Media:BlueSpice_System_Requirements_V222x.pdf|BlueSpice version 2.22.x]]
* [[Media:BlueSpice_System_Requirements_V1210.pdf|BlueSpice version 1.21.0]]
</bs:universalexport:noexport>

[[en:{{FULLPAGENAME}}]][[de:Setup:Systemanforderungen]]

Setup:System requirements

2018-10-09T08:27:18Z

Angelika:

__NOTOC__
For a trouble-free installation of the current version BlueSpice 3, we recommend the following system requirements. The application BlueSpice is tested by Hallo Welt! for Windows and Linux. If you are using a different operating system, please contact us.

==MediaWiki==
* Version 1.31.x (LTS -Long Term Support)

==Browser==
* Internet Explorer 11 or higher (without compatibility view)
* Microsoft Edge
* Google Chrome
* Firefox

==Server environment==
* Operating System: Microsoft Windows Server 2012+ or Linux (established distributions)
* Webserver: Apache 2+, IIS 8+
* PHP 7.0+
* MySQL 5.6+ or MariaDB 10+
* Main Memory: > 8 GB (depends on the usage)
** Recommended: 16 GB
* Hard Drive: > 20 GB (depends on the planned storage of data)
* CPU: 4 cores
** Recommended: 8 cores
* Apache Tomcat 8 (for PDF export, version comparison and LaTexRenderer)
* ElasticSearch 6+
* Java 8+
* NodeJS 6+

==Database access==
* Host/IP adress and port
* User name and password for root user (Create/Drop statements) and wiki user (has possibly been created during the MediaWiki installation)
* Name of the database
* The table prefix of the database

<bs:universalexport:noexport>
==Archive: System requirements of older BlueSpice versions==
* [[Media:BlueSpice_System_Requirements_V2273.pdf|BlueSpice version 2.27.3]]
* [[Media:BlueSpice_System_Requirements_V2272.pdf|BlueSpice version 2.27.2]]
* [[Media:BlueSpice_System_Requirements_V2271.pdf|BlueSpice version 2.27.1]]
* [[Media:BlueSpice_System_Requirements_V2270.pdf|BlueSpice version 2.27.0]]
* [[Media:BlueSpice_System_Requirements_V2233.pdf|BlueSpice version 2.23.3]]
* [[Media:BlueSpice_System_Requirements_V2232.pdf|BlueSpice version 2.23.2]]
* [[Media:BlueSpice_System_Requirements_V222x.pdf|BlueSpice version 2.22.x]]
* [[Media:BlueSpice_System_Requirements_V1210.pdf|BlueSpice version 1.21.0]]
</bs:universalexport:noexport>

[[en:{{FULLPAGENAME}}]][[de:Setup:Systemanforderungen]]

Setup:System requirements

2018-10-09T08:26:11Z

Angelika: