BlueSpice Wiki - User contributions [en]

SocialEntity:6452

2021-07-27T12:32:34Z

Mmeixner:

{
"social-profile-title": null,
"social-profile-name": null,
"social-profile-email": null,
"social-profile-department": "",
"social-profile-function": "",
"social-profile-location": "",
"social-profile-phone": "",
"description": "",
"parentid": 0,
"id": 6452,
"ownerid": 50,
"type": "profile",
"archived": false,
"tags": [
"User:Mmeixner"
],
"resolved": false
}

SocialEntity:6409

2021-07-22T06:45:20Z

Mmeixner:

{
"social-profile-title": null,
"social-profile-name": null,
"social-profile-email": null,
"social-profile-department": "",
"social-profile-function": "",
"social-profile-location": "",
"social-profile-phone": "",
"description": "",
"parentid": 0,
"id": 6409,
"ownerid": 50,
"type": "profile",
"archived": false,
"tags": [
"User:Mmeixner"
],
"resolved": false
}

Setup:Installation Guide/System Preparation/Windows/Git

2021-07-21T13:48:40Z

Mmeixner:

{{DISPLAYTITLE:Git on Windows}}
__TOC__

{{Template:Optional|text=Git is an application for software version management. It is required for the installation of Node.js, which in turn is required for the operation of the rendering service "Parsoid" for the Visual Editor. The steps listed here are optional and only required if you want to use them in your BlueSpice installation.}}
==Download==
In the Internet Explorer, open the [https://git-scm.com/download/win official download page on git-scm.com] (1). If the optimal download for your operating system does not start automatically, click on "64-bit Git for Windows Setup" (2):

[[File:Setup:Git_Download_01.png|center|400px|Git Download 01]]

Follow the further download instructions and download the installation package to your hard disk.

{{Template:Hint|text=Please note that the download on your Windows Server with Internet Explorer only works if you have configured the Internet Explorer Advanced Security Settings in the Server Manager. Please refer to the technical documentation from Microsoft.}}
{{Template:Hint|text=Git version 2.19.1 will be used below as an example. You can download the latest version of Git at the time of installation.}} 
==Installing Git==
Open the downloaded Git-2.19.1-64-bit.exe file.

Start the installation by clicking "Next >":

[[File:Setup:Git_Install_01.png | center | 400px | Git Installation 01]]

Click, as pictured here, through the further installation steps:

<gallery>
File:Setup:Git_Install_02.png
File:Setup:Git_Install_03.png
File:Setup:Git_Install_04.png
File:Setup:Git_Install_05.png
File:Setup:Git_Install_06.png
File:Setup:Git_Install_07.png
File:Setup:Git_Install_08.png
File:Setup:Git_Install_09.png
File:Setup:Git_Install_10.png
File:Setup:Git_Install_11.png
</gallery>

You can close the setup program now:

[[File:Setup:Git_Install_12.png|center|400px|Git Installation 12]] 
==Next step==
If you have completed all steps successfully, you can delete the previously downloaded file "Git-2.19.1-64-bit.exe" from your hard disk and go to the next step"[[Setup:Installation Guide/System Preparation/Windows/Node.js | Node. js]]".

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung/Systemvorbereitung/Windows/Git]]

SocialEntity:6408

2021-07-21T13:48:40Z

Mmeixner:

{
"wikipageid": 4401,
"revisionid": 27219,
"namespace": 3008,
"titletext": "Installation Guide/System Preparation/Windows/Git",
"action": "edit",
"summary": "(No summary)",
"parentid": 0,
"id": 6408,
"ownerid": 50,
"type": "articlesave",
"archived": false,
"tags": [],
"resolved": false
}

Setup:Installation Guide/System Preparation/Windows/Apache Tomcat

2021-07-21T13:47:09Z

Mmeixner:

{{DISPLAYTITLE:Apache Tomcat on Windows}}
__TOC__

{{Template:Optional|text=Apache Tomcat is required for the PDF export, VisualDiff (BlueSpice pro only) and the LaTeX renderer (BlueSpice pro only). The following steps are optional and only required if you want to use one or more of these services in your BlueSpice installation.}}
{{Template:Hint|text=Operation of Apache Tomcat requires [[Setup:Installation Guide/System Preparation/Windows/OpenJDK| OpenJDK]]. If you have not installed it, follow the link above.}}
==Download==
Open the [http://tomcat.apache.org/ official download page] (1) in your browser and go to the version 9 (2) download page.

[[File:Setup:Tomcat_Download_01.png|center|400px|Tomcat Download 01]]

Download the "32-bit/64-bit Windows Service Installer"

[[File:Setup:Tomcat_Download_02.png|center|400px|Tomcat Download 02]]

{{Template:Hint|text=Please note that the download on your Windows server with Internet Explorer only works if you have configured the Internet Explorer Advanced Security Settings in the Server Manager. Please refer to the technical documentation from Microsoft.}}

{{Template:Hint|text=This guide uses version 9.0.16 of Apache Tomcat and is just an example of the latest version that you can download at the time of installation.}}
==Installing Apache Tomcat==
Open the downloaded file "apache-tomcat-9.0.16.exe".

Start the installation by clicking "Next >":

[[File:Setup:Tomcat_Install_01.png|center|400px|Tomcat Installation 01]]

Confirm the license agreement by clicking "I Agree":

[[File:Setup:Tomcat_Install_02.png|center|400px|Tomcat Installation 02]]

Click "Next >":

[[File:Setup:Tomcat_Install_03.png|center|400px|Tomcat Installation 03]]

Click "Next >" again:

[[File:Setup:Tomcat_Install_04.png|center|400px|Tomcat Installation 04]]

Select (1) the home directory of your [[Setup:Installation Guide/System Preparation/Windows/OpenJDK | OpenJDK Installation]] (2) and click "Next>" (3):

[[File:Setup:Tomcat_Install_05.png|center|400px|Tomcat Installation 05]]

Start the Tomcat Installation:

[[File:Setup:Tomcat_Install_06.png|center|400px|Tomcat Installation 06]]

At the end of the installation, leave both preselected checkboxes (1) and finish the setup (2)

[[File:Setup:Tomcat_Install_07.png|center|400px|Tomcat Installation 07]]

==Configuring Apache Tomcat==
Change to the installation directory of Tomcat. By default, you can find it at <code>C:\Program Files\Apache Software Foundation\Tomcat 9.0\conf</code>.

Open the context.xml file in a text editor and replace the one-time line
<pre><Context></pre>
with
<pre><Context mapperContextRootRedirectEnabled="true"></pre>

[[File:Setup:Tomcat_Configuration_01.png|center|400px|Tomcat Configuration 01]]

Save and close the file.

In the same directory, open the file server.xml in a text editor and make sure that the complete block
<pre><Connector port="8080" protocol="HTTP/1.1"
... /></pre>
looks like this:
<pre><Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
URIEncoding="UTF-8"
redirectPort="8443"
address="127.0.0.1" /></pre>

[[File:Setup:Tomcat_Configuration_02.png|center|400px|Tomcat Configuration 02]]

Save and close the file.

Find the entry "Configure Tomcat" in the start menu and open it:

[[File:Setup:Tomcat_Configuration_03.png|center|400px|Tomcat Configuration 03]]

Set "Startup type" to "Automatic" (1) and start Tomcat (2). Then exit the configuration console (3):
[[File:Setup:Tomcat_Configuration_04.png|center|400px|Tomcat Configuration 04]]

==Reviewing the installation==
To check if Tomcat is working correctly, open the address <nowiki>http://localhost:8080/</nowiki> in a browser on the server. 
You should now see the homepage of the Tomcat server:

[[File:Setup:Tomcat_Check_01.png|center|400px|Tomcat Check 01]]

==Installing the web apps==
After the successful installation of BlueSpice, please follow the next steps to install the web services and activate the respective BlueSpice extension:

*[[Setup:Installation Guide/Webservices/PDF-Export|PDF-Export]]
*[[Setup:Installation Guide/Webservices/VisualDiff|VisualDiff]] (BlueSpice pro only)
*[[Setup:Installation Guide/Webservices/LatexRenderer|LatexRenderer]] (nurBlueSpice pro only)

==Next step==
If you have completed all steps successfully, you can delete the previously downloaded "apache-tomcat-9.0.16.exe" file from your hard drive and continue to the next step "[[Setup: Installation Guide/System Preparation/Windows/Elasticsearch | Elasticsearch]]".

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung/Systemvorbereitung/Windows/Apache_Tomcat]]

