Olá, esse tutorial é uma parte do tópico principal: "Tutorial completo de infraestrutura para montar um servidor TFS 1.x no Ubuntu 22.04" ... 

Aqui ensinaremos como instalar e configurar o ZnoteACC.

 

PASSO 1 - COMO INSTALAR O ZNOTE ACC

 

O projeto principal do Znote está no github e existem duas ramificações principais:

- A primeira, nomeada de MASTER no github (Znote AAC 1.6) suporta as engines OTHire, TFS 0.2, TFS 0.3/4, TFS 1.3 e Distributions based on these (such as OTX) = https://github.com/Znote/ZnoteAAC/tree/master

- A segunda, nomeada de V2 no github (Znote AAC 2.0) suporta as engines TFS 1.4 ou superior e OTservBR-Global = https://github.com/Znote/ZnoteAAC/tree/v2

 

Portanto, verifique o versão que suporta a engine que você irá usar e faça o download em CODE e depois DOWNLOAD ZIP:

 

Após extrair os arquivos, usando o WinSCP, passe os arquivos para a pasta "www" (criada no tutorial instalando o PHP), localizada em /home/ ....

 

PASSO 2 - IMPORTANDO A DATABASE DO ZNOTE ACC

 

Após passar os arquivos do site para a pasta "www", atualize o seu site no navegador e irá aparecer isso: 

 

Clicando no link "Znote ACC shema", irá baixar a database do site Znote que precisará ser importada no phpmyadmin.

 

Para isso, entre em seu phpmyadmin pelo navegador (IP/phpmyadmin, ou o outro destino que você escolheu conforme o tópico de instalação do phpmyadmin) 

 

Entre na dabatase criada para o servidor, conforme explicado na tutorial de configuração do servidor, e agora clique em "IMPORTAR" e depois em "escolher arquivo":

 

 

E então selecione o arquivo que você baixou clicando no link "Znote ACC shema" . Se você não tiver um arquivo, use o padrão do ZNOTE ACC: https://raw.githubusercontent.com/Znote/ZnoteAAC/master/engine/database/znote_schema.sql

 

E por fim, clique em EXECUTAR.

 

 

Para finalizar a conexão do site com o banco de dados da máquina, com o WinSCP entre em /home/www/config.php e ajuste os dados da conexão mysql: 

 

 

Salve e teste novamente a conexão do site pelo navegador.

 

PASSO 3 - CONFIGURANDO O ZNOTE ACC

 

Com o WinSCP entre novamente em /home/www/config.php e ajuste todas as configurações conforme a sua necessidade, Irei cimentar sobre algumas mais importantes ...

 

- modifique $config['ServerEngine'] com a versão correta do TFS que você está executando. (TFS_02, TFS_03, TFS_10, OUTROS). Ex: $config['ServerEngine'] = 'TFS_10';

- modifique $config['page_admin_access'] com o(s) nome(s) da sua conta de administrador. (Após criar um conta essa a account aqui indicada, ela terá acesso de administrador no site)

- modifique $config['server_path'] com o caminho para o servidor. Ex: $config['server_path'] = '/home/otserv';

 

- Para o site armazenar cache na memória/RAM é preciso instalar a extensão do PHP chamada APCu. Use o seguinte comando:

sudo apt install php-apcu

E mude em 'memory' para true na paste de $config['cache']

 

- Na página de galeria é usado o IMGUR como host de imagem e é preciso registrar o aplicativo com eles e adicionar o ID do cliente/secreto. Para isso use o tutorial do Znote: https://github.com/Znote/ZnoteAAC/wiki/IMGUR-powered-Gallery-page

 

- Para o envio de e-mails do site será usado o PHPMailer. Para usá-lo considere usar a última versão estável lançada do PHPMailer ou você pode ter problemas. Baixe o PHPMailer: https://github.com/PHPMailer/PHPMailer/releases e depois extraia para dentro da pasta "www" (onde este arquivo config.php está localizado) Renomeie a pasta para "PHPMailer". Em seguida, ajuste as configurações de correio SMTP com os dados do seu provedor de e-mail no config.php.

 

Para usar o PHPMailer usando uma conta GMAIL deverá ficar assim:

'host' => "smtp.gmail.com", // Outgoing mail server host.
'securityType' => 'tls', // ssl or tls
'port' => 587, // SMTP port number - likely to be 465(ssl) or 587(tls)
'email' => 'teste@gmail.com',
'username' => 'teste@gmail.com', // Likely the same as email
'password' => 'email-senha', // The password.

