|
|
|
|
公众号矩阵

如何使用DokuWiki将软硬件记入文档?

您是否在寻找一个地方来存放您的说明文档、核对清单以及员工的其他信息?本文介绍了如何安装很适合这项任务的工具DokuWiki。

作者:布加迪编译来源:51CTO|2021-01-14 08:00

【51CTO.com快译】您的内部数据中心(或基于云的数据中心)很复杂,可能在运行许多标准服务,比如Web服务器、HRM工具、备份服务器、数据共享和SaaS工具等,或者您可能有一个大量应用程序和服务在运行的集群。

由于您在任何时候运行的软硬件数量众多,可能要将如何部署、配置和使用软硬件记入文档。您可能需要为员工、管理员和开发人员提供无数的核对清单和策略,那该如何是好?您可以使用简单的Wiki服务器。开源的DokuWiki就是这样一种平台,它包含以下功能:

  • 易于使用的界面和语法
  • HTML嵌入
  • 无限的页面修订
  • 支持标有颜色的并排差异
  • 图片上传/嵌入
  • 可定制的Wiki间链接
  • 栏目编辑
  • 目录自动生成
  • 文件锁定
  • 可定制的布局(通过模板)
  • 支持LDEP、MySQL和Postgres

下面逐步介绍在Ubuntu Server 20.04上部署DokuWiki的过程。

您需要什么?

  • 运行中且经过更新的Ubuntu Server 20.04实例
  • 拥有sudo特权的用户

如何安装Apache和PHP?

我们要做的第一件事是安装Apache Web服务器和必要的PHP组件。登录到您的Ubuntu服务器,使用以下命令安装Apache:

  1. sudo apt-get install apache2 -y 

现在,我们可以使用以下命令安装必要的PHP组件:

  1. sudo apt-get install php php-gd php-xml php-json -y 

完成这些安装后,使用以下命令启动并启用Apache:

  1. sudo systemctl enable --now apache2 

如何下载、解压缩和移动DokuWiki?

为了安装DokuWiki,我们需要下载、解压缩,并将其移到Apache文档根目录。

使用以下命令下载最新版本的DokuWiki:

  1. wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz 

使用以下命令解压缩经过压缩的tar文件:

  1. tar xvzf dokuwiki-stable.tgz 

使用以下命令移动并重命名刚创建的目录:

  1. sudo mv dokuwiki-XXX / var / www / html / dokuwiki 

其中XXX是版本号。

使用以下命令拷贝示例.htaccess文件:

  1. sudo cp /var/www/html/dokuwiki/.htaccess{.dist,} 

使用以下命令更改DokuWiki文件夹的所有权:

  1. sudo chown -R www-data:www-data /var/www/html/dokuwiki 

如何配置Apache?

眼下,Apache无法知道新安装的组件。为了让它知道,我需要为DokuWiki创建一个配置文件。使用以下命令创建新文件:

  1. sudo nano /etc/apache2/sites-available/dokuwiki.conf 

在该文件中,粘贴以下内容:

  1. <VirtualHost *:80> 
  2.         ServerName    dokuwiki.example.com       
  3.         DocumentRoot  /var/www/html/dokuwiki 
  4.         <Directory ~ "/var/www/html/dokuwiki/(bin/|conf/|data/|inc/)"
  5.             <IfModule mod_authz_core.c> 
  6.                 AllowOverride All 
  7.                 Require all denied 
  8.             </IfModule> 
  9.             <IfModule !mod_authz_core.c> 
  10.                 Order allow,deny 
  11.                 Deny from all 
  12.             </IfModule> 
  13.         </Directory> 
  14.         ErrorLog   /var/log/apache2/dokuwiki_error.log 
  15.         CustomLog  /var/log/apache2/dokuwiki_access.log combined 
  16. </VirtualHost> 

如果您要使用域,确保更改您在上面看到的ServerName选项。

保存并关闭文件。

使用以下命令启用新网站:

  1. sudo a2ensite dokuwiki 

使用以下命令重新加载Apache配置文件:

  1. sudo systemctl reload apache2 

如何完成安装?

打开Web浏览器,导航到http://SERVER/install.php(其中Server是您托管服务器的域名的IP地址)。您应该会看到基于Web的DokuWiki安装程序(见图A)。

图A. DokuWiki基于Web的安装程序准备完成安装

填写必要的信息,点击“保存”。安装应立即完成,会显示一个链接指向DokuWiki主页,即http://SERVER/doku.php?id=wiki:welcome(其中Server是主机托管服务器的域名的IP地址)(见图B)。

图B. DokuWiki基于web的安装程序准备完成安装

就是这样。现在您已准备好开始搭建一个Wiki网站,以便将您的硬件、软件、容器及更多内容记入文档。这个好方法便于让您的开发人员和管理员了解部署环境的情况。您甚至可以使用该工具为管理员和开发者存放核对清单之类的内容。务必确保该Wiki避免被窥视,千万不要使用这类工具作为任何一种密码管理器。密码始终要放在正规的密码管理器中。DokuWiki(及类似工具)适合于记入文档,而不是很适合确保机密信息安全。

原文标题:How to document your software and hardware with DokuWiki,作者:Jack Wallen

【51CTO译稿,合作站点转载请注明原文译者和出处为51CTO.com】

【编辑推荐】

  1. 联想数据中心业务集团推出全新数据管理解决方案
  2. EXCEL+VBA管理filezilla FTP文件服务器用户 用户组 目录权限教程
  3. 高并发场景下如何优化服务器的性能?
  4. 瞻博网络推出全新400G数据中心交换机以强化定制服务 首个基于博通Trident 4可编程商用芯片的平台
  5. 瞻博网络连续三年荣登Gartner数据中心与云网络领导者象限
【责任编辑:华轩 TEL:(010)68476606】

点赞 0
分享:
大家都在看
猜你喜欢

订阅专栏+更多

数据湖与数据仓库的分析实践攻略

数据湖与数据仓库的分析实践攻略

助力现代化数据管理:数据湖与数据仓库的分析实践攻略
共3章 | 创世达人

3人订阅学习

云原生架构实践

云原生架构实践

新技术引领移动互联网进入急速赛道
共3章 | KaliArch

30人订阅学习

数据中心和VPDN网络建设案例

数据中心和VPDN网络建设案例

漫画+案例
共20章 | 捷哥CCIE

209人订阅学习

视频课程+更多

订阅51CTO邮刊

点击这里查看样刊

订阅51CTO邮刊

51CTO服务号

51CTO官微