SocialEntity:6407

2021-07-21T13:47:09Z

Mmeixner:

{
"wikipageid": 4386,
"revisionid": 27217,
"namespace": 3008,
"titletext": "Installation Guide/System Preparation/Windows/Apache Tomcat",
"action": "edit",
"summary": "(No summary)",
"parentid": 0,
"id": 6407,
"ownerid": 50,
"type": "articlesave",
"archived": false,
"tags": [],
"resolved": false
}

Setup:Installation Guide/System Preparation/Windows/MariaDB

2021-07-21T13:43:00Z

Mmeixner:

{{DISPLAYTITLE:MariaDB on Windows}}
__TOC__

{{Template:Important|text=BlueSpice stores your content in a database for which you need to install a corresponding server. The steps listed here are required.}}

==Introduction==
Alternatively, you can use MySQL at this point, but we recommend the database server MariaDB described in the following document.

==Download==
In Internet Explorer, open the [https://downloads.mariadb.org/mariadb official download page] (1). Click on the corresponding download link (2).

[[File:Setup:MariaDB_Download_01.png|center|400px|MariaDB Download 01]]

Select the MSI package in the 64bit version:

[[File:Setup:MariaDB_Download_02.png|center|400px|MariaDB Download 02]]

Follow the further download instructions and download the installation package to your hard disk.

{{Template:Hint|text=Please note that the download on your Windows Server with Internet Explorer only works if you have configured the Internet Explorer Advanced Security Settings in the Server Manager. Please refer to the technical documentation from Microsoft.}}

{{Template:Hint|text=In the following the MariaDB version 10.3.13 is used and serves as an example only for the latest version, which you can download at the time of your installation.}}
==Installing MariaDB==
Open the file just downloaded "mariadb-10.3.13-winx64.msi".

Start the installation by clicking "Next":

[[File:Setup:MariaDB_Install_01.png|center|400px|MariaDB Installation 01]]

Confirm the license agreement (1) and click "Next" (2):

[[File:Setup:MariaDB_Install_02.png|center|400px|MariaDB Installation 02]]

The next step you confirm by clicking on "Next".

[[File:Setup:MariaDB_Install_03.png|center|400px|MariaDB Installation 03]]

Give an Password which will be for the administrational User ("root") of the Data Base Server (1) and click on "Next" (2):

[[File:Setup:MariaDB_Install_04.png|center|400px|MariaDB Installation 04]]

The next step you confirm by clicking "next":

[[File:Setup:MariaDB_Install_05.png|center|400px|MariaDB Installation 05]]

Confirm the next step by clicking "Next":

[[File:Setup:MariaDB_Install_06.png|center|400px|MariaDB Installation 06]]

Now start the installation:

[[File:Setup:MariaDB_Install_07.png|center|400px|MariaDB Installation 07]]

When the installation is complete, exit the installer:

[[File:Setup:MariaDB_Install_08.png|center|400px|MariaDB Installation 08]]

==Setting the environment variable==
To use MariaDB easily on the command line of Windows, it is necessary to configure an environment variable in Windows accordingly. To do this, perform the following steps:

Enter the key combination Windows + R.

In the following dialog enter "SystemPropertiesAdvanced.exe" (1) and confirm with OK (2):

[[File:Setup:EnvironmentVariables_01.png|center|400px|Umgebungsvariablen 02]]

Click "Environment variables":

[[File:Setup:EnvironmentVariables_02.png|center|400px|Umgebungsvariablen 03]]

In the bottom pane of the now opened window double-click on the line "Path":

[[File:Setup:EnvironmentVariables_03.png|center|400px|Umgebungsvariablen 04]]

Click "New":

[[File:Setup:EnvironmentVariables_04.png|center|400px|Umgebungsvariablen 05]]

Add the path to your installation of MariaDB, which contains i.a. the file mysql.exe is located. By default, this is the path <code>C:\Program Files\MariaDB 10.3\bin </code>.
[[File:Setup:MariaDB_EnvironmentVariables_01.png|center|400px|Umgebungsvariablen 06]]

Close all previously opened windows one after the other by clicking "OK".

==Next step==
If you have completed all steps successfully, you can delete the previously downloaded "mariadb-10.3.13-winx64.msi" file from your hard disk and continue to the next step "[[Setup: Installation Guide/System Preparation/Windows/OpenJDK |OpenJDK]]".

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung/Systemvorbereitung/Windows/MariaDB]]

SocialEntity:6406

2021-07-21T13:43:00Z

Mmeixner:

{
"wikipageid": 4378,
"revisionid": 27215,
"namespace": 3008,
"titletext": "Installation Guide/System Preparation/Windows/MariaDB",
"action": "edit",
"summary": "(No summary)",
"parentid": 0,
"id": 6406,
"ownerid": 50,
"type": "articlesave",
"archived": false,
"tags": [],
"resolved": false
}

SocialEntity:6405

2021-07-21T13:34:31Z

Mmeixner:

{
"wikipageid": 4374,
"revisionid": 27213,
"namespace": 3008,
"titletext": "Installation Guide/System Preparation/Windows/PHP 7.3",
"action": "edit",
"summary": "(No summary)",
"parentid": 0,
"id": 6405,
"ownerid": 50,
"type": "articlesave",
"archived": false,
"tags": [],
"resolved": false
}

Setup:Installation Guide/System Preparation/Windows/PHP 7.3

2021-07-21T13:34:31Z

Mmeixner:

{{DISPLAYTITLE:PHP 7.3 on Windows}}
__TOC__