Lembrando que a porta 587 deverá ser aberta no firewall do servidor.

 

- Para usar o recaptcha do google no site você deverá criar uma conta em: https://www.google.com/recaptcha/
E caso queira usar a opção $config['captcha_use_curl'] = true; deverá usar o comando abaixo para instalar a extensão cURL do PHP:

sudo apt install php-curl

- Para trocar a logo da guild é necessário a extensão GD do PHP, para instala-lo basta usar o comando:

sudo apt install php-gd

- Após o comando de instalação do GB, use os comandos a seguir para dar permissão ao arquivo que gera as novas imagens ... 

cd /home/www/engine/function & sudo chmod 777 -R general.php

- Dê permissão também a pasta de cache do site ... 

cd /home/www/engine & sudo chmod 777 -R cache

- Para usar algumas funções do sistema do Pagseguro no ZnoteAAC é necessário instalar o PHP XML, para instala-lo basta usar o comando:

sudo apt install php-xml

 

PASSO 4 - CONFIGURANDO O ZNOTE ACC JUNTO AO NGINX

 

Usando o WinSCP, vá até a pasta /etc/nginx/sites-available/ e altere o default onde tem ...

try_files $uri $uri/ =404;

Por isso: 

index index.html index.php;
try_files $uri $uri/ /index.php?$args;

Fazendo isso, você ativará o mod_rewrite no nginx.

 

Acima dessa linha: 

