Como instalar o Omeka Classic 2.4 CMS em um FreeBSD 11 FAMP VPS

• Pré-requisitos
• Etapa 1: adicionar um usuário Sudo
• Etapa 2: Atualizar o sistema FreeBSD 11
• Etapa 3: Instale o Apache Web Server
• Etapa 4: Instalar o PHP 7.1
• Etapa 5: Instalar o servidor MariaDB (MySQL)
• Etapa 6: criar banco de dados para o Omeka Classic CMS
• Etapa 7: Instalar arquivos Omeka Classic CMS
• Etapa 8: Instalar o ImageMagick
• Etapa 9: Concluir a instalação do Omeka Classic CMS

O Omeka Classic 2.4 CMS é uma plataforma de publicação digital de código aberto e gratuita e um Sistema de gerenciamento de conteúdo (CMS) para compartilhar coleções digitais e criar exposições on-line ricas em mídia. O Omeka Classic 2.4 CMS permite que acadêmicos, bibliotecários, arquivistas, profissionais de museus e entusiastas da cultura criem narrativas complexas e compartilhem coleções e conteúdos ricos a baixo custo, sem sacrificar o design e a qualidade técnica. Omeka aceita e armazena todos os tipos de arquivos, incluindo imagens, vídeo, áudio, documentos de várias páginas, PDFs, apresentações em Power Point; e pode lidar com grandes arquivos de metadados e arquivos (com mais de 1 milhão de itens), sendo as únicas limitações o poder do seu servidor.

Neste tutorial, instalaremos o Omeka Classic 2.4 CMS em um FreeBSD 11 FAMP VPS usando o servidor Apache, PHP 7.1, e um banco de dados MariaDB.

Pré-requisitos

• Uma instância limpa do servidor Vultr FreeBSD 11 com acesso SSH

Etapa 1: adicionar um usuário Sudo

Começaremos adicionando um novo sudousuário.

Primeiro, faça login no seu servidor como root:

ssh root@YOUR_VULTR_IP_ADDRESS

O sudocomando não é instalado por padrão na instância do servidor Vultr FreeBSD 11, portanto, instalaremos primeiro sudo:

pkg install sudo

Agora adicione um novo usuário chamado user1(ou seu nome de usuário preferido):

adduser user1

O addusercomando solicitará muitos detalhes para a conta do usuário; basta selecionar os padrões para a maioria deles, quando fizer sentido. Quando lhe for perguntado se Invite user1 into any other groups?você deve entrar, wheeladicione user1-o ao wheelgrupo.

Agora verifique o /etc/sudoersarquivo para garantir que o sudoersgrupo esteja ativado:

visudo

Procure uma seção como esta:

# %wheel        ALL=(ALL)       ALL

Essa linha nos diz que os usuários que são membros do wheelgrupo podem usar o sudocomando para obter rootprivilégios. Ele será comentado por padrão; portanto, será necessário descomentá-lo e, em seguida, salvar e sair do arquivo.

Podemos verificar a user1associação ao grupo com o groupscomando:

groups user1

Se user1não for um membro do wheelgrupo, você pode usar este comando para atualizar a user1associação ao grupo:

pw group mod wheel -m user1 

Agora use o sucomando para alternar para a nova user1conta de usuário sudo :

su - user1

O prompt de comando será atualizado para indicar que você está conectado à user1conta. Você pode verificar isso com o whoamicomando:

whoami

Agora reinicie o sshdserviço para que você possa efetuar login sshcom a nova conta de usuário sudo não raiz que você acabou de criar:

sudo /etc/rc.d/sshd restart

Saia da user1conta:

exit

Saia da rootconta (que desconectará sua sshsessão):

exit

Agora você pode acessar ssha instância do servidor do host local usando a nova user1conta de usuário sudo não raiz :

ssh user1@YOUR_VULTR_IP_ADDRESS

Se você deseja executar o sudo sem precisar digitar uma senha todas as vezes, abra o /etc/sudoersarquivo novamente, usando visudo:

sudo visudo

