Introdução

A seguir serão exibidas informações sobre a instalação do SWControl em ambiente de produção usando Windows de 32 Bit.
O SWControl é um software de gerenciamento de projetos desenvolvido usando Ruby on Rails e banco de dados MySQL.
Nessa página não será exibido detalhes sobre a instalação do Apache e do MySQL, será exibida somente questões de configuração.

Requisitos

Para a instalação do SWControl em ambiente de produção são necessários os seguintes items:

Preparação do Ambiente

Após baixar os arquivos do SWControl, que estão aqui, descompacta-los em uma pasta como por exemplo
em C:\ (Os arquivos ficarão em C:\swcontrol).

Como requisito inicial deve ser instalado o Apache 2.2 e o MySQL 5.1.
Após a instalação do MySQL deve ser criado a estrutura de dados necessárias para a execução do sistema.
Para a construção da base de dados pode ser seguido os seguintes passos:

  1. Instalação do Apache
  2. Instalação do MySQL
  3. Criação do Banco de Dados
    Abrir o prompt de comando de acessar a pasta onde estão os scripts do banco de dados:
    C:\>cd swcontrol\database

    Acessar a ferramenta para execução de scripts:
    C:\swcontrol\database>mysql -u root -p

    Executar os scripts necessários para a configuração completa do banco de dados:
    mysql> create database swcontrol;
    mysql> use swcontrol;
    mysql> source complete-create.sql
    mysql> source swcontrol_0001.sql
    mysql> source swcontrol_0002.sql
    mysql> source swcontrol_0003.sql
    mysql> source swcontrol_0004.sql
    mysql> source swcontrol_0005.sql
    mysql> source complete-inserts.sql

  4. Configuração do SWControl
    Editar o arquivo database.yml que está em src\config:
    production:
      adapter: mysql
      database: swcontrol
      username: -- usuário --
      password: -- senha --
      host: localhost

Instalação do Ruby on Rails

A instalação do Ruby on Rails pode ser feita usando o InstantRails apenas
descompactando em alguma pasta como exemplo C:\InstantRails.
Após a descompactação executar o InstantRails.exe contido na pasta para que atualize
os seus arquivos de configuração. Após a execução, o InstantRails pode ser fechado.

Adicionar o FastCGI no Apache e outras configurações

Para a execução em ambiente de produção é correto a utilização do módulo
FastCGI juntamente com o Apache para obter a performance desejada.
Os procedimentos para a configuração é:

  1. Fazer o download do FastCGI clicando aqui.
  2. Descompactar o arquivo mod_fcgid.so dentro da pasta modules do Apache.
  3. Editar o arquivo de configuração do Apache httpd.conf:
    Descomentar a seguinte configuração:
    LoadModule rewrite_module modules/mod_rewrite.so

    Adicionar a configuração para carregar o FastCGI:
    LoadModule fcgid_module modules/mod_fcgid.so

    Adicionar a configuração para criação do Virtual Host para o SWControl:
    <VirtualHost *:80>
    	ServerName localhost
    	DocumentRoot "C:/swcontrol/src/public"
    	DefaultInitEnv RAILS_ENV "production"
    	
    	DefaultInitEnv PATH "C:/WINDOWS/system32;C:/WINDOWS;C:/WINDOWS/System32/Wbem;"
    	DefaultInitEnv SystemRoot "C:/WINDOWS"
    	DefaultInitEnv SystemDrive "C:"
    	DefaultInitEnv TEMP "C:/WINDOWS/TEMP"
    	DefaultInitEnv TMP "C:/WINDOWS/TEMP"
    	DefaultInitEnv windir "C:/WINDOWS"
    	
    	<Directory "C:/swcontrol/src/public">
    	    Options ExecCGI FollowSymLinks
    		AllowOverride None
    	    Order allow,deny
    	    Allow from all
    
    	    AddHandler fcgid-script .fcgi
    	    FCGIWrapper "C:/InstantRails/ruby/bin/ruby.exe C:/swcontrol/src/public/dispatch.fcgi" .fcgi
    
    	    RewriteEngine On
    	    RewriteRule ^$ index.html [QSA]
    	    RewriteRule ^([^.]+)$ $1.html [QSA]
    	    RewriteCond %{REQUEST_FILENAME} !-f
    	    RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]
    	</Directory>
    </VirtualHost>

  4. Reiniciar ou Iniciar o Apache

Considerações Finais

Após os procedimentos descritos acima o SWControl poderá ser acessado usando o
endereço local (http://localhost/) com o usuário admin e a senha também admin.
As configurações de envio de emails pode ser feita alterando a tabela parametros
que está presente no banco de dados do SWControl.




SWControl - Sistema de Gerenciamento de Projetos - 2010