Instalação do AMADIS 1.2

Da AMADIS

Revisão das 06h13min de 6 de Agosto de 2006 por Juliano (discussão | contribs)
(dif) ← Revisão anterior | Revisão actual (dif) | Revisão seguinte → (dif)
Peca esboço.gif

'Este artigo é somente um esboço para um artigo maior.
'Quer ajudar o AMADIS? Acrescente alguma informação!

Índice

Requisitos

Para poder funcionar o AMADIS nescessita dos sequintes programas. Mostar como instalá-los vai além do escopo deste artigo. Entretanto uma breve busca no Google resolverá o problema.

  • PHP versão 5.1 ou superior compilado com as bibliotecas GD e Mysql Improved
  • PEAR Log, Date, Mail, Mail_Mime, Calendar
  • Mysql 4.1 ou superior
  • Apache 2.0 ou superior

Instalação

Obtendo o Arquivo

O primeiro passo para instalar o AMADIS é baixar o software para o equipamento onde ele será instalado. Existem dois métodos para isso: baixar o pacote completo contendo todas as dependências ou utilizar o CVS.

O primeiro método é mais simples, bastando baixar um arquivo compactado com todas as bibliotecas que o AMADIS precisa para funcionar. O projeto AMADIS utiliza o site Source Forge para disponibilizar os arquivos. Portanto, para realizar o download do AMADIS 1.2, basta visitar o Site do Projeto no Source Forge. Lá você deve baixar o arquivo amadis_1.2beta_all, optando ou pela versão em .tar.gz ou .zip. Uma vez que o download esteja completo, basta ir para o diretório no qual o AMADIS será instalado e descompactá-lo.

$cd <INSTALL_DIR>
$tar -zxvf amadis_1.2beta_all.tar.gz

ou
> cd <INSTALL_DIR>
> unzip amadis_1.2beta.zip

O segundo método é mais complexo, e consiste em baixar tanto o AMADIS quando o CMDevel utilizando a versão mais atual no CVS. Para tanto, basta executar.

Baixar o AMADIS utilizando o cvs.

 $cvs -d:pserver:anonymous@amadis.cvs.sourceforge.net:/cvsroot/amadis login
 $cvs -z3 -d:pserver:anonymous@amadis.cvs.sourceforge.net:/cvsroot/amadis co -P amadis

Agora deve-se baixar o CMDevel do CVS.

 $cd amadis
 $cvs -d:pserver:anonymous@cmdevel.cvs.sourceforge.net:/cvsroot/cmdevel login 
 $cvs -z3 -d:pserver:anonymous@cmdevel.cvs.sourceforge.net:/cvsroot/cmdevel co -P cmdevel

Deve-se também baixar e descompactar a versão customizada do JPSpan que o AMADIS utiliza.

 $wget http://osdn.dl.sourceforge.net/sourceforge/amadis/amadis_modified_jpspan.tar.gz
 $tar -zxvf amadis_modified_jpspan.tar.gz

Configurando o APACHE

O AMADIS, de forma distinta da maioria dos softwares em PHP, estrutura sua árvore de arquivos de forma que esta não fique totalmente exposta ao servidor Web. Apenas os arquivos que estão na pasta 'ambiente é que devem ficar disponíveis no Document Root do Apache. Esse formato possuí várias vantages, mas a maior delas é evitar que por acidente você deixe disponível na Web as configurações do seu sistema. Existem várias formas de realizar essa configuração.

A forma mais simples é criando um link simbólico. Suponha que o DocumentRoot do Apache é o diretório /var/www.

 $cd /var/www
 $ln -s <AMADIS_INSTALL_DIR>/ambiente/ amadis
 

Esse comando criará um link simbólico possibilitando que o Webserver encontre o AMADIS. Uma outra forma é configurar um Alias na configuração do Apache

 Alias /amadis/ <AMADIS_INSTALL_DIR>/ambiente

E a última é por meio de um VirtualHost. Nesse caso, basta configura o DocumentRoot do virtual host para a instalação do AMADIS.

 DocumentRoot <AMADIS_INSTALL_DIR>/ambiente


Criando um novo Banco de Dados

O passo seguinte é a configuração do banco de dados no Mysql. Você deve criar um novo banco de dados, bem como um usuário e senha no Mysql para que o AMADIS possa acessá-lo. Caso você possua o prompt do Mysql instalado, basta seguir os comandos, não esquecendo de substituir a senha:


$ mysql -u root -p
Enter password: 
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 620 to server version: 4.1.10a-Debian_2-log

Type 'help;' or '\h' for help. Type '\c' to clear the buffer. 

mysql>

mysql> create database amadis;
Query OK, 1 row affected (0.00 sec)

mysql> use mysql;  
Database changed

mysql> grant all privileges on amadis.* to amadisuser@localhost;
Query OK, 0 rows affected (0.01 sec)

mysql> set password for amadisuser@localhost = PASSWORD('your_password');
Query OK, 0 rows affected (0.02 sec)

Editando o arquivo de Configuração

O AMADIS possuí um arquivo de configuração que deve ser customizado para sua instalação:

$cd etc
$cp config.xml.def  config.xml

O arquivo config.xml deve ser editado preenchendo no mínimo as seções urls, paths, database com os dados relativos ao seu site de instalação.

Na parte de urls você deve substituir a string COMPLETE_YOUR_URL_HERE com a URL onde o AMADIS ficará disponível. Na seção paths você deve substituir a url PATH_TO_AMADIS com o caminho absoluto onde o AMADIS está instalado. Já na seção database você deve preencher os campos com os dados relacionados com o seu servidor Mysql, incluindo o nome do banco de dados, o usuário e a senha. Para os dados que utilizamos acima para criar o banco de dados, essa seção ficaria assim.

   <database>
     <driver>mysqli</driver>
     <host>localhost</host>
     <user>amadisuser</user>
     <password>your_password</password>
     <name>amadis</name>
   </database>


Executando o Configurador

Uma vez que o arquivo config.xml encontre-se configurado, basta executar o instalador do AMADIS o qual se encarregará de terminar as configurações e testar o site. Para tanto, acesse pelo browser a URL, http://your_amadis_url/install.php.

Checking the permissions of your filesystem.
Testing writing privileges in the Thumbnails dir...OK
Testing writing privileges in the User pages dir...OK
Testing writing privileges in the Project Pages dir...OK
Connectiong to the Mysql Server...OK
Creating database tables...OK
Inserting images on database...1, 2, 3, OK
Images successfuly inserted
AMADIS was successfuly installed.

Caso todas as operações sejam executadas corretamente, deve-se observar na tela as confirmações acima. Caso algum erro aconteça, o instalador lhe informará o erro.Uma vez que a instalação tenha sido concluída com sucesso, basta cadastrar-se e começar a utilizar o ambiente.

Deixando sua Instalação Segura

Um passo importante para evitar problemas com sua instalação é remover o diretório ambiente/install. Ele é descessário, uma vez que a plataforma esteja configurada.

Obtendo Suporte

Para obter suporte, pode-se recorrer aos fóruns, listas ou aos pedidos de suporte do projeto AMADIS disponíveis no Source Forge. Para tanto, basta visitar o site do Projeto AMADIS no Source Forge.

Ferramentas pessoais
Parceiros
















SourceForge.net Logo

Supported by Cenqua