DEV - Manual de Instalação - All In One - i-Educar e PostgreSQL
Esse manual aborda a instalação do i-Educar e seu banco de dados PostgreSQL no modo desenvolvimento em uma única instância de máquina.
APENAS O PASSO 04 É NECESSÁRIO ALTERAR ALGUM VALOR, OS DEMAIS É NECESSÁRIO SOMENTE COPIAR E COLAR!
OS PASSO 12 E PASSO 23 SÃO OS ÚNICOS QUE NÃO SÃO UM COMANDO, NELES HAVERÁ A NECESSIDADE DA EDIÇÃO DOS ARQUIVOS PELO USUÁRIO, AJUSTANDO VALORES CONFORME NECESSIDADE.
PRÉ-REQUISÍTOS
- Sistema Operacional Ubuntu na 18.04 ou 20.04
- 2GB de Memória RAM (Adicionais são recomendados)
- 2vCPU Core (Adicionais são recomendados)
- Usuário linux para gerenciamento da aplicação.
PASSO 01 - ATUALIZAR LIBS BASE DO SISTEMA OPERACIONAL
sudo apt update -y && sudo apt upgrade -y
PASSO 02 - INSTALAR LIBS BASE DO SISTEMA OPERACIONAL E LIBS BASE UTILIZADAS PELO i-Educar
sudo apt install -y git wget curl zip npm sudo unzip openssl net-tools software-properties-common bash-completion openjdk-8-jre
PASSO 03 - AJUSTAR LOCALE DO SERVIDOR
sudo locale-gen pt_BR.UTF-8
sudo dpkg-reconfigure --frontend=noninteractive locales
sudo update-locale LANG=pt_BR.UTF-8
PASSO 04 - DEFINIR VARIÁVEIS UTILIZADAS NO PROCESSO DE INSTALAÇÃO
Obs. Não é necessário copiar os comentários. Comentários são as linhas iniciadas com o caractere #
# Aqui é obrigatório informar o IP da instância de máquina.
# Por padrão ele obtem automaticamente, porém em alguns casos a instância de máquina pode conter duas ou mais interfaces de rede,
# nesses casos será necessário informar manualmente qual IP deseja usar para acessar a aplicação após instalada.
export IP=$(hostname -I | awk '{print $1}')
# Aqui é obrigatório informar a versão do PostgreSQL
export POSTGRES_VERSAO=13
# Aqui é obrigatório informar a versão do i-Educar.
export VERSAO_IEDUCAR=2.6.5
# Aqui a variável DB_HOST obtem o valor do IP do banco de dados da variável $IP informada anteriormente.
export DB_HOST=$IP
# Aqui deve ser informado a porta de acesso ao banco de dados.
# Default: 5432
export DB_PORTA=5432
# Aqui é obrigatório informar o nome do banco de dados de conexão com o banco de dados a ser criado na instância do PostgreSQL.
# Default: ieducar
export DB_DATABASE_IEDUCAR=ieducar
# Aqui é obrigatório informar o usuário de conexão com o banco de dados a ser criado na instância do PostgreSQL.
# Default: ieducar
export DB_USUARIO_IEDUCAR=ieducar
# Aqui pode ser informado uma senha de sua escolha, caso contrário,
# o script irá gerar uma senha e apresentar no final da instalação.
export DB_PASSWORD_IEDUCAR=$(openssl passwd -crypt $DB_USUARIO_IEDUCAR)
PASSO 05 - BAIXAR E ADICIONAR A CHAVE DO REPOSITÓRIO POSTGRESQL
sudo wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
PASSO 06 - ADICIONAR O ENDEREÇO DO SOURCE LIST DO REPOSITÓRIO POSTGRESQL
sudo echo "deb http://apt.postgresql.org/pub/repos/apt/ `lsb_release -cs`-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list
PASSO 07 - ATUALIZAR SOURCE LIST PARA OBTER O REPOSITÓRIO DO POSTGRESQL
sudo apt update -y
PASSO 08 - INSTALAR O POSTGRESQL
sudo apt install -y postgresql-$POSTGRES_VERSAO postgresql-client-$POSTGRES_VERSAO
PASSO 09 - REMOVER O CLUSTER DEFAULT DO POSTGRESQL
sudo pg_dropcluster --stop $POSTGRES_VERSAO main
PASSO 10 - CRIAR O CLUSTER DEFAULT DO POSTGRESQL
sudo pg_createcluster -u postgres -g postgres "$POSTGRES_VERSAO" -e UTF8 --locale="pt_BR.UTF-8" --lc-collate="pt_BR.UTF-8" main
PASSO 11 - DESABILITAR AUTENTICAÇÃO NO POSTGRESQL (SERÁ AJUSTADO NO FINAL DO PROCESSO)
A desabilitação é necessários para executar comandos SQL sem a necessidade de informar a senha.
No final do processo será habilitado a autenticação.
sudo cat << PG_HBA > /etc/postgresql/$POSTGRES_VERSAO/main/pg_hba.conf
# TYPE DATABASE USER CIDR-ADDRESS METHOD
local all postgres trust
local all all trust
host all all all trust
host all all ::1/128 trust
local replication all trust
host replication all 127.0.0.1/32 trust
host replication all ::1/128 trust
PG_HBA
PASSO 12 - CONFIGURAR O POSTGRESQL
Para configurar o PostgreSQL, deve ser ajustado alguns valores para
postgresql.conf
Caso algumas das propriedades abaixo esteja comentadas, será necessário descomentar.
- /etc/postgresql/$POSTGRES_VERSAO/main/postgresql.conf
- listen_addresses = '*'
PASSO 13 - REINICIAR O POSTGRESQL
sudo systemctl restart postgresql
PASSO 14 - DEFINIR SENHA PARA O USUÁRIO postgres
DB_PASSWORD_POSTGRES=$(openssl passwd -crypt postgres)
psql -U postgres -c "ALTER USER postgres WITH PASSWORD '$DB_PASSWORD_POSTGRES';"
PASSO 15 - INSTALAR NGINX
sudo apt install -y nginx
PASSO 16 - REMOVER SITE DEFAULT DO NGINX
sudo rm -v /etc/nginx/sites-enabled/default
PASSO 17 - FAZER BACKUP DO ARQUIVO DE CONFIGURAÇÃO DO NGINX
sudo mv /etc/nginx/nginx.conf /etc/nginx/nginx.conf.ori
PASSO 18 - CONFIGURAR PARAMETROS NGINX
sudo cat << NGINX_CONFIG > /etc/nginx/nginx.conf
user www-data;
worker_processes auto;
pid /run/nginx.pid;
include /etc/nginx/modules-enabled/*.conf;
events {
worker_connections 1024;
# multi_accept on;
}
http {
##
# Basic Settings
##
sendfile on;
tcp_nopush on;
tcp_nodelay on;
keepalive_timeout 65;
types_hash_max_size 2048;
# server_tokens off;
# server_names_hash_bucket_size 64;
# server_name_in_redirect off;
client_body_buffer_size 64;
client_max_body_size 100m;
client_body_in_single_buffer on;
client_header_buffer_size 1m;
large_client_header_buffers 4 8k;
include /etc/nginx/mime.types;
default_type application/octet-stream;
##
# SSL Settings
##
ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3; # Dropping SSLv3, ref: POODLE
ssl_prefer_server_ciphers on;
##
# Logging Settings
##
access_log /var/log/nginx/access.log;
error_log /var/log/nginx/error.log;
##
# Gzip Settings
##
gzip on;
# gzip_vary on;
# gzip_proxied any;
# gzip_comp_level 6;
# gzip_buffers 16 8k;
# gzip_http_version 1.1;
# gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
##
# Virtual Host Configs
##
include /etc/nginx/conf.d/*.conf;
include /etc/nginx/sites-enabled/*;
}
NGINX_CONFIG
PASSO 19 - REINICIAR O NGINX
sudo service nginx restart
PASSO 20 - ADICIONAR REPOSITÓRIO PPA DO PHP
sudo add-apt-repository -y ppa:ondrej/php
PASSO 21 - ATUALIZAR SOURCE LIST PARA OBTER O REPOSITÓRIO DO PHP
sudo apt update -y
PASSO 22 - INSTALAR O PHP
sudo apt install -y php7.4-fpm php7.4-common php7.4-zip php7.4-pgsql php7.4-curl php7.4-xml php7.4-xmlrpc php7.4-json php7.4-pdo php7.4-gd php7.4-imagick php7.4-ldap php7.4-imap php7.4-mbstring php7.4-intl php7.4-cli php7.4-tidy php7.4-bcmath php7.4-opcache php7.4-ctype php7.4-dom php7.4-fileinfo php7.4-iconv php7.4-Phar php7.4-SimpleXML php7.4-tokenizer php7.4-xmlreader php7.4-xmlwriter
PASSO 23 - CONFIGURAR O PHP
Para configurar o PHP, deve ser ajustado alguns valores para os arquivos
php.iniewww.conf
Caso algumas das propriedades abaixo esteja comentadas, será necessário descomentar.
/etc/php/7.4/fpm/php.ini
- memory_limit = 2048M
- upload_max_filesize = 1024M
- post_max_size = 1024M
- max_execution_time = 1800
/etc/php/7.4/fpm/pool.d/www.conf
- request_terminate_timeout = 1800
PASSO 24 - REINICIAR O PHP
sudo service php7.4-fpm restart
PASSO 25 - REALIZAR O DOWNLOAD DO PACOTE DO i-Educar
sudo wget https://github.com/portabilis/i-educar/releases/download/$VERSAO_IEDUCAR/ieducar-$VERSAO_IEDUCAR.tar.gz -O /tmp/ieducar-$VERSAO_IEDUCAR.tar.gz
PASSO 26 - CONFIGURAR VIRTUAL HOST i-Educar
sudo cat << NGINX_IEDUCAR > /etc/nginx/conf.d/ieducar.conf
upstream php-fpm {
server unix:/run/php/php7.4-fpm.sock;
}
server {
listen 80;
server_name _;
root /var/www/ieducar/public;
index index.php index.html;
error_log /var/log/nginx/error.log;
access_log /var/log/nginx/access.log;
location ~ ^/intranet/?$ {
rewrite ^.*$ /intranet/index.php redirect;
}
location ~ /module/(.*)/(styles|scripts|imagens)/(.*) {
rewrite ^/module/(.*)/(imagens|scripts|styles)/(.*)$ /intranet/\$2/\$3 break;
}
location ~ /module/(.*)/(.*) {
rewrite ^/module/(.*/)(.*intranet/.*)$ /\$2 redirect;
rewrite ^/module/(.*/)(.*index\.php)$ /\$2 redirect;
rewrite ^/module/(.*/)(.*logof\.php)$ /intranet/logof.php redirect;
rewrite ^/module/(.*/)(.*meusdados\.php)$ /intranet/meusdados.php redirect;
rewrite ^/module/(.*/)(.*_xml.*)(\.php)$ /intranet/\$2.php redirect;
rewrite ^/module/(.*/)(.*erro_banco\.php)$ /intranet/erro_banco.php redirect;
rewrite ^/module/(.*/)(.*educar_pesquisa_cliente_lst\.php)$ /intranet/educar_pesquisa_cliente_lst.php redirect;
rewrite ^/module/(.*/)(.*educar_pesquisa_obra_lst\.php)$ /intranet/educar_pesquisa_obra_lst.php redirect;
rewrite ^/module/(.*)$ /module/index.php last;
}
location ~ ^(/intranet.*\.php|/modules.*\.php|/module/) {
rewrite ^(.*)$ /index.php\$1;
}
location ~ \.php {
fastcgi_read_timeout 300;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass php-fpm;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME \$document_root\$fastcgi_script_name;
fastcgi_param PATH_INFO \$fastcgi_path_info;
}
location / {
try_files \$uri \$uri/ /index.php?\$query_string;
}
}
NGINX_IEDUCAR
PASSO 27 - REINICIAR O NGINX
sudo service nginx restart
PASSO 28 - CONFERIR PATH ONDE O i-Educar SERÁ DISPONIBILIZADO, SE NÃO EXITIR, SERÁ CRIADO
[ -d /var/www ] || sudo mkdir -p /var/www
PASSO 29 - EXTRAIR PACOTE DO i-Educar
sudo tar -zxf /tmp/ieducar-$VERSAO_IEDUCAR.tar.gz -C /var/www/
PASSO 30 - MOVER PACOTE DO i-Educar PARA DIRETÓRIO DA WEB SEM O SUFIXO DA VERSÃO
sudo mv /var/www/ieducar-$VERSAO_IEDUCAR /var/www/ieducar
PASSO 31 - AJUSTAR PERMISSÕES DO i-Educar
sudo chown -R $USER:www-data /var/www/ieducar
PASSO 32 - INSTALAR O COMPOSER
cd /tmp
sudo curl -sS https://getcomposer.org/installer -o composer-setup.php
HASH=`curl -sS https://composer.github.io/installer.sig`
sudo php -r "if (hash_file('SHA384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer --version="2.1.5"
PASSO 33 - CONFIGURAR O ARQUIVO DE ENVIROMENT DO i-Educar
sudo cat << ENV > /var/www/ieducar/.env
APP_NAME=i-Educar
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=http://`echo $IP`
APP_TIMEZONE=America/Sao_Paulo
APP_TRACK_ERROR=true
APP_DEFAULT_HOST=`echo $IP`
#
# Logo que fica presente nos relatórios
# O arquivo tem que ficar em /var/www/ieducar/packages/portabilis/i-educar-reports-package/ieducar/ReportLogos
#
REPORTS_LOGO=brasil.png
API_ACCESS_KEY=
API_SECRET_KEY=
LEGACY_CODE=true
LEGACY_DISPLAY_ERRORS=false
LEGACY_PATH=ieducar
LOG_CHANNEL=stack
TELESCOPE_ENABLED=false
DB_CONNECTION=pgsql
DB_HOST=`echo $DB_HOST`
DB_PORT=`echo $DB_PORTA`
DB_DATABASE=`echo $DB_DATABASE_IEDUCAR`
DB_USERNAME=`echo $DB_USUARIO_IEDUCAR`
DB_PASSWORD=`echo $DB_PASSWORD_IEDUCAR`
BROADCAST_DRIVER=log
CACHE_DRIVER=file
QUEUE_CONNECTION=sync
SESSION_DRIVER=file
SESSION_LIFETIME=120
REDIS_HOST=redis
REDIS_PASSWORD=null
REDIS_PORT=6379
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
PUSHER_APP_CLUSTER=mt1
MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
HONEYBADGER_API_KEY=
GOOGLE_TAG_MANAGER=
FILESYSTEM_DRIVER=local
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=
AWS_BUCKET=
MIX_SOCKET_SERVER=127.0.0.1
MIX_SOCKET_PORT=6001
ENV
PASSO 34 - CRIAR DATABASE DO i-Educar
psql -U postgres -c "CREATE ROLE $DB_USUARIO_IEDUCAR WITH LOGIN PASSWORD '$DB_PASSWORD_IEDUCAR';"
psql -U postgres -c "CREATE DATABASE $DB_DATABASE_IEDUCAR OWNER $DB_USUARIO_IEDUCAR"
psql -U postgres -c "ALTER USER $DB_USUARIO_IEDUCAR WITH SUPERUSER;"
PASSO 35 - INSTALAR O i-Educar
cd /var/www/ieducar
sudo yes | composer new-install
sudo php artisan storage:link
PASSO 36 - INSTALAR O PACOTE DE RELATÓRIOS NO i-Educar
cd /var/www/ieducar && sudo rm -rf packages/portabilis/i-educar-reports-package
sudo git clone https://github.com/portabilis/i-educar-reports-package.git packages/portabilis/i-educar-reports-package
sudo yes | composer update-install
sudo php artisan community:reports:link
sudo php artisan reports:install
PASSO 37 - AJUSTAR PERMISSÕES DO i-Educar
sudo chown -R $USER:www-data /var/www/ieducar
PASSO 38 - HABILITAR AUTENTICAÇÃO NO POSTGRESQL
sudo cat << PG_HBA > /etc/postgresql/$POSTGRES_VERSAO/main/pg_hba.conf
# TYPE DATABASE USER CIDR-ADDRESS METHOD
local all postgres peer
local all all peer
host all all all md5
host all all ::1/128 md5
local replication all peer
host replication all 127.0.0.1/32 md5
host replication all ::1/128 md5
PG_HBA
PASSO 39 - REINICIAR O POSTGRES
sudo systemctl restart postgresql
PASSO 40 - CONSULTAR VALORES DE VARIÁREIS UTILIZADAS DURANTE O PROCESSO DE INSTALAÇÃO
OBS. GUARDE OS VALORES APRESENTADOS POR ESSE COMANDO!
sudo cat << INFO > /tmp/info.sh
echo ""
echo "INSTALACAO TERMINADA."
echo " ACESSE: http://`echo $IP`/login"
echo ""
echo "INFORMACOES DE ACESSO AO BANCO DE DADOS"
echo ""
echo " SENHA MESTRE POSTGRES: " `echo $DB_PASSWORD_POSTGRES`
echo ""
echo " HOST: " `echo $DB_HOST`
echo " PORTA: " `echo $DB_PORTA`
echo " DB_DATABASE_IEDUCAR: " `echo $DB_DATABASE_IEDUCAR`
echo " DB_USUARIO_IEDUCAR: " `echo $DB_USUARIO_IEDUCAR`
echo " DB_PASSWORD_IEDUCAR: " `echo $DB_PASSWORD_IEDUCAR`
echo ""
echo "CREDENCIAIS DE ACESSO DO ADMINISTRADOR DO PORTAL i-Educar: "
echo " USUARIO: admin"
echo " SENHA: 123456789"
echo ""
INFO
clear && sudo chmod +x /tmp/info.sh
sudo sh /tmp/info.sh && sudo rm -f /tmp/info.sh