Primeiramente vamos instalar na distro
Ubuntu.
1. Caso já o possua instalado e em perfeito estado, pule para os passos seguintes. Caso não possua instalado, efetue a instalação do Ubuntu de preferência versões 7.xx à 8.xx, com ambiente gráfico (desktop).
2. Tenha ou instale o SGBD PostgreSQL, a instalação é bem simples via apt-get, eu prefiro instalar da seguinte forma, que virou para mim uma receita de bolo:
sudo apt-get install postgresql-8.3 postgresql-client-8.3 pgadmin3 php5-pgsql
$ sudo apt-get install phppgadmin
$ sudo ln -s /etc/phppgadmin/apache.conf /etc/apache2/conf.d/phppgadmin.conf
$ sudo vim /usr/share/phppgadmin/conf/config.inc.php
Procure pela linha:
$conf['extra_login_security'] = true;
E altere para:
$conf['extra_login_security'] = false;
Salve o arquivo (:wq) e reinicie o
Apache:
sudo /etc/init.d/apache2 reload
Edite o arquivo
/etc/apache2/conf.d/phppgadmin e descomente a linha:
allow from all
Okay, muitos vão falar que isso prejudica a segurança, mas volto a afirmar, isso é para testes, em produção volte a configuração anterior e implemente a segurança desejada.
3. Configurando banco de dados
Antes, certifique-se de que a versão do PostgreSQL instalada é a 8.1 ou superior.
É importante observar que para o funcionamento correto do
Stoq é necessário que o enconding do banco de dados seja sempre UNICODE.
Note que no lugar de Stoq poderia ser usado o nome do usuário logado em seu sistema. Crie um usuário chamado "stoq" para as aplicações Stoq:
sudo -u postgres createuser stoq -drs -P
Digite a senha do seu usuário:
Password: ******
Depois escolha uma senha nova para o usuário stoq:
Enter password for new role: ******
Enter it again: ******
Obs.: caso a configuração de acesso do seu PostgreSQL seja do tipo confiável, o argumento -P não será necessário e a senha então não será solicitada. O arquivo de configuração do PostgreSQL em geral se encontra em
/etc/postgresql/pg_hba.conf.
Atualização da base de dados:
Para novas versões, pode ser necessária a atualização da base de dados, para isto, somente execute o comando abaixo:
stoqdbadmin updateschema
4. Os demais passos foram seguidos de acordo com as instruções do desenvolvedor do software e nenhum passo foi feito a mais ou a menos, portanto sua informação será mantida de forma integral.
5. Adicionando o repositório:
O primeiro passo para instalar o Stoq é adicionar o repositório oficial à lista de repositórios do Ubuntu.
deb http://download.stoq.com.br/ubuntu ./
Você pode fazer isso de diversas formas diferentes, entre elas:
a. Utilizando o Synaptic:
- Acesse o Synaptic pelo menu Sistema > Administração > Gerenciador de pacotes Synaptic;
- Se solicitado, coloque sua senha;
- Note que o usuário que estiver realizando esses passos deve pertencer ao grupo de administradores;
- Clique no menu configurações e depois em repositórios;
- Na aba Programas de terceiros, clique em Adicionar;
- Copie e cole a linha indicada acima.
b. Utilizando um terminal:
- Logue no sistema como usuário root;
- Adicione a linha indicada acima ao arquivo /etc/apt/sources.list;
- Digite no terminal: sudo apt-get update
Instalando o Stoq
Se você utilizou o Synaptic para adicionar o repositório, já pode procurar pelo Stoq e instalá-lo.
Já se você adicionou o repositório usando um terminal, pode instalar o stoq dessa forma:
sudo apt-get --allow-unauthenticated install stoq
Instalando o servidor o PostgreSQL:
sudo apt-get install postgresql
Observando aqui que o Stoq suporta versões do PostgreSQL iguais ou superiores à versão 8.1.
Veja também as instruções para configurar o postgres.
Autenticando os pacotes:
Se você deseja que os pacotes do Stoq sejam autenticados, precisa executar os comandos abaixo após a instalação:
sudo gpg --keyserver wwwkeys.us.pgp.net --recv-keys 776EF24D
ou
sudo gpg --keyserver subkeys.pgp.net --recv-keys 776EF24D
E por fim:
gpg -a --export 776EF24D | sudo apt-key add -