Edite a seção do wheelgrupo para que fique assim:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Nota: Desabilitar o requisito de senha para o usuário sudo não é uma prática recomendada, mas é incluído aqui, pois pode tornar a configuração do servidor muito mais conveniente e menos frustrante, especialmente durante sessões mais longas de administração de sistemas. Se você estiver preocupado com as implicações de segurança, sempre poderá reverter a alteração na configuração para o original após concluir suas tarefas de administração.

Sempre que você desejar fazer login na rootconta de usuário a partir da sudoconta, você pode usar um dos seguintes comandos:

sudo -i
sudo su -

Você pode sair da rootconta e retornar à sua sudoconta de usuário a qualquer momento, digitando o seguinte:

exit

Etapa 2: Atualizar o sistema FreeBSD 11

Antes de instalar qualquer pacote na instância do servidor FreeBSD, primeiro atualizaremos o sistema.

Verifique se você está conectado ao servidor usando um usuário sudo não raiz e execute os seguintes comandos:

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

Etapa 3: Instale o Apache Web Server

Instale o servidor da web Apache:

sudo pkg install apache24

Digite yquando solicitado.

Agora use o sysrccomando para permitir que o serviço Apache seja executado automaticamente no momento da inicialização:

sudo sysrc apache24_enable=yes

O sysrccomando atualiza o /etc/rc.confarquivo de configuração; portanto, se você deseja verificar a atualização manualmente, basta abrir o /etc/rc.confarquivo com seu editor de terminal favorito:

vi /etc/rc.conf

Agora inicie o serviço Apache:

sudo service apache24 start

Você pode verificar rapidamente se o apache está em execução visitando o endereço IP ou o domínio da instância do servidor no seu navegador:

http://YOUR_VULTR_IP_ADDRESS/

Você verá a página padrão do FreeBSD Apache exibindo o texto:

It works!

Verifique seu arquivo de configuração padrão do Apache para garantir que a DocumentRootdiretiva aponte para o diretório correto:

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

A DocumentRootopção de configuração terá a seguinte aparência:

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

Agora precisamos ativar o mod_rewritemódulo Apache. Podemos fazer isso pesquisando o arquivo de configuração padrão do Apache para o termo mod_rewrite.

Por padrão, o mod_rewritemódulo Apache será comentado (o que significa que está desativado). A linha de configuração em uma instância limpa do Vultr FreeBSD 11 terá a seguinte aparência:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Simplesmente remova o símbolo de hash para remover o comentário da linha e carregar o módulo. Isso, obviamente, se aplica a outros módulos necessários do Apache:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Agora precisamos editar a Directorydiretiva Apache no mesmo arquivo de configuração para que mod_rewritefuncione corretamente com o Omeka Classic CMS.

Localize a seção do arquivo de configuração que começa com <Directory "/usr/local/www/apache24/data">e mude AllowOverride nonepara AllowOverride All. O resultado final (com todos os comentários removidos) será mais ou menos assim:

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

Agora salve e saia do arquivo de configuração do Apache.

Reiniciaremos o Apache no final deste tutorial, mas reiniciar o Apache regularmente durante a instalação e configuração é certamente um bom hábito, então vamos fazê-lo agora:

sudo service apache24 restart

Etapa 4: Instalar o PHP 7.1

Agora podemos instalar o PHP 7.1 junto com todos os módulos PHP necessários exigidos pelo Omeka Classic CMS:

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 

O FreeBSD 11 nos dá a opção de usar um desenvolvimento php.iniou uma produção php.ini. Como vamos instalar o Omeka Classic em um servidor público da Web, usaremos a versão de produção. Primeiro, faça backup php.ini-production:

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

Em seguida, faça o link direto php.ini-productionpara php.ini:

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

Precisamos configurar o Apache para realmente usar o PHP, então vamos criar um novo arquivo chamado php.confno Includesdiretório Apache :

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

Digite o seguinte texto no arquivo recém-criado:

<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>

Salve e saia do arquivo.

Agora vamos reiniciar o Apache para que ele possa recarregar as alterações na configuração:

sudo service apache24 restart

Etapa 5: Instalar o servidor MariaDB (MySQL)

O FreeBSD 11 usa como padrão o servidor de banco de dados MariaDB, que é um substituto aprimorado, totalmente aberto e desenvolvido pela comunidade, para o servidor MySQL.

Instale a versão mais recente do servidor de banco de dados MariaDB:

