Znote AAC Instalando e configurando o ZnoteACC no Ubuntu 22.04

[luanluciano93 1994]

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' => '[email protected]',
'username' => '[email protected]', // 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 por luanluciano93 (veja o histórico de edições)

[luanluciano93 1994]

Atualizado do Ubuntu 20.04 para  Ubuntu 22.04.

[killdary 0]

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

[luanluciano93 1994]

9 horas atrás, killdary disse:

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

desconheço.

[erickk 0]

Em 12/03/2022 em 00: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' => '[email protected]',
'username' => '[email protected]', // 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

 

[luanluciano93 1994]

@erickk você seguiu todos os tutoriais ou apenas o do znote? O seu PHP e o seu NGINX estão funcionando?

TOPICO ~ 
Adicionado extensão GD do PHP, que é usada na troca do logo da guild no website.



 

Editado Setembro 7, 2022 por luanluciano93 (veja o histórico de edições)

[erickk 0]

Em 07/09/2022 em 00:29, luanluciano93 disse:

@erickk você seguiu todos os tutoriais ou apenas o do znote? O seu PHP e o seu NGINX estão funcionando?

TOPICO ~ 
Adicionado extensão GD do PHP, que é usada na troca do logo da guild no website.



 

reinstalei o servidor da maquina virtual e refiz todo o tutorial ai deu certo, uma duvida você teria algum tutorial ensinando configurar o site? não sei mexer nele ai n consigo criar conta sempre me aparece erro estou procurando pelo forum porém não encontrei se puder me ajudar agradeço

Register Account

Fatal error: Uncaught mysqli_sql_exception: Unknown column 'creation' in 'field list' in /home/www/engine/database/connect.php:90 Stack trace: #0 /home/www/engine/database/connect.php(90): mysqli_query() #1 /home/www/engine/database/connect.php(80): voidQuery() #2 /home/www/engine/function/users.php(1004): mysql_insert() #3 /home/www/register.php(139): user_create_account() #4 {main} thrown in /home/www/engine/database/connect.php on line 90

[luanluciano93 1994]

Em 08/09/2022 em 20:40, erickk disse:

reinstalei o servidor da maquina virtual e refiz todo o tutorial ai deu certo, uma duvida você teria algum tutorial ensinando configurar o site? não sei mexer nele ai n consigo criar conta sempre me aparece erro estou procurando pelo forum porém não encontrei se puder me ajudar agradeço

Register Account

Fatal error: Uncaught mysqli_sql_exception: Unknown column 'creation' in 'field list' in /home/www/engine/database/connect.php:90 Stack trace: #0 /home/www/engine/database/connect.php(90): mysqli_query() #1 /home/www/engine/database/connect.php(80): voidQuery() #2 /home/www/engine/function/users.php(1004): mysql_insert() #3 /home/www/register.php(139): user_create_account() #4 {main} thrown in /home/www/engine/database/connect.php on line 90

Provavelmente você pulou a parte do tutorial sobre add as tabelas e colunas do site no banco de dados, revise o tutorial.

[tinkywinky 2]

bom dia!

 

após a etapa de carregar a database, o meu site tá dando erro, aparece isso aqui quando acesso meu IP:

 

Fatal error: Uncaught mysqli_sql_exception: Connection refused in /home/www/engine/database/connect.php:34 Stack trace: #0 /home/www/engine/database/connect.php(34): mysqli->__construct() #1 /home/www/engine/init.php(38): require_once('...') #2 /home/www/index.php(2): require_once('...') #3 {main} thrown in /home/www/engine/database/connect.php on line 34

 

Alguma ideia de cocmo resolver?

 

a linha 34 do arquivo connect.php é:

 

$connect = new mysqli($config['sqlHost'], $config['sqlUser'], $config['sqlPassword'], $config['sqlDatabase']);

 

obs: já fiz o passo 3 tbm, mas continuo tendo esse msm erro. O passo 4 eu n fiz.

 

mto obrigado pela atenção

 

atencisamente,

tinky~

[Aksz 46]

7 horas atrás, tinkywinky disse:

bom dia!

 

após a etapa de carregar a database, o meu site tá dando erro, aparece isso aqui quando acesso meu IP:

 

Fatal error: Uncaught mysqli_sql_exception: Connection refused in /home/www/engine/database/connect.php:34 Stack trace: #0 /home/www/engine/database/connect.php(34): mysqli->__construct() #1 /home/www/engine/init.php(38): require_once('...') #2 /home/www/index.php(2): require_once('...') #3 {main} thrown in /home/www/engine/database/connect.php on line 34

 

Alguma ideia de cocmo resolver?

 

a linha 34 do arquivo connect.php é:

 

$connect = new mysqli($config['sqlHost'], $config['sqlUser'], $config['sqlPassword'], $config['sqlDatabase']);

 

obs: já fiz o passo 3 tbm, mas continuo tendo esse msm erro. O passo 4 eu n fiz.

 

mto obrigado pela atenção

 

atencisamente,

tinky~

Olá, bom dia tudo bem?
Está dando conexão recusada.
$config['sqlHost'] qual ip está configurado nessa variavel?
As vezes pode ser a permissão do mysql.

[tinkywinky 2]

Olá! Consegui resolver o problema da conexão do site com a database. Mas agora estou com problema na hora de importar a database.

 

Eu estou usando a database que vc botou no post "znote_schema.sql"

 

Eu consigo importar, aparecem as tabelas lá e tudo mais. Porém, aparece o seguinte erro ao final da importação:

 

-- Convert existing accounts in database to be Znote AAC compatibleINSERT INTO `znote_accounts` (`account_id`, `ip`, `created`, `flag`)SELECT  `a`.`id` AS `account_id`,  0 AS `ip`,  UNIX_TIMESTAMP(CURDATE()) AS `created`,  '' AS `flag`FROM `accounts` AS `a`LEFT JOIN `znote_accounts` AS `z`  ON `a`.`id` = `z`.`account_id`WHERE `z`.`created` IS NULL;

Mensagens do MySQL : 
#1146 - Tabela 'classicstyller860.accounts' não existe

 

E quando entro no site pelo IP da minha máquina aparece assim:

Fatal error: Uncaught mysqli_sql_exception: Table 'classicstyller860.players' doesn't exist in /home/www/engine/database/connect.php:66 Stack trace: #0 /home/www/engine/database/connect.php(66): mysqli_query() #1 /home/www/engine/function/users.php(146): mysql_select_multi() #2 /home/www/layout/sub/index.php(35): fetchAllNews() #3 /home/www/index.php(11): include('...') #4 {main} thrown in /home/www/engine/database/connect.php on line 66

 

Sabe como posso resolver isso?

é como se a database q to importando não tivesse as colunas que o site exige... 

Editado Dezembro 3, 2022 por tinkywinky (veja o histórico de edições)

[luanluciano93 1994]

Adicionado comando para dar a permissão necessária a pasta cache do site.