{{Template:Important|text=The source code of BlueSpice is based on the scripting language "PHP". It must be installed on your server in order to operate BlueSpice. The steps listed here are required.}}
==Introduction==
PHP is not installed with a "classic installation package", but the sources are downloaded and integrated in IIS via the [[Setup:Installation Guide/System Preparation/Windows/PHP_Manager | previously installed PHP Manager]].
==Downloading PHP==

In your browser, open the [https://windows.php.net/download/ official download page for Windows on php.net] (1). Find the latest version 7.3.x (2) 64-bit (3) Thread-Safe (4) and download it here (5): [[File:Setup:PHP_Download_01.png|center|400px|PHP Download 01]]

Follow the download instructions.

 {{Template:Hint|text=Please note that the download on your Windows Server with Internet Explorer will only work if you have configured the Internet Explorer Advanced Security Settings in the Server Manager. Please refer to the technical documentation from Microsoft.}}

{{Template:Hint|text=The following is PHP version 7.3.3 and is only an example of the latest version 7.3.x that you can download at the time of your installation.}}
==Unzipping the ZIP archive==
Unzip the ZIP archive just downloaded into a useful system path on your hard drive.

{{Template:Hint|text=This documentation assumes the [[Setup:Installation Guide/Advanced/Windows_Folder_Structure|recommended folder structure]].
For this reason PHP will be unpacked into the folder C:\bluespice\bin\php-7.3.3. If you have a different folder structure, you must adapt these paths accordingly.}}
==Setting the environment variable==
In order to use PHP easily on the command line of Windows, it is necessary to configure an environment variable in Windows accordingly. To do this, perform the following steps:

Enter the key combination Windows+R.

In the following dialog enter "SystemPropertiesAdvanced.exe" (1) and confirm with OK (2):[[File:Setup:EnvironmentVariables_01.png|center|400px|Environment variables 02]]

Click "Environment variables":[[File:Setup:EnvironmentVariables_02.png|center|400px|Environment variables 03]]

In the lower part of the now opened window double-click on the line "Path":[[File:Setup:EnvironmentVariables_03.png|center|400px|Environment variables 04]]

Click "New":[[File:Setup:EnvironmentVariables_04.png|center|400px|Environment variables 05]]

Add the path to your unpacked PHP version, which contains the php.exe file:[[File:Setup:PHP_EnvironmentVariables_01.png|center|400px|Environment variables 06]]

Close all newly opened windows one after the other by clicking on "OK".
==Checking the environment variable==
To make sure the environment variable is set correctly, perform the following steps:

Enter the key combination Windows+R.

In the following dialog, enter "cmd" (1) and confirm with OK (2):[[File:Setup:PHP_EnvironmentVariables_02.png|center|400px|Environment variables 07]]

At the command prompt, type "php -v" (1) and press the Enter key. The found PHP version will be displayed (2).[[File:Setup:PHP_EnvironmentVariables_03.png|center|400px|Environment variables 08]]

If this is not the case, then the path to the php.exe file in the environment variables was incorrectly specified.
==Configuring IIS for PHP==
In the following steps, PHP will be included in IIS and IIS will be configured to provide a working basic setup:

First, call IIS Manager. To do this, enter the key combination Windows+R.

In the following dialog, enter "inetmgr" (1) and confirm with "OK" (2):

[[File:Setup:PHP_IIS_Config_01.png|center|400px|PHP and IIS 01]]

In the left pane, select your server name (1) and then double-click "PHP Manager" (2):

[[File:Setup:PHP_IIS_Config_02.png|center|400px|PHP and IIS 02]]
Click "Register new PHP version":[[File:Setup:PHP_IIS_Config_03.png|center|400px|PHP and IIS 03]]

In the following window select the browse "(...)" button:

[[File:Setup:PHP_IIS_Config_04.png|center|400px|PHP and IIS 04]]

'''To manage the PHP settings in the next window:'''

Change to the path to which you previously unzipped PHP (1), mark the "php-cgi.exe" (2) and confirm the dialog with "Open" (3):

[[File:Setup:PHP_IIS_Config_05.png|center|400px|PHP and IIS 05]]

Confirm again with "OK":

[[File:Setup:PHP_IIS_Config_06.png|center|400px|PHP and IIS 06]]

Click on "Configure error reporting":[[File:Setup:PHP_IIS_Config_07.png|center|400px|PHP and IIS 07]]

Activate the item "Production machine" (1) and select a path and a file of your choice where PHP should save its log (2). Confirm with "Apply" (3):

[[File:Setup:PHP_IIS_Config_08.png|center|400px|PHP and IIS 08]]

{{Template:Hint|text=This documentation assumes the [[Setup:Installation Guide/Advanced/Windows_Folder_Structure|recommended folder structure]]. If the path you specify here does not yet exist, please create it before clicking "Apply".}}

Click "Manage all settings":

[[File:Setup:PHP_IIS_Config_09.png|center|400px|PHP and IIS 09]]

Adjust the following settings:

{| style="align:middle"
! style="" |Name
! style="" |Value
! style="" |Section
|-
| style="" |date.timezone
| style="" |"Europe/Berlin" ''oder entsprechend Ihrer Zeitzone''
| style="" |Date
|-
| style="" |max_execution_time
| style="" |600
| style="" |PHP
|-
| style="" |post_max_size
| style="" |128M
| style="" |PHP
|-
| style="" |upload_max_filesize
| style="" |128M
| style="" |PHP
|}

To find these options faster, you can also use the filter (1). Go back afterwards (2):

[[File:Setup:PHP_IIS_Config_10.png|center|400px|PHP and IIS 10]]

In the main window, click "Enable or disable an extension":

[[File:Setup:PHP_IIS_Config_11.png|center|400px|PHP and IIS 11]]

Make sure that the following extensions are enabled:

[[File:Setup:PHP_IIS_Config_12.png|center|400px|PHP and IIS 12]]

To activate an extension, select it in the "Disabled" section (1) and activate it by clicking on "Enable" (2):

[[File:Setup:PHP_IIS_Config_13.png|center|400px|PHP and IIS 13]]

In the next step, expand the tree on the left until the "Default Web Site" becomes visible:

[[File:Setup:PHP_IIS_Config_14.png|center|400px|PHP and IIS 14]]

Right-click (1) and then click "Remove" (2):

[[File:Setup:PHP_IIS_Config_15.png|center|400px|PHP and IIS 15]]

Confirm the following dialog with "Yes":

[[File:Setup:PHP_IIS_Config_16.png|center|400px|PHP and IIS 16]]

Right-click on "Sites" (1) and click on "Add Website" (2):

[[File:Setup:PHP_IIS_Config_17.png|center|400px|PHP and IIS 17]]

Enter the site name "BlueSpice" (1) and select the path on your server where your BlueSpice installation will be located later (2). Confirm with "OK" (3):
[[File:Setup:PHP_IIS_Config_18.png|center|400px|PHP and IIS 18]]

{{Template:Hint|text=This documentation assumes the [[Setup:Installation Guide/Advanced/Windows_Folder_Structure|recommended folder structure]]. If the path you specify here does not yet exist, please create it before clicking "OK".}}

The new page is now listed in the IIS overview page:

[[File:Setup:PHP_IIS_Config_19.png|center|400px|PHP and IIS 19]]

==Next step==
If you have successfully completed all these steps, you can proceed to the next step "[[Setup: Installation Guide/System Preparation/Windows/MariaDB | MariaDB]]".

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP_7.3]]