sudo pkg install mariadb102-server mariadb102-client

Inicie e ative o servidor MariaDB para executar automaticamente no momento da inicialização:

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

Proteja a instalação do servidor MariaDB:

sudo mysql_secure_installation

Quando solicitado a criar um rootusuário MariaDB / MySQL , selecione "Y" (para sim) e insira uma rootsenha segura . Simplesmente responda "Y" a todas as outras perguntas de sim / não, pois as sugestões padrão são as opções mais seguras.

Etapa 6: criar banco de dados para o Omeka Classic CMS

Efetue login no shell do MariaDB como o rootusuário do MariaDB executando o seguinte comando:

sudo mysql -u root -p

Para acessar o prompt de comando do MariaDB, basta digitar a rootsenha do MariaDB quando solicitado.

Execute as seguintes consultas para criar um banco de dados MariaDB e um usuário de banco de dados para o Omeka Classic CMS:

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;

Você pode substituir o nome do banco de dados omeka_dbe o nome de usuário omeka_userpor algo mais ao seu gosto, se preferir. Além disso, certifique-se de substituir "UltraSecurePassword" por uma senha realmente segura.

Etapa 7: Instalar arquivos Omeka Classic CMS

Altere seu diretório de trabalho atual para o diretório da web padrão:

cd /usr/local/www/apache24/data

Seu diretório de trabalho atual será agora: /usr/local/www/apache24/data. Você pode verificar isso com o pwdcomando (print working directory):

pwd

Agora use wgetpara baixar o pacote de instalação do Omeka Classic CMS:

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

Observação: você deve definitivamente verificar a versão mais recente visitando a página de download do Omeka Classic CMS .

Liste o diretório atual para verificar se você fez o download do arquivo com sucesso:

ls -la

Remover index.html:

sudo rm index.html

Agora descompacte o arquivo zip:

sudo unzip omeka-2.5.1.zip

Mova todos os arquivos de instalação para o diretório raiz da web:

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

Altere a propriedade dos arquivos da web para evitar problemas com permissões:

sudo chown -R www:www * ./

Reinicie o Apache novamente:

sudo service apache24 restart

Agora estamos prontos para avançar para a etapa final.

Etapa 8: Instalar o ImageMagick

O Omeka Classic CMS requer que o ImageMagick processe imagens, portanto, verifique se ele está instalado:

sudo pkg install ImageMagick

Etapa 9: Concluir a instalação do Omeka Classic CMS

1. Para concluir a instalação do Omeka Classic CMS, primeiro precisamos editar o arquivo de configuração do banco de dados do Omeka Classic CMS; portanto, verifique se você está no webroot e abra o db.iniarquivo:

   sudo vi ./db.ini
   

   Substitua os XXXXXXXvalores pelos detalhes de configuração do banco de dados, da seguinte maneira:

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

   Depois de adicionar os valores de configuração apropriados, você pode salvar e sair do arquivo de configuração.

2. Agora visite o endereço IP da instância do servidor no seu navegador ou, se você já definiu as configurações de DNS do Vultr (e deu tempo suficiente para se propagar), basta visitar o seu domínio.

   Para acessar a página de instalação do Omeka Classic CMS, digite o endereço IP da instância do Vultr na barra de endereços do navegador, seguido por /install/:

       http://YOUR_VULTR_IP_ADDRESS/install/
   

3. Na Configure Your Sitepágina Omeka , digite o seguinte Default Superuser Account:

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

4. Em seguida, digite o seguinte Site Settings:

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

   Você pode deixar o restante Site Settingscom os valores padrão ou editá-los para atender às suas necessidades pessoais.

5. Quando estiver satisfeito com os detalhes de configuração do site acima, clique Installpara finalizar a instalação.

Você será redirecionado para uma Successpágina.

Para acessar a seção de administração, basta clicar no Admin Dashboardbotão e inserir seu nome de usuário e senha. Se você não for redirecionado para a página de login do administrador, poderá inserir o endereço do administrador manualmente:

http://YOUR_VULTR_IP_ADDRESS/admin/

Agora você está pronto para começar a adicionar seu conteúdo e a configurar seus materiais e coleções. Verifique a excelente documentação do Omeka Classic CMS para obter mais informações sobre como criar e configurar seu site.