如何在FreeBSD 11 FAMP VPS上安装Omeka Classic 2.4 CMS

• 先决条件
• 步骤1：添加Sudo用户
• 步骤2：更新FreeBSD 11系统
• 步骤3：安装Apache Web服务器
• 步骤4：安装PHP 7.1
• 步骤5：安装MariaDB（MySQL）服务器
• 步骤6：为Omeka Classic CMS创建数据库
• 步骤7：安装Omeka Classic CMS文件
• 步骤8：安装ImageMagick
• 步骤9：完成Omeka Classic CMS安装

Omeka Classic 2.4 CMS是一个免费的开源数字发布平台和内容管理系统（CMS），用于共享数字馆藏并创建媒体丰富的在线展览。Omeka Classic 2.4 CMS使学者，图书馆员，档案管理员，博物馆专业人士和文化爱好者可以创建复杂的叙事并以低成本共享丰富的收藏品和内容，而又不牺牲设计和技术质量。Omeka接受并存储所有类型的文件，包括图像，视频，音频，多页文档，PDF，Power Point演示文稿；并且可以处理大量的元数据和文件存档（超过一百万个项目），唯一的限制就是服务器的功能。

在本教程中，我们将使用Apache Web服务器，PHP 7.1和M​​ariaDB数据库在FreeBSD 11 FAMP VPS上安装Omeka Classic 2.4 CMS。

先决条件

• 具有SSH访问权限的干净Vultr FreeBSD 11服务器实例

步骤1：添加Sudo用户

我们将从添加新sudo用户开始。

首先，以以下身份登录到服务器root：

ssh root@YOUR_VULTR_IP_ADDRESS

sudo默认情况下，该命令未安装在Vultr FreeBSD 11服务器实例中，因此我们将首先安装sudo：

pkg install sudo

现在添加一个新用户user1（或您的首选用户名）：

adduser user1

该adduser命令将提示您输入有关该用户帐户的许多详细信息，因此只需在有意义的情况下为大多数用户选择默认值即可。当询问是否选择时Invite user1 into any other groups?，应输入wheel添加user1到wheel组。

现在检查/etc/sudoers文件以确保sudoers启用了该组：

visudo

查找如下部分：

# %wheel        ALL=(ALL)       ALL

此行告诉我们，作为wheel组成员的用户可以使用该sudo命令来获取root特权。默认情况下，它将被注释掉，因此您需要取消注释，然后保存并退出文件。

我们可以user1使用以下groups命令验证组成员身份：

groups user1

如果user1不是该wheel组的成员，则可以使用以下命令来更新user1组成员身份：

pw group mod wheel -m user1 

现在使用su命令切换到新的sudo用户user1帐户：

su - user1

命令提示符将更新以指示您现在已经登录到该user1帐户。您可以使用以下whoami命令进行验证：

whoami

现在重新启动sshd服务，以便您可以ssh使用刚刚创建的新的非root sudo用户帐户登录：

sudo /etc/rc.d/sshd restart

退出user1帐户：

exit

退出root帐户（这将断开您的ssh会话）：

exit

现在，您可以ssh使用新的非root用户sudo用户user1帐户从本地主机进入服务器实例：

ssh user1@YOUR_VULTR_IP_ADDRESS

如果要执行sudo而不需要每次都输入密码/etc/sudoers，请使用再次打开文件visudo：

sudo visudo

编辑该wheel组的部分，使其如下所示：

%wheel        ALL=(ALL)       NOPASSWD: ALL

请注意： 不建议对sudo用户禁用密码要求，但此操作已包括在此处，因为它可以使服务器配置更加方便且避免烦恼，尤其是在较长的系统管理会话期间。如果您担心安全隐患，则可以在完成管理任务后始终将配置更改还原为原始更改。

每当您root要从用户帐户中登录该sudo用户帐户时，都可以使用以下命令之一：

sudo -i
sudo su -

您只需输入以下内容，即可随时退出root帐户并返回您的sudo用户帐户：

exit

步骤2：更新FreeBSD 11系统

在FreeBSD服务器实例上安装任何软件包之前，我们将首先更新系统。

