Stoq (Português) - ArchWiki

Jump to content
From ArchWiki

Stoq é uma suíte de gerenciamento empresarial open-source.

O aplicativo Stoq usa o PostgreSQL como banco de dados back-end, com um cliente através de uma interface gráfica.

## Instalação

### Instalação do Stoq

Instale o pacote stoqAUR. A instalação da dependência webkitgtkAUR levará muito tempo no processo de instalação.

### Configuração do Stoq

Após a execução do Stoq pela primeira vez será necessário configurar a localização do banco de dados. Nessa etapa existem duas opções para o cliente se conectar ao banco de dados:

- Conectar no banco de dados localmente;
- Configurar manualmente a conexão com o banco de dados.

#### Conexão com banco de dados local

Para conexão com o banco de dados no local é necessário instalar o postgresql.

Se a instância PostgreSQL ainda não estiver inicializada, consulte PostgreSQL#Initial configuration.

Em seguida, como o root, inicie ou habilite o `postgresql.service`.

Na tela "Localização do banco de dados" utilizar a opção "Eu quero usar o Stoq apenas neste computador".

#### Configurar conexão com banco de dados manualmente

Na tela "Localização do banco de dados" utilizar a opção "Quero configurar a conexão com o banco de dados manualmente" e inserir os dados para a conexão com o banco de dados.

#### Arquivo de configuração do Stoq

O principal arquivo de configurações do Stoq se encontra em `~/.stoq/stoq.conf`.

### Instalação do stoq-server

Instale o pacote stoqserverAUR. Então defina a senha do novo usuário stoqserver.

### Configuração do stoq-server

Se a instância PostgreSQL ainda não estiver inicializada, consulte PostgreSQL#Initial configuration.

Em seguida, como o root, inicie ou habilite o `postgresql.service`.

É necessário criar uma nova configuração no PostgreSQL para o stoq-server. Para isso, entre no usuário padrão para o PostgreSQL, 'postgres', usando os seguintes comandos:

- Se você tiver sudo e seu usuário estiver no `sudoers`:

      $ sudo -u postgres -i

- Senão:

      $ su
      # su -l postgres

Use o script stoqsconf para gerar os arquivos de configurações necessárias:

    [postgres]$ stoqsconf -p 5432 -D "/usr/share/stoqserver"

Onde:

- o `-p` é a porta que o PostgreSQL usa para conexões remotas;
- e `-D` é o diretório que as configurações do stoq-server serão armazenadas.

Retorne ao usuário regular usando `exit`.

Para que o stoq-server seja acessível remotamente é necessário seguir o artigo Configurar o PostgreSQL para ser acessível a partir de hosts remotos.

Como root, inicie ou habilite o `supervisord.service`.

Reinicie o processo do supervisor:

    # supervisorctl update

    # supervisorctl restart stoqserver

#### Arquivo de configuração do stoq-server

O principal arquivo de configurações do stoq-server se encontra em `/usr/share/stoqserver/.stoq/stoq.conf`.

### Acessando via conexão serial

É possível o stoq-server se comunicar via conexão serial ou serial sobre uma conexão USB. Basta adicionar o usuário stoqserver ao grupo `uucp`.

    # gpasswd -a stoqserver uucp

Nota: Você deve deslogar e logar novamente para ter efeito.

## Documentação adicional

Para mais informações, leia a wiki, central de suporte e o manual do Stoq.

Category:

- Office (Português)