Setup:Installation Guide/System Preparation/Windows/PHP Manager

2021-07-21T13:28:44Z

Mmeixner:

{{DISPLAYTITLE:PHP Manager on Windows}}
__TOC__

{{Template:Important|text=PHP Manager conveniently integrates PHP into your IIS installation. The steps listed here are required.}}
==Download==
In the Internet Explorer, open the [https://www.iis.net/downloads/community/2018/05/php-manager-150-for-iis-10 official download page on iis.com] (1). Click "Download this extension" (2).

[[File:Setup:PHPManager_Download_01.png|center|400px|PHP Manager Download 01|link=https://en.wiki.bluespice.com/wiki/File:Setup:PHPManager_Download_01.png]]

Confirm the following dialog with "OK":

[[File:Setup:PHPManager_Download_02.png|center|400px|PHP Manager Download 02|link=https://en.wiki.bluespice.com/wiki/File:Setup:PHPManager_Download_02.png]]Follow the further download instructions and download the installation package to your hard disk.

{{Template:Hint|text=Please note that the download on your Windows server with Internet Explorer only works if you have configured the Internet Explorer Advanced Security Settings in the Server Manager. Please note the technical documentation from Microsoft.}}

==Installing PHP Manager==
Open the downloaded PHPManagerForIIS_V1.5.0.msi file.

Start the installation by clicking "Next >":

[[File:Setup:PHPManager_Install_01.png|center|400px|PHP Manager Installation 01|link=https://en.wiki.bluespice.com/wiki/File:Setup:PHPManager_Install_01.png]]

Confirm the license (1) and click on "Next >" (2):

[[File:Setup:PHPManager_Install_02.png|center|400px|PHP Manager Installation 02|link=https://en.wiki.bluespice.com/wiki/File:Setup:PHPManager_Install_02.png]]

The installation is now executed and completed without further confirmation. You can close the setup program when finished:

[[File:Setup:PHPManager_Install_03.png|center|400px|PHP Manager Installation 03|link=https://en.wiki.bluespice.com/wiki/File:Setup:PHPManager_Install_03.png]]

==Next step==
If you have completed all steps successfully, you can delete the previously downloaded "PHPManagerForIIS_V1.5.0.msi" file from your hard disk and continue to the next step "[[Setup:Installation Guide/System Preparation/Windows/PHP 7.3|PHP 7.3]]".
[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung/Systemvorbereitung/Windows/PHP_Manager]]

SocialEntity:6404

2021-07-21T13:28:44Z

Mmeixner:

{
"wikipageid": 4350,
"revisionid": 27211,
"namespace": 3008,
"titletext": "Installation Guide/System Preparation/Windows/PHP Manager",
"action": "edit",
"summary": "(No summary)",
"parentid": 0,
"id": 6404,
"ownerid": 50,
"type": "articlesave",
"archived": false,
"tags": [],
"resolved": false
}

SocialEntity:6403

2021-07-21T13:27:00Z

Mmeixner:

{
"wikipageid": 4312,
"revisionid": 27209,
"namespace": 3008,
"titletext": "Installation Guide/System Preparation/Windows/IIS Web Server",
"action": "edit",
"summary": "(No summary)",
"parentid": 0,
"id": 6403,
"ownerid": 50,
"type": "articlesave",
"archived": false,
"tags": [],
"resolved": false
}

Setup:Installation Guide/System Preparation/Windows/IIS Web Server

2021-07-21T13:26:59Z

Mmeixner:

__TOC__

{{Template:Important|text=The web server delivers your BlueSpice installation to the users' browsers. Without a web server, BlueSpice cannot be used. The steps listed here are required.}}

==Introduction==
We recommend to use the most system-optimized software possible for a live operation of BlueSpice both under Linux and under Windows. For this reason, the documentation of an installation of Apache (XAMP) under Windows is omitted.
This chapter lists the steps that are necessary to install the Microsoft IIS Web Server service on Windows Server >= 2012.

==The Server Manager and managing roles==
First, open the Server Manager. Unless otherwise configured, it starts automatically as soon as you log in to the server. Otherwise, you will find it in the start menu under the search term "Server Manager".
You are now in the following view:
[[File:Setup:Server_Manager_01.png|center|400px|Server Manager 01|link=https://en.wiki.bluespice.com/wiki/File:Setup:Server_Manager_01.png]]Click "Manage" (1) und then "Add Roles and Features" (2):[[File:Setup:Server_Manager_02.png|center|400px|Server Manager 02|link=https://en.wiki.bluespice.com/wiki/File:Setup:Server_Manager_02.png]]
==Installing IIS in the Role Manager==
You are now in the Role Manager.

Click "Next >" until you reach the "Server Roles" area (1). There, you activate the role "Web Server (IIS)" (2):
[[File:Setup:IIS_Install_01.png|center|400px|IIS Installation 01|link=https://en.wiki.bluespice.com/wiki/File:Setup:IIS_Install_01.png]]Confirm the pop-up that shows the selection of the role with "Add Features":[[File:Setup:IIS_Install_02.png|center|400px|IIS Installation 02|link=https://en.wiki.bluespice.com/wiki/File:Setup:IIS_Install_02.png]]Click "Next >":[[File:Setup:IIS_Install_03.png|center|400px|IIS Installation 03|link=https://en.wiki.bluespice.com/wiki/File:Setup:IIS_Install_03.png]]You are now in the "Features" area(1). Activate ".NET Framework 3.5 Features" (2) and click "Next >" (3):[[File:Setup:IIS_Install_04.png|center|400px|IIS Installation 04|link=https://en.wiki.bluespice.com/wiki/File:Setup:IIS_Install_04.png]]{{Template:Hint|text=The .NET Framework 3.5 is not directly required for running IIS. However, tools that will be installed later, which are also partially connected with IIS, definitely require it. For this reason, we install it now.}}

Confirm the following dialog with "Next >":[[File:Setup:IIS_Install_05.png|center|400px|IIS Installation 05|link=https://en.wiki.bluespice.com/wiki/File:Setup:IIS_Install_05.png]] Under "Role Services" (1) select "Application Development" (2) with the option "CGI" (3) and confirm with "Next >" (4):[[File:Setup:IIS_Install_06.png|center|400px|IIS Installation 06|link=https://en.wiki.bluespice.com/wiki/File:Setup:IIS_Install_06.png]]Click "Install" to start the installation:[[File:Setup:IIS_Install_07.png|center|400px|IIS Installation 07|link=https://en.wiki.bluespice.com/wiki/File:Setup:IIS_Install_07.png]]
As soon as the installation has finished, click "Close" to exit the dialog box.[[File:Setup:IIS_Install_08.png|center|400px|IIS Installation 08|link=https://en.wiki.bluespice.com/wiki/File:Setup:IIS_Install_08.png]]{{Template:Hint|text=If the installation terminates with a problem, this is usually caused by the .NET Framework 3.5 in combination with a WSUS server in your domain. The easiest solution for this is to remove the server from the domain, repeat all of the above steps, and then re-adding the server to the domain.}}

With the successful completion of all these steps, the IIS web server is now installed. Check the functionality by starting Internet Explorer on the server and calling the URL http://localhost/. If installed correctly, you will see the welcome page of the IIS Web server:[[File:Setup:IIS_Install_09.png|center|400px|IIS Installation 09|link=https://en.wiki.bluespice.com/wiki/File:Setup:IIS_Install_09.png]]
==Next step==
When you have successfully completed all the steps above, go to the next step "[[Setup:Installation Guide/System Preparation/Windows/Visual C++ Redistributable for Visual Studio 2015 |Visual C++ Redistributable for Visual Studio 2015]]".

[[de:Setup:Installationsanleitung/Systemvorbereitung/Windows/IIS-Webserver]]
[[en:{{FULLPAGENAME}}]]

Setup:Installation Guide/Installation BlueSpice WikiFarm

2021-07-21T13:05:04Z

Mmeixner:

__TOC__

An existing BlueSpice pro installation can easily be extended with BlueSpiceWikiFarm. The existing installation assumes the role of the main wiki (=farm management). The contents remain there and can be maintained as usually.

{{Box Note|boxtype=note|Note text=WikiFarm is not a standard feature of BlueSpice pro and needs to be acquired separately.}}

==PHP prerequisites==
Please ensure that the PHP extension ZIP is archived, which is required for BlueSpiceWikFarm.

==Ensuring the correct path in the file system==
Important for the operation of BlueSpiceWikiFarm is that BlueSpice is located in the directory <code>/w</code> of the DocumentRoot of your web server or VirtualHost. 

If this is not the case, you have to move the entire codebase there. 
After that, the variable <code>$wgScriptPath</code> in the <code>LocalSettings.php</code> contains the path <code>/w</code>. 
<syntaxhighlight lang="php">
$ wgScriptPath = "/w";
</syntaxhighlight>
==Creating the necessary folders for BlueSpiceWikiFarm==
BlueSpiceWikiFarm needs two additional folders in the folder <code>/w</code> at the same level as the <code>LocalSettings.php</code>. You have to create these two folders:

*<code>_sf_instances</code> - all data and configurations for the respective instances are stored here
*<code>_sf_archive</code> - deleted farm instances including your database dump are stored here as ZIP archive

Make sure that these folders are writable by the web server. See also our ([[Setup:Installation Guide/Security Settings/File System Permissions|notes in the helpdesk]] ) for this purpose.

==Creating the LocalSettingsAppend.php==
Including the extension "BlueSpiceWikiFarm" first requires an additional configuration file with the name <code>LocalSettingsAppend.php</code>. Create this file on the same level as the <code>LocalSettings.php</code> and add the following content: 

<syntaxhighlight lang="php">
<?php
require_once "$IP/LocalSettings.BlueSpice.php";
</syntaxhighlight>
==
Including the extension "BlueSpiceWikiFarm" ==
In the <code>LocalSettings.php</code> replace the line
<syntaxhighlight lang="php">
require_once "$IP/LocalSettings.BlueSpice.php";
</syntaxhighlight>
with
<syntaxhighlight lang="php">
require_once "$IP/extensions/BlueSpiceWikiFarm/BlueSpiceWikiFarm.php";
</syntaxhighlight>
==Configuring the web server==

In the folder <code>extensions/BlueSpiceWikiFarm/SimpleFarmer/doc</code> you will find example files for RewriteRules, which are necessary for BlueSpiceWikiFarm:

*<code>htaccess.template</code> - RewriteRules for Apache
*<code>web.config.template</code> - RewriteRules for IIS

Configure these RewriteRules for the DocumentRoot level of your Web server or VirtualHost.

==Completion==
The installation of BlueSpiceWikiFarm is now complete. From now on, you can reach the farm administration in the main wiki under the special page "Special:SimpleFarmer".

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

SocialEntity:6402

2021-07-21T13:05:04Z

Mmeixner:

{
"wikipageid": 4498,
"revisionid": 27207,
"namespace": 3008,
"titletext": "Installation Guide/Installation BlueSpice WikiFarm",
"action": "edit",
"summary": "(No summary)",
"parentid": 0,
"id": 6402,
"ownerid": 50,
"type": "articlesave",
"archived": false,
"tags": [],
"resolved": false
}

Setup:Installation Guide/Upgrade free to pro

2021-07-21T12:59:17Z

Mmeixner:

{{DISPLAYTITLE:Upgrade 3.x free to 3.x pro}}

To upgrade from '''BlueSpice free 3.x to BlueSpice pro 3.x''' (under Linux), follow these instructions:

#'''Create backup:''' Make a database dump and save it together with the complete codebase to another storage location.
#'''Patch-update BlueSpice free (optional):''' Check your current version on the Special: Version page. Compare your version with the current version of BlueSpice free. If you have not installed a relatively current version, apply a [[Setup:Installation Guide/Patch Update|patch update]].
#'''Replace the codebase:''' Overwrite the codebase of your current version with the new codebase of BlueSpice pro.
#'''Start the update:'''
##Open a console and switch to he installation directory (the level of LocalSettings.php)
##Execute: <code>php maintenance/update.php</code>
#'''Re-index the search:'''
##Delete search index: <code>php extensions/BlueSpiceExtendedSearch/maintenance/initbackends.php</code>
##Create new search index: <code>php extensions/BlueSpiceExtendedSearch/maintenance/rebuildIndex.php --quick</code>
##Run jobs: <code>php maintenance/runJobs.php</code>

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

SocialEntity:6401

2021-07-21T12:59:17Z

Mmeixner:

{
"wikipageid": 8689,
"revisionid": 27205,
"namespace": 3008,
"titletext": "Installation Guide/Upgrade free to pro",
"action": "edit",
"summary": "(No summary)",
"parentid": 0,
"id": 6401,
"ownerid": 50,
"type": "articlesave",
"archived": false,
"tags": [],
"resolved": false
}

Setup:Installation Guide/With Installer

2021-07-21T12:30:14Z

Mmeixner:

{{DISPLAYTITLE:Installing BlueSpice 3 with installer}}
__TOC__

==Introduction==
With BlueSpice 3, we offer the installation as a complete package with MediaWiki and BlueSpice.
This installation guide gives you step-by-step instructions to install BlueSpice.
{{Box Note|boxtype=important|Note text=If you do a fresh install of BlueSpice 3.2 it might be necessary to run update.php afterwards if you get an error.}}
{{Box Note|boxtype=note|Note text=This document only describes the steps for installing the web application itself. For the installation of extended functions such as [[Setup:Installation_Guide/Advanced/VisualEditor_Configuration|VisualEditor]] and [[Setup:Installation Guide/Advanced/ExtendedSearch Configuration|Extendedsearch]], please refer to the corresponding documentation.

We will not go into details about your operating system installation here, but assume that you have already [[Setup:Installation_Guide#Prerequesites|configured your system]] and stored the installation package in a web root of your choice, where you can access it via your browser. You can find more details in our detailed [[Setup:Installation Guide|installation guide]].

Further help on optimizing the operating system can be found in our [[Setup:Installation Guide/Advanced|compendium]].}}
==Step-by-step installation==

{{Hint
|text=If you also install the paid extension "BlueSpiceWikiFarm", make sure that the codebase is not located directly in the DocumentRoot of your web server or VirtualHost - it must be located in the /w subfolder!
}}

{| class="wikitable"
|-
|[[File:Setup:Screenshot 12.png|300x300px]]
||'''Step 1 - Start the installation setup''': First, open the URL of your web application in your browser. Then click on "set up the wiki" to start the installation.

'''Note:''' If you don't meet all necessary requirements for PHP yet, you won't be able to view this setup page yet. Please make the necessary corrections to your PHP installation first. Otherwise, you are now on the page shown in the screenshot (click on the thumbnail to see the full screenshot).

|-
|[[File:Setup:Screenshot (213) 123.png|300x300px]]
||'''Step 2 - Select your language:''' You are now in the language selection.

"Your language" defines the language that guides you through the installer,

"Wiki language" the later language settings of your wiki.
|-
|[[File:Setup:Screenshot (215)3.png|300x300px]]
||'''Step 3 - MediaWiki Installation Check:''' This step takes you to the MediaWiki installation check.

Please read this check carefully, as possible hints may not block the installation itself, but may lead to restrictions of the wiki functionality in practice.

Make the necessary corrections to your system and reload the page in your browser before proceeding with the setup.
|-
|[[File:Setup:Screenshot (218).png|300x300px]]
||'''Step 4 - Establish the database connection: '''In this step, you configure the database connection.

Here you can either specify the root user of your MySQL server and in the following step have the installer create an additional user who only has access to the BlueSpice database. The database will also be created automatically if it does not yet exist.

Or, alternatively, you can create a user and a database in advance and directly enter this information here. You can find information on the manual creation of users and databases in the [[mediawikiwiki:Manual:Installing_MediaWiki#MariaDB/MySQL|official Mediawiki documentation]].
|-
|[[File:Setup:bs3-install-05.png|300px|BlueSpice 3 Installation Step 5]]
||'''Step 5 - Create the BlueSpice database user: '''Depending on the procedure you followed in the previous step, you can now define an exclusive user for your BlueSpice database.

If you have already created the user explicitly for the database in advance, leave the check mark at "Use the same database account as during the installation process".
|-
|[[File:Setup:bs3-install-06.png|300px|BlueSpice 3 Installation Step 6]]
||'''Step 6 - Create your wiki name and administrator account: ''' Enter the name for your wiki. This name is displayed in the title bar of your browser and in various other places such as in notification mails.

Pay extra attention to the correct spelling, because this name can afterwards only be changed with a certain effort and certain risks.

Next, enter the username, password and e-mail address of the first wiki administrator. The administrator account is then created by the wiki during setup.
|-
|[[File:Setup:Screenshot (223)e.png|300x300px]]
||'''Step 7 - Options:''' In this step, you specify the e-mail address for notification e-mails.
|-
|[[File:Setup:Screenshot (220)35.png|300x300px]]
||'''Step 8 - Installation: ''' This step announces the installation of the wiki. If you don't need to make any changes to the previous steps, click "Next" to start the installation process.
|-
|[[File:Setup:Screenshot (219).png|300x300px]]
||'''Step 9 - Installation status: '''After the successful installation of BlueSpice, you see a confirmation page that you confirm with "Next".
|-
|[[File:Setup:Screenshot (224).png|300x300px]]
||'''Step 10 - Download LocalSettings.php:''' In the last step of the installation, you will be asked to download the configuration file "LocalSettings.php" of your installation. Download it and place it in the root directory of your BlueSpice codebase.
|-
|
|'''Step 11 - Rename the template folders:''' Open the folder <code>..\extensions\BluesSpiceFoundation</code> and rename the subfolder <code>config.template</code> to <code>config</code> and create the new folder <code>data</code>. These folders should have read and write access, see [[Setup:Installation Guide/Security Settings/File System Permissions|File System Permissions]].
Run the script <code>..\maintenance\update.php</code> from the console.
|-
|[[File:Setup:bs3-install-11.png|300px|BlueSpice 3 Installation Step 12]]
||'''Step 12 - Load the BlueSpice welcome page: '''If you now access the URL you specified for BlueSpice, you now see the BlueSpice welcome page. You can start using BlueSpice immediately.
|}{{Box Note|boxtype=note|Note text=If the page is not loading, give the group "users" change-permissions for the folder C:\Windows\Temp.}}{{Box Note|boxtype=important|Note text=As next step, you can configure [[Setup:Installation Guide/Advanced/VisualEditor Configuration|VisualEditor]] and [[Setup:Installation Guide/Advanced/ExtendedSearch Configuration|Extendedsearch]].}}
[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung/Installation von BlueSpice]]

SocialEntity:6400

2021-07-21T12:30:14Z

Mmeixner:

{
"wikipageid": 833,
"revisionid": 27203,
"namespace": 3008,
"titletext": "Installation Guide/With Installer",
"action": "edit",
"summary": "(No summary)",
"parentid": 0,
"id": 6400,
"ownerid": 50,
"type": "articlesave",
"archived": false,
"tags": [],
"resolved": false
}

File:Setup:Screenshot (223)e.png

2021-07-21T12:30:02Z

Mmeixner:

File:Setup:Screenshot (220)35.png

2021-07-21T12:29:20Z

Mmeixner:

File:Setup:Screenshot (224).png

2021-07-21T12:28:54Z

Mmeixner:

File:Setup:Screenshot (219).png

2021-07-21T12:28:36Z

Mmeixner:

File:Setup:Screenshot (218).png

2021-07-21T12:27:00Z

Mmeixner:

File:Setup:Screenshot (215)3.png

2021-07-21T12:26:26Z

Mmeixner:

File:Setup:Screenshot (213) 123.png

2021-07-21T12:26:02Z

Mmeixner:

File:Setup:Screenshot 12.png

2021-07-21T12:25:04Z

Mmeixner:

SocialEntity:6399

2021-07-21T12:22:58Z

Mmeixner:

{
"social-profile-title": null,
"social-profile-name": null,
"social-profile-email": null,
"social-profile-department": "",
"social-profile-function": "",
"social-profile-location": "",
"social-profile-phone": "",
"description": "",
"parentid": 0,
"id": 6399,
"ownerid": 50,
"type": "profile",
"archived": false,
"tags": [
"User:Mmeixner"
],
"resolved": false
}

Setup:Installation Guide/With Installer

2021-07-19T09:24:29Z

Mmeixner: Important

{{DISPLAYTITLE:Installing BlueSpice 3 with installer}}
__TOC__

==Introduction==
With BlueSpice 3, we offer the installation as a complete package with MediaWiki and BlueSpice.
This installation guide gives you step-by-step instructions to install BlueSpice.
{{Box Note|boxtype=important|Note text=If you do a fresh install of BlueSpice 3.2 it might be necessary to run update.php afterwards if you get an error.}}
{{Box Note|boxtype=note|Note text=This document only describes the steps for installing the web application itself. For the installation of extended functions such as [[Setup:Installation_Guide/Advanced/VisualEditor_Configuration|VisualEditor]] and [[Setup:Installation Guide/Advanced/ExtendedSearch Configuration|Extendedsearch]], please refer to the corresponding documentation.

We will not go into details about your operating system installation here, but assume that you have already [[Setup:Installation_Guide#Prerequesites|configured your system]] and stored the installation package in a web root of your choice, where you can access it via your browser. You can find more details in our detailed [[Setup:Installation Guide|installation guide]].

Further help on optimizing the operating system can be found in our [[Setup:Installation Guide/Advanced|compendium]].}}
==Step-by-step installation==

{{Hint
|text=If you also install the paid extension "BlueSpiceWikiFarm", make sure that the codebase is not located directly in the DocumentRoot of your web server or VirtualHost - it must be located in the /w subfolder!
}}

{| class="wikitable"
|-
|[[File:bs3-install-01.png|300px|BlueSpice 3 Installation Step 1]]
||'''Step 1 - Start the installation setup''': First, open the URL of your web application in your browser. Then click on "set up the wiki" to start the installation.

'''Note:''' If you don't meet all necessary requirements for PHP yet, you won't be able to view this setup page yet. Please make the necessary corrections to your PHP installation first. Otherwise, you are now on the page shown in the screenshot (click on the thumbnail to see the full screenshot).

|-
|[[File:Setup:bs3-install-02.png|300px|BlueSpice 3 Installation Step 2]]
||'''Step 2 - Select your language:''' You are now in the language selection.

"Your language" defines the language that guides you through the installer,

"Wiki language" the later language settings of your wiki.
|-
|[[File:Setup:bs3-install-03.png|300px|BlueSpice 3 Installation Step 3]]
||'''Step 3 - MediaWiki Installation Check:''' This step takes you to the MediaWiki installation check.

Please read this check carefully, as possible hints may not block the installation itself, but may lead to restrictions of the wiki functionality in practice.

Make the necessary corrections to your system and reload the page in your browser before proceeding with the setup.
|-
|[[File:bs3-install-04.png|300px|BlueSpice 3 Installation Step 4]]
||'''Step 4 - Establish the database connection: '''In this step, you configure the database connection.

Here you can either specify the root user of your MySQL server and in the following step have the installer create an additional user who only has access to the BlueSpice database. The database will also be created automatically if it does not yet exist.

Or, alternatively, you can create a user and a database in advance and directly enter this information here. You can find information on the manual creation of users and databases in the [[mediawikiwiki:Manual:Installing_MediaWiki#MariaDB/MySQL|official Mediawiki documentation]].
|-
|[[File:Setup:bs3-install-05.png|300px|BlueSpice 3 Installation Step 5]]
||'''Step 5 - Create the BlueSpice database user: '''Depending on the procedure you followed in the previous step, you can now define an exclusive user for your BlueSpice database.

If you have already created the user explicitly for the database in advance, leave the check mark at "Use the same database account as during the installation process".
|-
|[[File:Setup:bs3-install-06.png|300px|BlueSpice 3 Installation Step 6]]
||'''Step 6 - Create your wiki name and administrator account: ''' Enter the name for your wiki. This name is displayed in the title bar of your browser and in various other places such as in notification mails.

Pay extra attention to the correct spelling, because this name can afterwards only be changed with a certain effort and certain risks.

Next, enter the username, password and e-mail address of the first wiki administrator. The administrator account is then created by the wiki during setup.
|-
|[[File:Setup:bs3-install-07.png|300px|BlueSpice 3 Installation Step 7]]
||'''Step 7 - Options:''' In this step, you specify the e-mail address for notification e-mails.
|-
|[[File:Setup:bs3-install-08.png|300px|BlueSpice 3 Installation Step 8]]
||'''Step 8 - Installation: ''' This step announces the installation of the wiki. If you don't need to make any changes to the previous steps, click "Next" to start the installation process.
|-
|[[File:Setup:bs3-install-09.png|300px|BlueSpice 3 Installation Step 9]]
||'''Step 9 - Installation status: '''After the successful installation of BlueSpice, you see a confirmation page that you confirm with "Next".
|-
|[[File:Setup:bs3-install-10.png|300px|BlueSpice 3 Installation Step 10]]
||'''Step 10 - Download LocalSettings.php:''' In the last step of the installation, you will be asked to download the configuration file "LocalSettings.php" of your installation. Download it and place it in the root directory of your BlueSpice codebase.
|-
|
|'''Step 11 - Rename the template folders:''' Open the folder <code>..\extensions\BluesSpiceFoundation</code> and rename the subfolder <code>config.template</code> to <code>config</code> and create the new folder <code>data</code>. These folders should have read and write access, see [[Setup:Installation Guide/Security Settings/File System Permissions|File System Permissions]].
Run the script <code>..\maintenance\update.php</code> from the console.
|-
|[[File:Setup:bs3-install-11.png|300px|BlueSpice 3 Installation Step 12]]
||'''Step 12 - Load the BlueSpice welcome page: '''If you now access the URL you specified for BlueSpice, you now see the BlueSpice welcome page. You can start using BlueSpice immediately.
|}

{{Box Note|boxtype=important|Note text=As next step, you can configure [[Setup:Installation Guide/Advanced/VisualEditor Configuration|VisualEditor]] and [[Setup:Installation Guide/Advanced/ExtendedSearch Configuration|Extendedsearch]].}}{{Box Note|boxtype=important|Note text=If the page is just loading change in the Path C:\Windows\Temp the Rights at users to "change".}}
[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung/Installation von BlueSpice]]

SocialEntity:6317

2021-07-19T09:24:29Z

Mmeixner:

{
"wikipageid": 833,
"revisionid": 27055,
"namespace": 3008,
"titletext": "Installation Guide/With Installer",
"action": "edit",
"summary": "Important",
"parentid": 0,
"id": 6317,
"ownerid": 50,
"type": "articlesave",
"archived": false,
"tags": [],
"resolved": false
}

SocialEntity:6315

2021-07-19T09:22:44Z

Mmeixner:

{
"social-profile-title": null,
"social-profile-name": null,
"social-profile-email": null,
"social-profile-department": "",
"social-profile-function": "",
"social-profile-location": "",
"social-profile-phone": "",
"description": "",
"parentid": 0,
"id": 6315,
"ownerid": 50,
"type": "profile",
"archived": false,
"tags": [
"User:Mmeixner"
],
"resolved": false
}

SocialEntity:6314

2021-07-19T09:22:30Z

Mmeixner:

{
"social-profile-title": null,
"social-profile-name": null,
"social-profile-email": null,
"social-profile-department": "",
"social-profile-function": "",
"social-profile-location": "",
"social-profile-phone": "",
"description": "",
"parentid": 0,
"id": 6314,
"ownerid": 50,
"type": "profile",
"archived": false,
"tags": [
"User:Mmeixner"
],
"resolved": false
}

Setup:Installation Guide/System Preparation/Windows/Python

2021-07-12T13:21:34Z

Mmeixner:

{{DISPLAYTITLE:Installing Python on Windows}}
__TOC__

{{Template:Important|text=Python with the extension Pygmentize is needed for the rendering of the MediaWiki extension "SyntaxHighlight", which is part of BlueSpice. The steps listed here are required.}}
==Downloading Python==
In Internet Explorer, open the [https://www.python.org/downloads/ official download page] (1). Switch to the download page for Windows (2).

[[File:Setup:bs3-download-windows-python-01.png|center|400px|Python Download 01]]

Select the "executable installer" (64-bit):

[[File:Setup:bs3-download-windows-python-02.png|center|400px|Python Download 02]]

Follow the further download instructions and download the installation package to your hard drive.

{{Template:Hint|text=Please note that the download on your Windows Server with Internet Explorer will only work if you have configured the Internet Explorer Advanced Security Settings in the Server Manager. Please refer to the technical documentation from Microsoft.}}
{{Template:Hint|text=In this guide, Python is used in version 3.7.4 as an example. You can download the latest version at the time of installation.}}
==Installing Python==
Open the just-downloaded python-3.7.4-amd64.exe file.

Start the installation by clicking "Next".

Confirm both checkboxes (1) and then click "Customize installation" (2):
[[File:Setup:bs3-install-windows-python-01.png|400px]]

Confirm the next step with "Next":

[[File:Setup:bs3-install-windows-python-02.png|400px]]

Make sure to install Python for all users (1) . Choose an appropriate path, if possible without spaces and special characters (2), and start the installation by clicking "Install" (3).

[[File:Setup:Python Fehler.png|400x400px]]

{{Template:Hint|text=This documentation is based on the folder structure [[Setup:Installation Guide/Advanced/Windows_Folder _Structure | recommended by us]]. For this reason, the default path for Python installation is set to the folder C:\bluespice\bin\python-3.7.4. If you have different requirements, you must adapt these paths accordingly.}}

After installation, please disable the limitation of the path length (260 characters).

[[File:Setup:bs3-install-windows-python-04.png|400px]]

Finish the installation by clicking "Close":

[[File:Setup:bs3-install-windows-python-05.png|400px]]

==Installing Pygmentize==
Open the command prompt with admin permissions. To do this, right-click "Start" (1) and select "Command Prompt (Administrator)" (2):
[[File:Setup:Nodejs_InstallWindowsBuildTools_01.png|center|200px|Open command prompt as administrator]]

Enter the command "''pip install pygments''" and wait for the process to finish:

[[File:Setup:bs3-install-windows-python-06.png|405x405px]]

==Next step==
If you have completed all steps successfully, you can delete the previously downloaded file "python-3.7.4-amd64.exe" from your hard drive. If you install BlueSpice pro, go to the next step "[[Setup:Installation Guide/System Preparation/Windows/PhantomJS |PhantomJS]]". If you install BlueSpice free, you can now continue with [[Setup:Installation Guide/With Installer | Installing BlueSpice]].

[[en:{{FULLPAGENAME}}]]
[[de:Setup:Installationsanleitung/Systemvorbereitung/Windows/Python]]

SocialEntity:6293

2021-07-12T13:21:34Z

Mmeixner:

{
"wikipageid": 4425,
"revisionid": 27008,
"namespace": 3008,
"titletext": "Installation Guide/System Preparation/Windows/Python",
"action": "edit",
"summary": "(No summary)",
"parentid": 0,
"id": 6293,
"ownerid": 50,
"type": "articlesave",
"archived": false,
"tags": [],
"resolved": false
}

File:Setup:Python Fehler.png

2021-07-12T13:21:27Z

Mmeixner:

SocialEntity:6292

2021-07-12T13:21:00Z

Mmeixner:

{
"social-profile-title": null,
"social-profile-name": null,
"social-profile-email": null,
"social-profile-department": "",
"social-profile-function": "",
"social-profile-location": "",
"social-profile-phone": "",
"description": "",
"parentid": 0,
"id": 6292,
"ownerid": 50,
"type": "profile",
"archived": false,
"tags": [
"User:Mmeixner"
],
"resolved": false
}

SocialEntity:6291

2021-07-12T13:20:52Z

Mmeixner:

{
"social-profile-title": null,
"social-profile-name": null,
"social-profile-email": null,
"social-profile-department": "",
"social-profile-function": "",
"social-profile-location": "",
"social-profile-phone": "",
"description": "",
"parentid": 0,
"id": 6291,
"ownerid": 50,
"type": "profile",
"archived": false,
"tags": [
"User:Mmeixner"
],
"resolved": false
}

SocialEntity:6288

2021-07-08T11:49:11Z

Mmeixner:

{
"social-profile-title": null,
"social-profile-name": null,
"social-profile-email": null,
"social-profile-department": "",
"social-profile-function": "",
"social-profile-location": "",
"social-profile-phone": "",
"description": "",
"parentid": 0,
"id": 6288,
"ownerid": 50,
"type": "profile",
"archived": false,
"tags": [
"User:Mmeixner"
],
"resolved": false
}

SocialEntity:6287

2021-07-08T11:33:06Z

Mmeixner:

{
"social-profile-title": null,
"social-profile-name": null,
"social-profile-email": null,
"social-profile-department": "",
"social-profile-function": "",
"social-profile-location": "",
"social-profile-phone": "",
"description": "",
"parentid": 0,
"id": 6287,
"ownerid": 50,
"type": "profile",
"archived": false,
"tags": [
"User:Mmeixner"
],
"resolved": false
}

File:Setup:Screenshot (223).png

2021-07-08T06:50:14Z

Mmeixner:

File:Setup:Screenshot (221).png

2021-07-08T06:49:45Z

Mmeixner:

File:Setup:Screenshot (220).png

2021-07-08T06:49:28Z

Mmeixner:

File:Setup:Screenshot (217).png

2021-07-08T06:48:03Z

Mmeixner:

File:Setup:Screenshot (215).png

2021-07-08T06:46:54Z

Mmeixner:

File:Setup:Screenshot (213).png

2021-07-08T06:45:57Z

Mmeixner:

File:Setup:Screenshot (227).png

2021-07-08T06:45:20Z

Mmeixner:

SocialEntity:6286

2021-07-08T06:33:06Z

Mmeixner:

{
"social-profile-title": null,
"social-profile-name": null,
"social-profile-email": null,
"social-profile-department": "",
"social-profile-function": "",
"social-profile-location": "",
"social-profile-phone": "",
"description": "",
"parentid": 0,
"id": 6286,
"ownerid": 50,
"type": "profile",
"archived": false,
"tags": [
"User:Mmeixner"
],
"resolved": false
}

User:Mmeixner

2021-07-08T06:32:49Z

Mmeixner: create user page