Skip to content

Openredu Setup

Jump to bottom Edit New page
João Guilherme Farias Duda edited this page Sep 23, 2016 · 1 revision

Nesta página você encontrará todos os passos necessários para rodar o Redu em sua máquina.

Roteiro

  1. Instalações do ambiente
    1. Ubuntu
    2. Mac OS
    3. Windows
  2. Baixando o código do Redu
  3. Rodando o Redu

Os requisitos necessários são:

  1. Ruby 1.9.3
  2. RubyGems
  3. MySQL
  4. RMagick
  5. Bundler Gem
  6. Git e SSH

#Instalações do ambiente ##Ubuntu

1) Executar comandos no terminal (bash)

$ sudo apt-get install libssl-dev libreadline6-dev zlib1g-dev curl

$ bash -s stable < <(curl -s https://raw.github.com/wayneeseguin/rvm/master/binscripts/rvm-installer) 

$ echo [[ -s "$HOME/.rvm/scripts/rvm" ]] && . "$HOME/.rvm/scripts/rvm" # Load RVM function' >> ~/.bash_profile

$ source .bash_profile

2) Instalar a versão 1.9.3 do ruby com

$ rvm install 1.9.3

$ rvm use 1.9.3

$ rvm --default use 1.9.3

Obs: O RVM vai mostrar um comando no prompt para instalar alguns pacotes de desenvolvimento, copie e cole e aguarde instalar

3) Instalar o MySQL

$ sudo apt-get install mysql-client mysql-server libmysqlclient-dev

4) Instalar o SQLite3 (opcional)

Obs: O SQLite3 é um SGBD portátil. É lento mas bem menos custoso que o MySQL. Geralmente é a opção default quando se gera um projeto rails.

$ sudo apt-get install libsqlite3-dev

4) Instalar o Rails

$ gem install rails --version 3.1.0

Instalação do git

$ sudo apt-get install git-core

Obs: Configurar o git e as chaves SSH de acordo com este tutorial do GitHub

http://github.com/guides/providing-your-ssh-key

Instalando o mongodb

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 7F0CEB10
echo "deb http://downloads-distro.mongodb.org/repo/debian-sysvinit dist 10gen" | sudo tee -a /etc/apt/sources.list
sudo apt-get update
sudo apt-get install mongodb-10gen

Criando um projeto Rails

1) Começar o projeto com os comandos

$ rails new nomedomeuprojeto

$ cd nomedomeuprojeto

$ bundle install

2) Seu projeto já está criado e pode ser iniciado com

$ rails server

Outras referências

Existe também um "one command installer" para Ubuntu, o RailsReady

##Mac OS

Antes de instalar o mysql e imagemagick é necessário instalar o XCode, que já contém o git. Para instalar o XCode, é necessário ter acesso a um AppleID e ir página de download do apple developer.

###1) Instalar Xcode Command Line Tools for Xcode:

$ xcode-select --install

https://developer.apple.com/downloads

###2) RVM RVM é o Ruby enVironment Manager, vai ajudar com as instalações relativas ao Ruby. Para instalar:

$ \curl -sSL https://get.rvm.io | bash

###3) Ruby Cheque sua versão do Ruby com:

$ ruby -v

Se sua versão for diferente do Ruby 1.9.3, instale a versão 1.9.3 do Ruby:

$ rvm install ruby 1.9.3-p551

Use Ruby 1.9.3 como padrão Ruby do seu Mac:

$ rvm --default use 1.9.3

###4) Homebrew Instalar Homebrew, gerenciador de pacotes para Mac OS. Referência para Homebrew: http://brew.sh/

$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

https://raw.githubusercontent.com/Homebrew/install/master/install)

Após instalar o Homebrew, execute os comandos:

$ brew doctor
$ brew update

###5) Instalar o MySQL

$ brew install mysql

###6) Instalar o Rails

$ gem install rails --version 3.1.0

###7) Instalar o MongoDB

$ brew install mongodb

###8) Instalar o bundler

$ sudo gem install bundler

###9) Instalar o sqlite (opcional)

$ brew install sqlite

Obs: O SQLite3 é um SGBD portátil. É lento mas bem menos custoso que o MySQL. Geralmente é a opção default quando se gera um projeto rails.

###10) Problemas com o Ghostscript no Mac Se você estiver tendo erros de validação como abaixo em modelos que utilizam o Paperclip, uma possível solução é instalar o Ghostscript.

