Sistema de Gerenciamento de Gêneros Licitados e Não Licitados do CeIMBe
- MySQL 5.7+ (para versões >= 3.0.0)
- wkhtmltopdf 0.12.4 (saiba mais)
- Apache Server 2.4+
- mod_rewrite
- libapache2-mod-php
- PHP 7.0+
- PHP-PDO
- PHP-Common
além das dependências de software, temos as dependências de módulos que devem estar disponíveis nestes softwares.
Para versões anteriores à 3.0.0
clique aqui e acompanhe a documentação correspondente.
Caso você queira migrar de da versão 2.x
para 3.x
, clique aqui antes de prosseguir nesta documentação.
A instalação do sistema pode ser feita seguindo os seguintes passos:
ATENÇÃO: Os passos para instalação descritos nesta documentação, assumem que a aplicação rodará em uma máquina Linux (preferencialmente Ubuntu 16.04 LTS) e que todas a dependências já foram instaladas e configuradas.
- Clonar ou Baixar a ultima versão deste projeto diretamente na
Home
de usuário
$ cd ~/
Caso você tenha optado por baixar o arquivo zipado da ultima versão, descompacte o mesmo e entre no diretório criado por este processo.
$ cd ~/sisgeneros-mb-master
- Após executar o passo anterior, será necessário alterar os valores que correspondem a sua OM no arquivo
~/sisgeneros-mb-master/App/Config/Configurations.php
:
// código omitido
const DOMAIN = 'www.ceimbe.mb';
const ADMIN_CONTACT = 'E-mail: [email protected]';
// código omitido
A constante DOMAIN
deve ser alterada para o domínio da sua OM. Quanto a constante ADMIN_CONTACT
, deve ser alterada para o e-mail do Administrador do sistema.
Também será necessário alterar as informações contidas no arquivo ~/sisgeneros-mb-master/htr.json
. Abra o arquivo htr.json
e altere os valores de acordo com sua necessidade.
- Configuração das credenciais de acesso ao Banco de Dados MySQL
Da versão
3.x
em diante, o SGDB usado é oMySQL
, e para que o sistema possa usá-lo, é necessário alterar algumas entradas no arquivoApp/Config/DatabaseConfig.php
, de acordo com as suas credenciais de acesso. Os valores que devem ser alterados sãoservidor
,usuario
esenha
. Por exemplo, considerando que temos o seguinte cenário:
- sevidor: servermydb.om.mb
- usuario: adminbanco
- senha: $%uPhB#$Sys%*9i3iHTR
então o arquivo App/Config/DatabaseConfig.php
ficaria da seguinte forma:
// código omitido
public $db = [
'servidor' => 'servermydb.om.mb',
'banco' => 'sisgeneros',
'usuario' => 'adminbanco',
'senha' => '$%uPhB#$Sys%*9i3iHTR',
'opcoes' => [\PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES 'utf8'"],
// Altere este campo apenas se for usar a Base de Dados Sqlite
'sqlite' => null
];
// código omitido
- Com as constantes alteradas e o arquivo salvo (e fechado), agora será necessário executar o arquivo
setup.php
:
$ php setup.php
Se tudo ocorrer com sucesso, a seguinte saída deve ser observada no terminal:
$ php setup.php
> Permissões de acesso no diretório de backup de tokens setadas com sucesso
> Token salvo com sucesso
> Chave SALT alterada com sucesso
> Path do Core alterado com sucesso
> Path do autoload alterado com sucesso
> Banco de Dados criado com sucesso
> Dados padrão inseridos com sucesso
> Usuário Administrador alterado com sucesso
> Permissões de acesso no diretório de upload setadas com sucesso
>> Configurações finalizadas
- Após realizar a execução do
setup.php
, crie um diretório com o nomeapp
na raiz do seu site (DocumentRoot do Apache) e copie o diretóriopublic
da raiz do projeto (~/sisgeneros-mb-master/public
) para dentro deste diretórioapp
. Após realizar a cópia para dentro deapp
, renomeiepublic
dentro deapp
parasisgeneros
.
Após realizar todas as configurações descritas acima, já é possível acessar o sistema no browser. O endereço deve parecer com www.suaom.mb/app/sisgeneros.
Por padrão o sistema tem uma conta com nível ADMINISTRADOR
que pode ser acessada para dar início as edições dentro do sistema. Para acessar o sistema basta usar as seguintes credenciais:
usuário: administrador
senha: administrador
No primeiro acesso de todo usuário é necessário fornecer uma outra senha.
Caso haja erro 404, significa que seu apache não foi configurado corretamente. Verifique se o módulo mod_rewrite
está habilitado.
Aqui você pode se basear em como configurar seu servidor HTTP, porém as configurações podem mudar entre versões e distribuições Linux. Aqui estamos tomando como base uma distribuição Ubuntu 16.04 LTS
.
Primeiro deve ser habilitar o módulo mod_rewrite
:
$ sudo a2enmod rewrite
Após a execução, será necessário editar o arquivo /etc/apache2/sites-enabled/000-default.conf
.
$ sudo nano /etc/apache2/sites-enabled/000-default.conf
Procure pelas configuração que apontam para o seu DocumentRoot. Tomando como base DocumentRoot como /var/www/html
:
<Directory /var/www/html/>
# configs omitidas
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
# configs omitidas
</Directory>
Salve o arquivo e reinicie o serviço do Apache Server
$ sudo service apache2 restart
Agora seu servidor já está configurado e a aplicação já pode ser acessada.
A aplicação faz uso de um binário que auxilia na criação de arquivos PDF pela biblioteca knp-snappy
(já presente no sistema para Ubuntu 64-bit). Este binário é o wkhtmltopdf e encontra-se no path ~/sisgeneros-mb-master/vendor/h4cc/wkhtmltopdf-amd64/bin/wkhtmltopdf-amd64
. Será necessário criar um link simbólico dentro de /usr/bin/
.
$ sudo ln -s ~/sisgeneros-mb-master/vendor/h4cc/wkhtmltopdf-amd64/bin/wkhtmltopdf-amd64 /usr/bin/wkhtmltopdf
Esta aplicação foi desenvolvida por Edson B S Monteiro com a participação de Paulo Henrique Coelho Gaia.