User Tools
Writing /app/www/public/data/meta/databaseandnetworkmanagement/wiki_installation.meta failed
databaseandnetworkmanagement:wiki_installation
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| databaseandnetworkmanagement:wiki_installation [2018/12/20 12:15] – poneill | databaseandnetworkmanagement:wiki_installation [2023/05/16 10:33] (current) – wflaherty | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | ====== Wiki Installation ====== | ||
| + | |||
| + | NEW WIKI | ||
| + | See wiki repo on bitbucket. | ||
| + | https:// | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | Author: Padraig O Neill based on [[https:// | ||
| + | ===== Introduction ===== | ||
| + | |||
| + | This page was created to provide document details of the current dokuwiki installation. | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ===== Location ===== | ||
| + | |||
| + | Access Information | ||
| + | * IP: 10.91.100.71 (scotty@blade2) | ||
| + | * URL: wiki.err | ||
| + | * Administrative account: scotty | ||
| + | * Administrative account password: o******s | ||
| + | |||
| + | Each user requiring an account on the WIKI is responsible for creating such an account using the administrative account provided. | ||
| + | |||
| + | ===== Installation Information ===== | ||
| + | * Apache HTTP Server web directory: / | ||
| + | * Watchdog: / | ||
| + | * Hourly GIT push BASH script: / | ||
| + | |||
| + | ===== Installation Instructions ===== | ||
| + | Installation Instruction | ||
| + | * Connect to the required server via SSH (e.g. ssh scotty@10.91.100.71) | ||
| + | * Install PHP (e.g. sudo yum install php) | ||
| + | * Install Apache HTTP Server (e.g. sudo yum install httpd) | ||
| + | * Download the latest DokuWiki - http:// | ||
| + | * Decompress the downloaded archive. | ||
| + | * Move the contents of the unpacked “dokuwiki” folder to the Apache’s web directory | ||
| + | * Via browser, access the “installer.php” file | ||
| + | * If present, fix the accessibility issues by giving the required permissions to the relevant directories (the instructions will be provided by the installation PHP script) | ||
| + | * Follow the installation instructions | ||
| + | * Set the required permissions on the " | ||
| + | * Create the “.htaccess” file in the web directory | ||
| + | * Add the “RewriteRule ^(data|conf|bin|inc) - [F,L,NC]” rule to the newly created “.htaccess” file | ||
| + | * If any media upload issues persist, check that the chmod permissions allow the modification of the media folder (“data/ | ||
| + | |||
| + | |||
| + | ===== Upgrade Instructions ===== | ||
| + | * Make a backup of the current DokuWiki installation | ||
| + | * Download the latest DokuWiki version - http:// | ||
| + | * Decompress the downloaded archive | ||
| + | * Copy the contents of the newly downloaded DokuWiki version into the currently used DokuWiki installation, | ||
| + | * Set the required permissions on the " | ||
| + | |||
| + | ===== Daily GIT Push Setup Instruction ===== | ||
| + | * Create the GIT push BASH script (refer to the “Code - Daily GIT Push BASH Script” section for the code) | ||
| + | * Add the new CRON job (sudo crontab -e) (refer to the “Code - CRON Task” section for the code) | ||
| + | * Install Watchdog - https:// | ||
| + | * Configure Watchdog (refer to the “Code - Watchdog” section) | ||
| + | |||
| + | ===== Code ===== | ||
| + | CRON Task | ||
| + | # Backup internal wiki | ||
| + | 0 * * * * / | ||
| + | Daily GIT Push BASH Script | ||
| + | #!/bin/bash | ||
| + | eval `ssh-agent` | ||
| + | ssh-add / | ||
| + | cd / | ||
| + | / | ||
| + | / | ||
| + | / | ||
| + | if [ $? = 0 ]; then | ||
| + | echo Everything was successful | ||
| + | else | ||
| + | echo Everything failed | ||
| + | fi | ||
| + | # echo " | ||
| + | |||
| + | ===== Watchdog ===== | ||
| + | ' | ||
| + | type = ' | ||
| + | thresholds | ||
| + | { a = [name: ' | ||
| + | parameters | ||
| + | { logFileLocation = '/ | ||
| + | } | ||
| + | |||
| + | Also, do add "w = ' | ||
| + | |||
| + | ===== Troubleshooting ===== | ||
| + | If the Backup process is failing confirm the following. | ||
| + | * Has the backup script been disabled in crontab | ||
| + | * What is the latest date/time of the hourly_commit.out file. | ||
| + | * Check SSH connectivity to bitbucket https:// | ||
| + | * Check connectivity to bitbucket using git ls-remote | ||
| + | |||
| + | ===== Dokuwiki JS ===== | ||
| + | * The code is included in the " | ||
| + | * The " | ||
| + | * The " | ||
| + | |||
| + | ===== Plugins Installation ===== | ||
| + | * In order to install new plugins, access the " | ||
| + | * Then unzip the file. | ||
| + | * The new plugin will be ready to use. | ||
| + | * Alternatively, | ||
| + | * However, the server has to be configured to allow the DokuWiki installation to contact its plugin repository. | ||
| + | |||
| + | ===== CSS Styling ===== | ||
| + | * In order to change the CSS styling, one can create a " | ||
| + | * However, there is a bug which will not activate the CSS changes until the administrator or another user with the appropriate permissions updates the " | ||
| + | * In order to resolve this bug, make the required CSS changes, access the " | ||
| + | |||
| + | ===== DokuWiki User Manual ===== | ||
| + | Using Sidebar | ||
| + | * In order to show the sidebar, hover your mouse over the left side of the page. The cursor will change to the dropdown list. When the cursor is in such state, click the left mouse button. | ||
| + | * The sidebar will appear. | ||
| + | * Hiding the sidebar is done in the same manner. | ||
| + | Creating Namespaces | ||
| + | * Log in. | ||
| + | * Type in the name of the namespace into the search box (e.g. “bob:”, where semicolon identifies the namespace). Alternatively, | ||
| + | * Click the pencil plus icon (located in the toolbar on the right side of the screen) in order to create the required page. | ||
| + | * The namespace will be created automatically. | ||
| + | |||
| + | ===== Updating Sidebar Navigation ===== | ||
| + | * The required information is available here [https:// | ||
| + | * The page containing the sidebar structure is called “navigation” (can be accessed via the search box or here [[http:// | ||
| + | |||
| + | ===== Miscellaneous ===== | ||
| + | * Bitbucket SSH keys setup - https:// | ||
| + | * SSH keys generation guide - https:// | ||
| + | * CRON jobs tutorial - http:// | ||
| + | * DokuWiki upgrade guide - https:// | ||
| + | * New logo upload - http:// | ||
| + | * “Navi” plugin (used for the sidebar implementation) - https:// | ||
| + | * Code highlighter (can be very useful for writing documentation) - http:// | ||
| + | |||
| + | ===== Useful Links ===== | ||
| + | * https:// | ||
| + | * https:// | ||
| + | * https:// | ||
| + | * https:// | ||
| + | |||
| + | |||
| + | ===== Changing WIKI Page Width ===== | ||
| + | * Login as administrator | ||
| + | * Click the " | ||
| + | * Select " | ||
| + | * Change the "The width of the full site (can be any length unit: %, px, em, ...)" value to the required one | ||
| + | * Click the "Save Changes" | ||
| + | |||
| + | |||
| + | ===== Table of Contents Configuration ===== | ||
| + | In order to set up the required configuration parameters allowing to show the TOC, one should access the configuration file (" | ||
| + | * $conf[' | ||
| + | * $conf[' | ||
| + | * $conf[' | ||
| + | |||
Page Tools