A instalação pode ser feita via homebrew:

brew install ghostscript

Caso este procedimento falhe, é possível baixar o binário da versão 8.7 para o MacOSX aqui e instalar da seguinte forma:

tar xzvf ghostscript-8.71-macosx.tar.gz]
cd ghostscript-8.71-macosx
sudo mv gs-8.71-macosx /usr/local/bin/gs

Para realizar este procedimento, certifique-se que não há outra versão do Ghostscript instalada. Execute o comando abaixo e verifique que uma mensagem de erro, dizendo que o comando gs não pode ser encontrado:

gs --version

###11) Instale o Git http://git-scm.com/download/mac

Obs: Configurar o git e as chaves SSH de acordo com este tutorial do GitHub http://github.com/guides/providing-your-ssh-key

##Windows Descrevendo rapidamente a instalação no windows.

Ruby 1.9.3

Para o instalar o ruby na versão certa, é muito simples. Pelo site do RubyInstaller, http://rubyinstaller.org/downloads/, você pode pegar a versão desejada, no nosso caso a Ruby 1.9.3. A instalação é muito simples, na base do next -> next. Recomenda-se instalar o Ruby em uma pasta como C:\Ruby193

Kit de Desenvolvimento

Baixar o DevKit para Ruby 1.9.3 (https://github.com/downloads/oneclick/rubyinstaller/DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe)

Extrair o DevKit para Ruby193\DevKit (Pasta de instalação do Ruby) e executar os comandos:

cd Ruby193\DevKit
ruby dk.rb init
ruby dk.rb install

###Instalando RubyGems Acho que já está incluso no Ruby 1.9.3, depois de instalar o ruby é sempre bom abrir o terminal de ruby e atualizar o gems.

gem update

###Instalando Bundler Gem Este Gem é usado, pois através deste dele todos os Gems utilizados no Redu são instalados automaticamente.

gem install bundler

###Instalando RMagick Baixe o executável ImageMagick-6.7.7-0-Q16-windows-dll.exe (http://ftp.sunet.se/pub/multimedia/graphics/ImageMagick/binaries/).

Esse arquivo contem o ImageMagick e o RMagick compatíveis.

Atenção: você deve instalar o ImageMagick e o gem RMagick A PARTIR DO executável que você acabou de baixar acima, isso mantem a compatibilidade entre eles.

Você terá que instalar o ImageMagick(next->next). De preferencia na pasta C:/ImageMagick

É preciso marcar todas as opções de instalação, com exceção da relacionada com o Perl.

O passo seguinte é instalar a gem RMagick correspondente a versão do ImageMagick:

gem install rmagick --platform=ruby -- --with-opt-lib=c:/ImageMagick/lib --with-opt-include=c:/ImageMagick/include

###Instalando MySQL No site do mysql você encontra um versão cliente para download. É FORTEMENTE RECOMENDÁVEL que você instale uma versão Mysql community server 5.0.x e NÃO a mais recente (5.1.x). Versões antigas podem ser encontradas em: http://olex.openlogic.com/packages/mysql/5.0.83

Instalar versão 32bits com C-connector.

Copiar libmysql.dll da pasta lib/ da instalação do MySQL para pasta bin/ do Ruby 1.9.3

Executar o seguinte comando (obs: o "with-mysql-dir" será o diretório onde o C-connector foi instalado)

gem install mysql2 --platform=ruby -- --with-mysql-dir='"C:\Program Files (x86)\MySQL\MySQL Connector C 6.1"'

###Instalando MongoDB Baixar a versão 32bits do MongoDB (https://fastdl.mongodb.org/win32/mongodb-win32-i386-2.6.5-signed.msi?_ga=1.1738227.392744678.1415209752)

Seguir o tutorial de instalação http://docs.mongodb.org/manual/tutorial/install-mongodb-on-windows/

#Baixando o código do Redu

Caso não tenha o Git, instalar seguindo o seguinte tutorial: https://help.github.com/articles/set-up-git/

##Gerando um par de chaves sshm Para acessar o código do Redu no github, é necessário gerar um par de chaves SSH e cadastrar a chave pública no github. Para gerar o par de chaves, basta executar o código abaixo:

$ ssh-keygen

Após isso, o par de chaves se encontrará em: /home/seu_usuario/.ssh. Você deve pegar a chave pública id_rsa.pub e cadastra-lá em Account Settings > SSH Public Keys.

OBS: Para Windows frequentemente ocorre um problema nesse processo, então seguir o tutorial https://help.github.com/articles/generating-ssh-keys/ para evitar problemas.

##Finalmente baixando o código Basta executar o comando clone do git:

$ git clone [email protected]:OpenRedu/OpenRedu.git

#Rodando o Redu

##Criar arquivo database.yml Inicialmente você deve criar uma base de dados para o Redu. Em seguida, escrever o database.yml, segundo as configurações do seu Banco de Dados. O arquivo database.yml.example, localizado na pasta redu/config, pode ser usado como base. Caso esteja usando o usuário root do MySQL, basta adicionar a senha deste nos campos password. Portanto:

Abra o console e vá para a pasta do projeto. Renomeie o arquivo config/database.yml.example por config/database.yml

##Instalando Gems necessários ao Redu Como foi dito anteriormente, esta tarefa é feita pelo Gem Bundler. Portanto, basta navegar para o diretório raiz do projeto e executar o seguinte comando:

obs.: para evitar erros de conflito de versões, pode ser necessário prefixar ao comando rake o comando bundle exec

###Mac OS

$ gem install rubyzip -v '0.9.9'
$ bundle update therubyracer
$ bundle install

###Windows e Ubuntu

$ bundle install

Se você estiver usando o windows, e o RMagick não estiver funcionando. Faça o seguinte:

  1. Copie o arquivo rmagick-2.12.0-x86-mswin32.gem (baixado de http://rubyforge.org/projects/rmagick/) para a pasta c:\Ruby187\lib\ruby\gems\1.8\cache\ e renomei-o para rmagick-2.12.0.gem (sem "-x86-mswin32")
  2. Copie c:\Ruby187\lib\ruby\gems\1.8\gems\rmagick-2.12.0-x86-mswin32\ para c:\Ruby187\lib\ruby\gems\1.8\gems\rmagick-2.12.0\
  3. Copie c:\Ruby187\lib\ruby\gems\1.8\specifications\rmagick-2.12.0-x86-mswin32.gemspec para c:\Ruby187\lib\ruby\gems\1.8\specifications\rmagick-12.0.gemspec
  4. E edite o arquivo rmagick-2.12.0.gemspec e remova a linha "s.platform = %q{mswin32}"

Se o MYSQL nao estiver funcionando devido ao erro “!!! The bundled mysql.rb driver has been removed from Rails 2.2. Please install the mysql gem and try again: gem install mysql."

siga essas instrucoes: http://www.ninjacoding.net/archive/2010/01/11/the-bundled-mysql.rb-driver-has-been-removed-from-rails.aspx

##Criando as tabelas ###Executar a rake task create para criar os bancos de dados.

$ rake db:create

###Executar a rake task schema load para que todas as tabelas sejam criadas.

$ rake db:schema:load

###Executar a rake task migrate para rodar alguma modificação ainda pendente.

$ rake db:migrate

Você pode executar a rake task migrate antes da rake task schema load caso você tenha problemas com seu load.

##Inicializando os Submodules O Redu ainda utiliza alguns plugins que estão como submodules do git (has_friends por exemplo), então precisamos executar dois comandos:

$ git submodule init
$ git submodule update

##Inserindo dados essenciais no BD Executar a rake task all para que todos os dados necessários sejam inseridos no Banco de Dados.

$ rake bootstrap:all

##Iniciando o servidor Finalmente, basta iniciar o servidor: Iniciar o Mysql ###Inicie o MySQL $ /usr/local/Cellar/mysql/5.6.21/bin/mysql.server stop $ /usr/local/Cellar/mysql/5.6.21/bin/mysql.server start

Referências: * Ubuntu: http://askubuntu.com/questions/82374/how-do-i-start-stop-mysql-server * MacOS: http://osxdaily.com/2014/11/26/start-stop-mysql-commands-mac-os-x/ * Windows: http://dev.mysql.com/doc/refman/5.0/en/windows-start-command-line.html

###Inicie o MongoDB

###Iniciar o servidor de busca solr:

rake sunspot:solr:run

OBS: A execução do servidor de busca necessita da instalação do JAVA ###Iniciar o servidor do Redu:

$ rails s

#Redu is running, let's code! \o/

Add a custom footer
Add a custom sidebar
Clone this wiki locally