Manual para Usuários do Serviço de Hospedagem de Sites

Recursos Técnicos

Nesta seção são descritos os recursos/serviços do servidor de hospedagem. Estes recursos podem ser alterados sem aviso prévio.

O site a ser desenvolvido deve ser compatível com a tecnologia que se encontra no servidor, conforme abaixo:

  • Serviço web – Apache
  • Linguagem de programação – PHP (versões 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0)
  • Serviço de banco de dados – MariaDB 10.3 (compatível com MySQL)

Acesso ao servidor de hospedagem

Nesta seção é descrito como será feito o acesso, pelo desenvolvedor, aos arquivos que correspondem aos códigos computacionais e demais dados do site hospedado.

VPN:

Todo acesso ao servidor de hospedagem é limitado para IP’s pertencentes à rede da UFV. Caso seja necessário o acesso externo, a conexão deverá ser realizada através da VPN da UFV.

Caso o desenvolvedor possua vínculo ativo com a UFV, basta seguir os passos descritos no manual para configuração da conexão. Caso contrário, o responsável deverá solicitar à DTI (dti@ufv.br) a criação de acesso VPN para o desenvolvedor.

Acesso ao painel da hospedagem:

Para gerenciar os recursos do site, o desenvolvedor deverá acessar o painel administrativo da hospedagem no endereço abaixo, com as credenciais fornecidas pela DTI:

https://hsp.srv.ufv.br:8080/login/

Acesso ao sistema de arquivos (pasta):

Primeiramente, é necessário que seja criado um usuário FTP para acesso ao sistema de arquivos. Para realizar este procedimento siga as etapas abaixo:

01. Acesse o painel da hospedagem;

02. No menu superior, clique na opção Sites;

03. No menu lateral, clique em Usuários FTP;

04. Em seguida, clique no botão verde Adicionar novo usuário;

05. Uma nova tela aparecerá. Nela, preencha os campos Usuário (nome do usuário para acesso) e Senha (crie uma senha para o acesso). Guarde estas informações de acesso num local seguro.

A conexão deverá ser feita através do protocolo FTP, com a utilização de um programa de cliente FTP instalado na máquina do desenvolvedor. Deve ser utilizada a porta padrão do protocolo FTP para conexão, a porta 21.

Os dados para estabelecer uma conexão através do cliente FTP devem ser:

  1. a. Em host ou servidor, deverá ser preenchido o nome do domínio do site ou do servidor (hsp.srv.ufv.br);
  2. b. Em usuário, deve ser preenchido o nome do usuário FTP que você criou, exatamente como mostrado no painel de gerenciamento do ISPConfig;
  3. c. Em senha, deve ser preenchida a senha exata para o usuário FTP criado no painel do ISPConfig. Caso não se recorde da senha, você poderá redefini-la editando o usuário FTP no painel;
  4. d. Em porta, deverá ser definido 21, ou deixado em branco, a depender do cliente;
  5. e. Em alguns clientes e navegadores de arquivos, a conexão pode ser feita também pela URL do protocolo FTP. Por exemplo: ftp://hsp.srv.ufv.br ; ftp://<usuario FTP>:<senha FTP>@hsp.srv.ufv.br (caso queira fornecer também o usuário e senha na URL da conexão).

Sugerimos o programa Filezilla, que pode ser obtido através da URL: https://filezilla-project.org/download.php. Recomendamos que na configuração do cliente FTP seja marcado a opção de modo de transferência “Passivo”.

Os arquivos públicos do site deverão ser inseridos no diretório chamado web.

Outros diretórios que também podem ser utilizados:

  • log – utilizado pelo serviço web para gravar logs de acesso e erros da hospedagem.
  • private – diretório não acessível publicamente, mas visível para o usuário php da hospedagem. Útil para manter arquivos protegidos que devem ter controle de acesso.
  • tmp – utilizado pelo php para gravar arquivos temporários. Caso a hospedagem esteja com a quota de espaço esgotada, recomendamos que verifiquem se não existem arquivos nesse diretório.

Acesso ao banco de dados:

Por padrão, um banco de dados não será criado pela DTI para a hospedagem. Caso o site necessite de um, o desenvolvedor deverá primeiro criar o usuário do banco de dados para depois criar um banco de dados.

Para criar o usuário do banco de dados seguir os passos abaixo para criação:

01. Já logado no painel de hospedagem, no menu superior, clique na opção Sites;

02. No menu lateral, clique em Usuário do Banco de Dados;

03. Em seguida, clique no botão verde Adicionar novo usuário;

04. Uma nova tela aparecerá. Nela, preencha os campos Usuário do banco de Dados (nome do usuário para acesso) e Senha do Banco de Dados (crie uma senha para o acesso). Guarde estas informações de acesso num local seguro.

Para criar o banco de dados seguir os passos abaixo para criação:

01. Já logado no painel de hospedagem, no menu superior, clique na opção Sites;

02. No menu lateral, clique em Banco de Dados;

03. Em seguida, clique no botão verde Adicionar novo banco de dados;

04. Uma nova tela aparecerá. Nela, preencha os campos Site (endereço do seu site), Nome do Banco de Dados (nome do banco) e Usuário do Banco de Dados (escolha o usuário que se conectará ao banco).

05. Por fim, clique no botão inferior verde Salvar.

Para acessar o banco de dados, poderá ser utilizado o phpMyAdmin, disponível em https://www.[DOMINIO].ufv.br/phpmyadmin.

Existe também a possibilidade de acesso ao banco de dados através de um cliente instalado no computador do desenvolvedor, através do serviço mysql na porta 3306. Sugerimos duas opções: Mysql Workbench, que pode ser obtido através da URL https://www.mysql.com/products/workbench/ e o dBeaver, disponível em https://dbeaver.io/download/.

Resolução de problemas comuns

Problema: Ao acessar o painel do ISPConfig, é exibida a mensagem “Possible attack detected. This action has been logged.“

Resolução: No Google Chrome, clique sobre o cadeado a esquerda da barra de endereços; clique em “Cookies“; na janela, selecione todos os cookies na lista e clique em “Remover”, para cada um, e depois clique em “Concluído”. No Mozilla Firefox, clique no cadeado, e em “Limpar cookies e dados de sites do Domínio…”; clique em “Remover” na caixa de diálogo apresentada. Acesse novamente o painel em https://hsp.srv.ufv.br:8080/login/ para realizar o login. Note que, esta ação irá desconectar o usuário de todas contas em sistemas e sites da UFV, mas basta realizar o login novamente.

Problema: O cliente de FTP mostra uma mensagem de erro ao conectar, indicando que o certificado do servidor é desconhecido ou não confiável.

Resolução: Pode depender do cliente utilizado e da mensagem exata de erro exibida. Geralmente, basta clicar em “OK”, ou “Aceitar certificado”, ou algo parecido na tela de alerta exibida. É recomendado também trocar o nome do servidor ou “host”, nas informações de conexão, para “hsp.srv.ufv.br”, e não utilizar o domínio do site.

Problema: Falha ao transmitir alguns arquivos via FTP.

Resolução: Este erro já foi relatado algumas vezes. O problema estava ocorrendo no cliente, não sendo constatado erro no servidor. A atualização do cliente FTP para a última versão disponível, ou utilização de outro cliente para a conexão resolveu o problema, em todas ocasiões em que foi relatado.

Normas

Os usuários do serviço de hospedagem de sites deverão seguir as normas estabelecidas pela Portaria Normativa nº 0007/2020/RTR