确保您使用非root用户sudo登录到服务器，并运行以下命令：

sudo freebsd-update fetch
sudo freebsd-update install
sudo pkg update
sudo pkg upgrade

步骤3：安装Apache Web服务器

安装Apache Web服务器：

sudo pkg install apache24

输入y提示时。

现在，使用以下sysrc命令启用Apache服务，使其在引导时自动执行：

sudo sysrc apache24_enable=yes

该sysrc命令将更新/etc/rc.conf配置文件，因此，如果要手动验证配置更新，则可以/etc/rc.conf使用您喜欢的终端编辑器打开该文件：

vi /etc/rc.conf

现在启动Apache服务：

sudo service apache24 start

您可以通过在浏览器中访问服务器实例的IP地址或域来快速检查apache是​​否正在运行：

http://YOUR_VULTR_IP_ADDRESS/

您将看到默认的FreeBSD Apache页面显示以下文本：

It works!

检查您的Apache默认配置文件，以确保该DocumentRoot指令指向正确的目录：

sudo vi /usr/local/etc/apache24/httpd.conf

该DocumentRoot配置选项会是这样的：

DocumentRoot "/usr/local/www/apache24/data"

现在，我们需要启用mod_rewriteApache模块。为此，我们可以在默认的Apache配置文件中搜索术语mod_rewrite。

默认情况下，mod_rewriteApache模块将被注释掉（这意味着它被禁用了）。干净的Vultr FreeBSD 11实例上的配置行如下所示：

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

只需删除哈希符号即可取消注释该行并加载模块。当然，这也适用于任何其他必需的Apache模块：

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

现在，我们需要Directory在同一配置文件中编辑Apache指令，以便可以mod_rewrite与Omeka Classic CMS一起正常使用。

找到配置文件中以开头的部分，<Directory "/usr/local/www/apache24/data">然后更改AllowOverride none为AllowOverride All。最终结果（除去所有注释）将如下所示：

<Directory "/var/www/html">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

现在保存并退出Apache配置文件。

在本教程的最后，我们将重新启动Apache，但是在安装和配置过程中定期重新启动Apache当然是一个好习惯，所以现在就开始吧：

sudo service apache24 restart

步骤4：安装PHP 7.1

现在，我们可以安装PHP 7.1以及Omeka Classic CMS所需的所有必需的PHP模块：

sudo pkg install php71 mod_php71 php71-gd php71-mbstring php71-mysqli php71-xml php71-curl php71-ctype php71-tokenizer php71-simplexml php71-dom php71-session php71-iconv php71-hash php71-json php71-fileinfo php71-pdo php71-pdo_mysql php71-zlib php71-openssl php71-zip php71-phar php71-exif 

FreeBSD 11使我们可以选择使用开发php.ini或产品php.ini。由于我们将在公共Web服务器上安装Omeka Classic，因此我们将使用生产版本。首先，备份php.ini-production：

sudo cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini-production.backup

然后软链接php.ini-production到php.ini：

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

我们需要将Apache配置为实际使用PHP，因此让我们php.conf在Apache Includes目录中创建一个新文件：

sudo vi /usr/local/etc/apache24/Includes/php.conf

在新创建的文件中输入以下文本：

<IfModule dir_module>
    DirectoryIndex index.php index.html
    <FilesMatch "\.php$">
        SetHandler application/x-httpd-php
    </FilesMatch>
    <FilesMatch "\.phps$">
        SetHandler application/x-httpd-php-source
    </FilesMatch>
</IfModule>

保存并退出文件。

现在，让我们重新启动Apache，以便它可以重新加载配置更改：

sudo service apache24 restart

步骤5：安装MariaDB（MySQL）服务器

FreeBSD 11默认使用MariaDB数据库服务器，它是MySQL服务器的增强，完全开源，社区开发的直接替代产品。

安装最新版本的MariaDB数据库服务器：

sudo pkg install mariadb102-server mariadb102-client

启动并启用MariaDB服务器以在引导时自动执行：

sudo sysrc mysql_enable="yes"
sudo service mysql-server start

