Kringen En MediaWiki Slecht Plan: Difference between revisions

From ULYSSIS documentation
(Layout dingen)
Line 2: Line 2:


== Prerequisites==
== Prerequisites==
This tutorial assumes that you have [https://cyberduck.io/ Cyberduck] installed. A guide on how to install and use Cyberduck can be found on [[Accessing your files]]. You will also have to download the [https://www.mediawiki.org/wiki/Download MediaWiki installation files]. We reccomend using the latest version or the long-term support (LTS) version.
This tutorial assumes that you have [https://cyberduck.io/ Cyberduck] installed. A guide on how to install and use Cyberduck can be found on [[Accessing your files]]. You will also have to download the [https://www.mediawiki.org/wiki/Download MediaWiki installation files]. We reccomend using either the latest version or the long-term support (LTS) version.


== Installation ==
== Installation ==
Line 16: Line 16:
If the upload has completed, you should get a window which looks like this:
If the upload has completed, you should get a window which looks like this:
[[File:WaitUntilComplete.png|left|thumb|Wait until the upload is complete]]
[[File:WaitUntilComplete.png|left|thumb|Wait until the upload is complete]]
Unzip your zipper
In the main Cyberduck window, you should be able to see the MediaWiki file you just uploaded. To unzip this file, just right click it and choose 'expand  archive'. 
[[File:RightClick ExpandArchive.png|left|thumb|405x405px|Right click on the zip and choose expand archive]]
[[File:RightClick ExpandArchive.png|left|thumb|405x405px|Right click on the zip and choose expand archive]]
The progress on the bottom part of the window
This process might take a while, you can verify the progress by looking at the bottom part of the Cyberduck window.
[[File:ProgressBottomWindow.png|left|thumb|411x411px|The progress can be found on the bottom of the window]]
[[File:ProgressBottomWindow.png|left|thumb|411x411px|The progress can be found on the bottom of the window]]
Select everything in the MediaWiki folder and move it outside of the folder by dragging your mouse
Select everything in the new MediaWiki folder and move it outside of the folder.
[[File:SelectEverything.png|left|thumb|379x379px|Select everything in the MediaWiki folder]]
[[File:SelectEverything.png|left|thumb|379x379px|Select everything in the MediaWiki folder]]
Delete the zip file and the original folder by right clicking and choosing delete
Delete the zip file and the original folder by right clicking and choosing delete
[[File:DeleteOGfiles.png|left|thumb|Delete the zip file and the original folder]]
[[File:DeleteOGfiles.png|left|thumb|Delete the zip file and the original folder]]
Now we'll go to UCC and choose your mysql crap (create account if you do not have one [[Using MySQL]])
Now we'll go to UCC and create a database for our mediawiki installation. (if this is your first time making a database, we reccomend our documentation on [[Using MySQL]])
[[File:GoToUCC.png|left|thumb|Go to UCC]]
[[File:GoToUCC.png|left|thumb|Go to UCC|560x560px]]
Create arnodb
Choose the 'Add database' option just below your username. This should bring you to a page which looks like this. We reccomend naming your database 'wiki'.
[[File:CreateDB.png|left|thumb|Create a new MySQL database]]
[[File:CreateDB.png|left|thumb|Create a new MySQL database|568x568px]]
Go to your new wiki page at username.ulyssis.be
You are now ready to configure your new wiki at username.ulyssis.be . To start, click on the 'set up the wiki' hyperlink.
[[File:GoToWiki.png|left|thumb|412x412px|Go to your wiki at username.ulyssis.be]]Set you language
[[File:GoToWiki.png|left|thumb|578x578px|Go to your wiki at username.ulyssis.be]]You will be prompted to set your prefered language.
[[File:SetLanguage.png|left|thumb|407x407px|Set your language ]]
[[File:SetLanguage.png|left|thumb|585x585px|Set your language ]]
This is the installation page
This is where the real installation begins. We can just click 'continue'.
[[File:InstallPage.png|left|thumb|401x401px|This is the beginning of the installation ]]
[[File:InstallPage.png|left|thumb|588x588px|This is the beginning of the installation ]]
Configure arnodb
We will first configure the database we just created. This is specific to your personal configuration, an example has been given below.
[[File:ConfigureDB.png|left|thumb|423x423px|Configure the database in MediaWiki]]
[[File:ConfigureDB.png|left|thumb|592x592px|Configure the database in MediaWiki]]
Configure wikidb settings
Once the database has been configured, you can just click 'continue'. On the following page, make sure the checkbox is checked and click 'continue' again.
[[File:DBSettings.png|left|thumb|449x449px|Database settings in MediaWiki]]
[[File:DBSettings.png|left|thumb|600x600px|Database settings in MediaWiki]]
Configure wiki settings (making the OG admin)
We now get promted to choose a wiki name (you can choose this to be whatever you want), we also have to make the administrator account.
[[File:WikiSettings.png|left|thumb|458x458px|Configure the final MediaWiki settings]]
[[File:WikiSettings.png|left|thumb|601x601px|Configure the final MediaWiki settings]]
The install page
Once everything has been created, you should land on the following page. You don't have to configure anything on this page.
[[File:InstalationPage.png|left|thumb|471x471px|This is the final install page]]
[[File:InstalationPage.png|left|thumb|596x596px|This is the final install page]]
Download LocalSettings.php
When the MediaWiki installation has been confirmed, you will have to download the 'LocalSettings.php' file. This file contains the essential settings for your MediaWiki instance to work properly.
[[File:DownloadLocalSettings.png|left|thumb|480x480px|Download LocalSettings.php]]
[[File:DownloadLocalSettings.png|left|thumb|607x607px|Download LocalSettings.php]]
Upload LocalSettings.php (via Cyberduck again)
Upload LocalSettings.php via cyberduck to the same folder where you placed the MediaWiki files.
[[File:UploadLocalSettings.png|left|thumb|Upload LocalSettings.php]]
[[File:UploadLocalSettings.png|left|thumb|Upload LocalSettings.php]]
Open new tab and go to username.ulyssis.be
You can now open a new tab, and go to username.ulyssis.be . You should be able to see your new wiki.
[[File:OpenNewTab.png|left|thumb|486x486px|Open a new tab and go to username.ulyssis.be]]
[[File:OpenNewTab.png|left|thumb|486x486px|Open a new tab and go to username.ulyssis.be]]
Tadaaa
For further support, we recccomend the [https://www.mediawiki.org/wiki/Manual:Installation_guide official MediaWiki documentation.]

Revision as of 08:59, 6 April 2022

This page will go through a basic setup of MediaWiki. It is based on the official MediaWiki installation wikipage, and it gives a few specifics for setting it up on a hosted account over at ULYSSIS.

Prerequisites

This tutorial assumes that you have Cyberduck installed. A guide on how to install and use Cyberduck can be found on Accessing your files. You will also have to download the MediaWiki installation files. We reccomend using either the latest version or the long-term support (LTS) version.

Installation

As mentioned in the Prerequisites, we'll use Cyberduck for the installation of MediaWiki. Make sure you are logged in to you ULYSSIS account, and that you see the following screen.

Open Cyberduck

In this tutorial, we will install our MediaWiki in the www folder. We can do this by double clicking the folder.

Go to the WWW folder

We are now ready to upload the necessary files for the MediaWiki installation. This can be done by clicking the 'Upload' button at the top of the Cyberduck window. A popup should appear on your screen.

Click on the upload button

Navigate to the folder in which the installation files are stored. Select them and click on 'Choose' on the bottom right of the popup.

Select the MediaWiki zip

The upload process wil now start automatically. It is possible that you get another popup, be sure to click 'Allow'. Otherwise, the files will not be uploaded.

Click allow

If the upload has completed, you should get a window which looks like this:

Wait until the upload is complete

In the main Cyberduck window, you should be able to see the MediaWiki file you just uploaded. To unzip this file, just right click it and choose 'expand archive'.

Right click on the zip and choose expand archive

This process might take a while, you can verify the progress by looking at the bottom part of the Cyberduck window.

The progress can be found on the bottom of the window

Select everything in the new MediaWiki folder and move it outside of the folder.

Select everything in the MediaWiki folder

Delete the zip file and the original folder by right clicking and choosing delete

Delete the zip file and the original folder

Now we'll go to UCC and create a database for our mediawiki installation. (if this is your first time making a database, we reccomend our documentation on Using MySQL)

Go to UCC

Choose the 'Add database' option just below your username. This should bring you to a page which looks like this. We reccomend naming your database 'wiki'.

Create a new MySQL database

You are now ready to configure your new wiki at username.ulyssis.be . To start, click on the 'set up the wiki' hyperlink.

Go to your wiki at username.ulyssis.be

You will be prompted to set your prefered language.

Set your language

This is where the real installation begins. We can just click 'continue'.

This is the beginning of the installation

We will first configure the database we just created. This is specific to your personal configuration, an example has been given below.

Configure the database in MediaWiki

Once the database has been configured, you can just click 'continue'. On the following page, make sure the checkbox is checked and click 'continue' again.

Database settings in MediaWiki

We now get promted to choose a wiki name (you can choose this to be whatever you want), we also have to make the administrator account.

Configure the final MediaWiki settings

Once everything has been created, you should land on the following page. You don't have to configure anything on this page.

This is the final install page

When the MediaWiki installation has been confirmed, you will have to download the 'LocalSettings.php' file. This file contains the essential settings for your MediaWiki instance to work properly.

Download LocalSettings.php

Upload LocalSettings.php via cyberduck to the same folder where you placed the MediaWiki files.

Upload LocalSettings.php

You can now open a new tab, and go to username.ulyssis.be . You should be able to see your new wiki.

Open a new tab and go to username.ulyssis.be

For further support, we recccomend the official MediaWiki documentation.