location / {

Você pode adicionar o código a seguir para mascarar diretórios conhecidos do Znote AAC:

 

	location /LUA {
		deny all;
		return 404;
	}

	location /engine/cache {
		deny all;
		return 404;
	}

	location /special {
		allow 127.0.0.1;
		deny all;
	}

 

Depois das alterações é necessário recarregar o nginx:

sudo systemctl reload nginx

 

A princípio é isso!

 

Siga as atualizações no tópico principal: "Tutorial completo de infraestrutura para montar um servidor TFS 1.x no Ubuntu 22.04" ... 

 

 

Fontes: 

- https://github.com/Znote/ZnoteAAC

- https://kenfavors.com/code/enabling-nginx-mod_rewrite/

- https://github.com/DevelopersPL/otshosting-provisioning

Editado Abril 15, 2023 2 anos por luanluciano93 (veja o histórico de edições)

Atualizado do Ubuntu 20.04 para  Ubuntu 22.04.

Boa tarde, quando coloco todos os arquivos na pasta WWW , a pagina me retorna erro 500

  Em 27/07/2022 em 17:52, killdary disse:

Boa tarde, quando coloco todos os arquivos na pasta WWW , a pagina me retorna erro 500

desconheço.

  Em 12/03/2022 em 03:13, luanluciano93 disse:

Olá, esse tutorial é uma parte do tópico principal: "Tutorial completo de infraestrutura para montar um servidor TF 1.x no Ubuntu 22.04" ... 

Aqui ensinaremos como instalar e configurar o ZnoteACC.

 

PASSO 1 - COMO INSTALAR O ZNOTE ACC

 

O projeto principal do Znote está no github e existem duas ramificações principais:

- A primeira, nomeada de MASTER no github (Znote AAC 1.6) suporta as engines OTHire, TFS 0.2, TFS 0.3/4, TFS 1.3 e Distributions based on these (such as OTX) = https://github.com/Znote/ZnoteAAC/tree/master

- A segunda, nomeada de V2 no github (Znote AAC 2.0) suporta as engines TFS 1.4 ou superior e OTservBR-Global = https://github.com/Znote/ZnoteAAC/tree/v2

 

Portanto, verifique o versão que suporta a engine que você irá usar e faça o download em CODE e depois DOWNLOAD ZIP:

 

Após extrair os arquivos, usando o WinSCP, passe os arquivos para a pasta "www" (criada no tutorial instalando o PHP), localizada em /home/ ....

 

PASSO 2 - IMPORTANDO A DATABASE DO ZNOTE ACC

 

Após passar os arquivos do site para a pasta "www", atualize o seu site no navegador e irá aparecer isso: 

 

Clicando no link "Znote ACC shema", irá baixar a database do site Znote que precisará ser importada no phpmyadmin.

 

Para isso, entre em seu phpmyadmin pelo navegador (IP/phpmyadmin, ou o outro destino que você escolheu conforme o tópico de instalação do phpmyadmin) 

 

Entre na dabatase criada para o servidor, conforme explicado na tutorial de configuração do servidor, e agora clique em "IMPORTAR" e depois em "escolher arquivo":

 

 

E então selecione o arquivo que você baixou clicando no link "Znote ACC shema" . Se você não tiver um arquivo, use o padrão do ZNOTE ACC: https://raw.githubusercontent.com/Znote/ZnoteAAC/master/engine/database/znote_schema.sql

 

E por fim, clique em EXECUTAR.

 

 

Para finalizar a conexão do site com o banco de dados da máquina, com o WinSCP entre em /home/www/config.php e ajuste os dados da conexão mysql: 

 

 

Salve e teste novamente a conexão do site pelo navegador.

 

PASSO 3 - CONFIGURANDO O ZNOTE ACC

 

Com o WinSCP entre novamente em /home/www/config.php e ajuste todas as configurações conforme a sua necessidade, Irei cimentar sobre algumas mais importantes ...

 

- modifique $config['ServerEngine'] com a versão correta do TFS que você está executando. (TFS_02, TFS_03, TFS_10, OUTROS). Ex: $config['ServerEngine'] = 'TFS_10';

- modifique $config['page_admin_access'] com o(s) nome(s) da sua conta de administrador. (Após criar um conta essa a account aqui indicada, ela terá acesso de administrador no site)

- modifique $config['server_path'] com o caminho para o servidor. Ex: $config['server_path'] = '/home/otserv';

 

- Para o site armazenar cache na memória/RAM é preciso instalar a extensão do PHP chamada APCu. Use o seguinte comando:

sudo apt install php-apcu

E mude em 'memory' para true na paste de $config['cache']

 

- Na página de galeria é usado o IMGUR como host de imagem e é preciso registrar o aplicativo com eles e adicionar o ID do cliente/secreto. Para isso use o tutorial do Znote: https://github.com/Znote/ZnoteAAC/wiki/IMGUR-powered-Gallery-page

 

- Para o envio de e-mails do site será usado o PHPMailer. Para usá-lo considere usar a última versão estável lançada do PHPMailer ou você pode ter problemas. Baixe o PHPMailer: https://github.com/PHPMailer/PHPMailer/releases e depois extraia para dentro da pasta "www" (onde este arquivo config.php está localizado) Renomeie a pasta para "PHPMailer". Em seguida, ajuste as configurações de correio SMTP com os dados do seu provedor de e-mail no config.php.

 

Para usar o PHPMailer usando uma conta GMAIL deverá ficar assim:

'host' => "smtp.gmail.com", // Outgoing mail server host.
'securityType' => 'tls', // ssl or tls
'port' => 587, // SMTP port number - likely to be 465(ssl) or 587(tls)
'email' => 'teste@gmail.com',
'username' => 'teste@gmail.com', // Likely the same as email
'password' => 'email-senha', // The password.

Lembrando que a porta 587 deverá ser aberta no firewall do servidor.

 

- Para usar o recaptcha do google no site você deverá criar uma conta em: https://www.google.com/recaptcha/
E caso queira usar a opção $config['captcha_use_curl'] = true; deverá usar o comando abaixo para instalar a extensão cURL do PHP:

sudo apt install php-curl

 

 

PASSO 4 - CONFIGURANDO O ZNOTE ACC JUNTO AO NGINX

 

Usando o WinSCP, vá até a pasta /etc/nginx/sites-available/ e altere o default onde tem ...

try_files $uri $uri/ =404;

Por isso: 

index index.html index.php;
try_files $uri $uri/ /index.php?$args;

Fazendo isso, você ativará o mod_rewrite no nginx.

 

Acima dessa linha: 

location / {

Você pode adicionar o código a seguir para mascarar diretórios conhecidos do Znote AAC:

 

	location /LUA {
		deny all;
		return 404;
	}

	location /engine/cache {
		deny all;
		return 404;
	}

	location /special {
		allow 127.0.0.1;
		deny all;
	}

 

Depois das alterações é necessário recarregar o nginx:

sudo systemctl reload nginx

 

A princípio é isso!

 

Siga as atualizações no tópico principal: "Tutorial completo de infraestrutura para montar um servidor TF 1.x no Ubuntu 22.04" ... 

 

 

Fontes: 

- https://github.com/Znote/ZnoteAAC

- https://kenfavors.com/code/enabling-nginx-mod_rewrite/

- https://github.com/DevelopersPL/otshosting-provisioning

apos extrair os arquivos do znote o meu site para de funcionar

Esta página não está funcionando no momento

vps41280.publiccloud.com.br não pode lidar com esta solicitação no momento.

HTTP ERROR 500

recebo esse erro, porém fiz o restante do tutorial completo mais mesmo assim n consigo colocar o site pra funcionar