保护您的MariaDB服务器安装：

sudo mysql_secure_installation

当提示您创建MariaDB / MySQL root用户时，选择“是”（代表“是”），然后输入安全root密码。只需对其他所有是/否问题回答“是”，因为默认建议是最安全的选择。

步骤6：为Omeka Classic CMS创建数据库

root通过运行以下命令，以MariaDB 用户身份登录MariaDB shell ：

sudo mysql -u root -p

要访问MariaDB命令提示符，只需root在出现提示时输入MariaDB 密码即可。

运行以下查询以为Omeka Classic CMS创建MariaDB数据库和数据库用户：

CREATE DATABASE omeka_db CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'omeka_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON omeka_db.* TO 'omeka_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

如果愿意，您可以根据自己的喜好替换数据库名称omeka_db和用户名omeka_user。另外，请确保将“ UltraSecurePassword”替换为实际安全的密码。

步骤7：安装Omeka Classic CMS文件

将当前工作目录更改为默认Web目录：

cd /usr/local/www/apache24/data

您当前的工作目录将是： /usr/local/www/apache24/data。您可以使用pwd（打印工作目录）命令检查此内容：

pwd

现在用于wget下载Omeka Classic CMS安装软件包：

sudo wget https://github.com/omeka/Omeka/releases/download/v2.5.1/omeka-2.5.1.zip

请注意： 您绝对应该通过访问Omeka Classic CMS下载页面检查最新版本。

列出当前目录以检查是否已成功下载文件：

ls -la

移除index.html：

sudo rm index.html

现在解压缩zip存档：

sudo unzip omeka-2.5.1.zip

将所有安装文件移至Web根目录：

sudo mv omeka-2.5.1/* /usr/local/www/apache24/data

更改Web文件的所有权，以避免任何权限问题：

sudo chown -R www:www * ./

再次重新启动Apache：

sudo service apache24 restart

现在，我们可以继续进行最后一步了。

步骤8：安装ImageMagick

Omeka Classic CMS需要ImageMagick来处理图像，因此，请确保已安装它：

sudo pkg install ImageMagick

步骤9：完成Omeka Classic CMS安装

1. 要完成Omeka Classic CMS的安装，我们首先需要编辑Omeka Classic CMS数据库配置文件，因此首先请确保您位于webroot中，然后打开该db.ini文件：

   sudo vi ./db.ini
   

   将XXXXXXX值替换为数据库配置详细信息，如下所示：

   [database]
   host     = "localhost"
   username = "omeka_user"
   password = "UltraSecurePassword"
   dbname   = "omeka_db"
   prefix   = "omeka_"
   charset  = "utf8"
   ;port     = ""
   

   添加适当的配置值后，您可以保存并退出配置文件。

2. 现在，在浏览器中访问服务器实例的IP地址，或者如果您已经配置了Vultr DNS设置（并为其提供了足够的传播时间），则可以直接访问您的域。

   要访问Omeka Classic CMS安装页面，请在浏览器地址栏中输入Vultr实例IP地址，然后输入/install/：

       http://YOUR_VULTR_IP_ADDRESS/install/
   

3. 在Omeka Configure Your Site页面上，输入以下内容Default Superuser Account：

   Username:                   <superuser username>
   Password:                   <a secure password>
   Email:                      <superuser email address>
   

4. 接下来，输入以下内容Site Settings：

   Administrator Email:        <administrator email>
   Site Title:                 <the title off the site>
   ImageMagick Directory Path: /usr/local/bin/
   

   您可以将其余的保留为Site Settings默认值，也可以根据自己的需要进行编辑。

5. 当您对上述站点配置详细信息满意时，单击Install以完成安装。

您将被重定向到Success页面。

要访问管理部分，只需单击Admin Dashboard按钮，然后输入您的用户名和密码。如果您未重定向到管理员登录页面，则可以手动输入管理员地址：

http://YOUR_VULTR_IP_ADDRESS/admin/

现在您可以开始添加内容并配置材料和收藏了。确保您查看了出色的Omeka Classic CMS文档，以获取有关如何构建和配置站点的更多信息。