Gerência de Quotas de Impressão com CUPS e Pykota

Transcrição

1 Gerência de Quotas de Impressão com CUPS e Pykota Projeto LibertasBR 16 de junho de 2005 Direcionado para administradores de laboratórios de informática, este documento tem como objetivo explicar a instalação e o funcionamento do aplicativo Pykota junto a um gerente de impressão e uma base de dados (CUPS e LDAP respectivamente). O Pykota é um aplicativo que gerencia as quotas de impressão do CUPS por preço ou por número de páginas. Neste manual, o pykota será instalado e configurado para gerenciar as cotas das impressoras por preço de página. 1 Obtenção do Aplicativo Pykota É possível obter o aplicativo pykota diretamente através do sistema de controle de versão (CVS) ou comprando pacotes para seu sistema. Para obter os pacotes pagos do aplicativo, você pode acessar a página: E para obter diretamente do CVS, você deve ter o serviço de CVS instalado e seguir o procedimento a seguir: ˆ Escolha ou crie um diretório para o arquivo ser baixado. ˆ Digite o comando a seguir para adicionar o meio de acesso ao CVS na variável de sistema correspondente: export CVS RSH= ssh ˆ Digite o comando a seguir para baixar o arquivo como anônimo: cvs -z3 -d:ext:anoncvs@savannah.nongnu.org:/cvsroot/pykota co pykota 1

2 2 Requisitos de Sistema Para o funcionamento do pykota você deverá ter os seguintes serviços devidamente instalados e configurados: ˆ Serviço de diretório e autenticação LDAP. Serão necessárias informações sobre o servidor deste, além de liberdade para adição de informações na base de dados. ˆ Serviço de Impressão CUPS. Será necessário liberdade para modificação ou instalação de novos dispositivos de impressão. Além desses seviços, alguns pacotes são necessários para a instalação do Pykota. São eles: ˆ Python v2.1 ou superior ˆ Módulo Python egenix mxdatetime ˆ Módulo Python-JAXML ˆ Módulo Python-SNMP ˆ Módulo Python-OSD ˆ Módulo Python-PSYCO ˆ Ferramentas SNMP ˆ Netatalk ˆ Módulo Python-LDAP Os pacotes acima podem ser obtidos através do repositório apt, a não ser o módulo Python- SNMP que deve ser obtido de uma URL específica, e para isso é aconselhável o uso do programa wget. Este pacote, entretanto, não é obrigatório. Neste manual trataremos mensagens de impressão por software. Satisfeitas as condições basta executar os seguintes comandos: aptitude install python2.3 python2.3-egenix-mxdatetime python2.3-osd \ 1 python2.3-psyco python2.3-ldap apt-get install snmp netatalk jaxml wget tar -zxvf pysnmp tar.gz cd pysnmp python setup.py install 1 Este comando deve ser executado numa única linha; a \, neste caso, indica apenas a quebra da linha e não deve ser utilizada na execução do comando. 2

3 3 Instalação do aplicativo Tendo todos os aplicativos acima devidamente instalados, você deve seguir o procedimento abaixo para instalar o Pykota: ˆ Entre no diretório onde você baixou o arquivo do CVS. ˆ Descomprima o arquivo com o comando: tar -zxvf [nome do arquivo] ˆ Entre no diretório criado: cd [nome do diretório] ˆ Execute o Script de instalação com o seguinte comando: python setup.py install ˆ Serão feitas algumas perguntas no processo. Você pode responder sim <Y> para todas elas e o processo de instalação será encerrado. ˆ Copie o arquivo pykota.schema do diretório [diretorio pykota]/initscripts/ldap/ para o diretório /etc/ldap/schema, utilizando o comando: cp [diretorio pykota]/initscripts/ldap/pykota.schema /etc/ldap/schema ˆ Reinicie o servico LDAP para as alterações fazerem efeito: /etc/init.d/slapd restart 4 Criação da base de dados Pykota no LDAP Esta seção indicará como se deve criar a base de dados do Pykota no LDAP, assim como usuários especiais para acessar esta base. Os exemplos citados nesta seção utilizam como base as configurações de LDAP do servidor LibertasBR, as entradas devem, portanto, ser alteradas de acordo com seu servidor. A primeira coisa a fazer é iniciar a base de dados do Pykota. Para isso você deve ter acesso ao seu servidor LDAP e permissões para a criação de entradas na base de dados. Abaixo é mostrado um exemplo de como deve ser esta base de dados: dn: ou=pykota,dc=libertasbr,dc=org,dc=br ou: PyKota 3

4 dn: ou=impressoras,ou=pykota,dc=libertasbr,dc=org,dc=br ou: Impressoras dn: ou=uquotas,ou=pykota,dc=libertasbr,dc=org,dc=br ou: UQuotas dn: ou=gquotas,ou=pykota,dc=libertasbr,dc=org,dc=br ou: GQuotas dn: ou=jobs,ou=pykota,dc=libertasbr,dc=org,dc=br ou: Jobs dn: ou=lastjobs,ou=pykota,dc=libertasbr,dc=org,dc=br ou: LastJobs Para adicionar estas entradas, copie o conteúdo acima para um arquivo chamado pykota.ldif e adicione este arquivo à base de dados com o seguinte comando: ldapadd -f pykota.ldif -x -W -D [usuário administrativo] Agora será necessária a adição de usuários para manipular essa base de dados. Os usuários devem ter os seguintes atributos: dn: cn=pykotauser,dc=libertasbr,dc=org,dc=br cn: pykotauser objectclass: simplesecurityobject objectclass: organizationalrole description: Usuario do PyKota userpassword: {CRYPT}us6EKZMmfBVwI dn: cn=pykotaadmin,dc=libertasbr,dc=org,dc=br cn: pykotaadmin objectclass: simplesecurityobject objectclass: organizationalrole description: Administrador do PyKota userpassword: {CRYPT}usKrzwzEa4ibs Para adicionar estes usuários, copie o conteúdo acima para um arquivo chamado usuarios.ldif e adicione este arquivo à base de dados com o seguinte comando: 4

5 ldapadd -f usuarios.ldif -x -W -D [usuário administrativo] Para dar as devidas permissões para estes usuários, é necessário alterar o arquivo: /etc/ldap/slapd.conf. Devem ser inseridas duas linhas adicionais na seção access to *. Essas linhas devem ser as seguintes: by dn="cn=pykotaadmin,dc=libertasbr,dc=org,dc=br" write by dn="cn=pykotauser,dc=libertasbr,dc=org,dc=br" read Observações: ˆ Estas configurações não são obrigatórias, mas facilitam a instalação e melhoram o serviço. ˆ Não esqueça de mudar as entradas para serem compatíveis com seu servidor LDAP. 5 Arquivos de Configuração do Pykota Agora você deve configurar seu pykota de acordo com as características de seus servidores CUPS e LDAP. O arquivo de configuração geral a ser editado é o /etc/pykota/pykota.conf. Abaixo estão dispostas as linhas alteradas com os valores corretos de acordo com as configurações citadas anteriormente. Altere os devidos campos com as configurações específicas de seus servidores. the postgresql value is deprecated, use pgstorage instead. storagebackend: pgstorage Quota Storage Server hostname (and optional port) e.g. db.example.com:5432 storageserver: localhost name of the Quota Storage Database storagename: pykota Quota Storage normal user s name and password These two fields contain a username and optional password which may give readonly access to your print quota database. PLEASE ENSURE THAT THIS USER CAN T WRITE TO YOUR PRINT QUOTA DATABASE, OTHERWISE ANY USER WHO COULD READ THIS CONFIGURATION FILE COULD CHANGE HIS PRINT QUOTA. 5

6 storageuser: pykotauser storageuserpw: Comment out if unused, or set to Quota Storage user password LDAP example, uncomment and adapt it to your own configuration : storagebackend: ldapstorage storageserver: ldap:// :389 storagename: dc=libertasbr,dc=org,dc=br storageuser: cn=pykotauser,dc=libertasbr,dc=org,dc=br storageuserpw: [sua senha] Here we define some helpers to know where to plug into an existing LDAP directory userbase: ou=usuarios,dc=libertasbr,dc=org,dc=br userrdn: uid balancebase: ou=usuarios,dc=libertasbr,dc=org,dc=br balancerdn: uid groupbase: ou=grupos,dc=libertasbr,dc=org,dc=br grouprdn: cn printerbase: ou=impressoras,ou=pykota,dc=libertasbr,dc=org,dc=br printerrdn: cn jobbase: ou=jobs,ou=pykota,dc=libertasbr,dc=org,dc=br userquotabase: ou=uquotas,ou=pykota,dc=libertasbr,dc=org,dc=br groupquotabase: ou=gquotas,ou=pykota,dc=libertasbr,dc=org,dc=br lastjobbase: ou=lastjobs,ou=pykota,dc=libertasbr,dc=org,dc=br... a possible value: newuser: attach(posixaccount, warn) newuser: attach(posixaccount, warn) newgroup: attach(posixgroup, warn) LDAP attribute which stores the user s address usermail : mail Choose what attribute contains the list of group members common values are : memberuid, uniquemember, member groupmembers: memberuid... O restante do arquivo trata de dados de serviço de mensagens e que não serão tratados neste texto. 6

7 Outro arquivo que deve ser alterado é o arquivo /etc/pykota/pykotadmin. Ele deve ser alterado para a seguinte forma: [global] Quota Storage administrator s name and password storageadmin: cn=pykotaadmin,dc=libertasbr,dc=org,dc=br storageadminpw: [sua senha] Observação: É necessária a alteração dos dados de acordo com seu servidor LDAP. 6 Adicionar Impressora com suporte a Pykota O primeiro passo é adicionar um novo backend para o CUPS poder utilizar o pykota. Para fazê-lo, execute os seguintes comandos: cd /usr/lib/cups/backend ln -s /usr/share/pykota/cupspykota cupspykota /etc/init.d/cupsys restart Agora o CUPS já é capaz de enxergar dispositivos para utilizar o pykota. O próximo passo é adicionar uma impressora para o uso do pykota, ou então modificar uma impressora existente para suportar o pykota. Para fazer isso, basta você seguir os procedimentos indicados pelo seu manual de instalação de impressoras padrão, tomando cuidado apenas para escolher o dispositivo a ser utilizado pela impressora, que deve ser precedido de Pykota managed. Veja a figura a baixo: 7 Comandos Basicos Agora o seu sistema de quotas de impressão está pronto para o uso. A primeira tarefa a ser feita é popular a base de dados com as impressoras e usuários do pykota. Para adiconar uma impressora ao sistema de quotas você pode utilizar o comando pkprinters. O exemplo abaixo adiciona a impressora impressora1 com o custo de 0.05 por folha. pkprinters add charge 0.05 impressora1 Para adicionar usuários que possam utilizar esta impressora, você deve utilizar o comando edpykota. O exemplo abaixo adiciona os usuários Jose e Joao à impressora1 com um balanço (saldo) de 10 unidades: edpykota add -P impressora1 limitby balance balance 10 Jose Joao Para ver as quotas de impressão dos usuários, você pode utilizar o comando repykota. exemplo abaixo mostra a quota de impressão de todos os usuários da impressora1: O 7

8 Figura 1: Exemplo do dispositivo da impressora repykota printer impressora1 Para maiores informações sobre como utilizar estes comandos, basta consultar suas respectivas páginas de manual 2. 2 execute man [nome do comando] para acessar tais páginas 8

9 A Créditos Documento Gerência de Quotas de Impressão com CUPS e Pykota Direitos Autorais Reservados (c) Universidade Federal de Minas Gerais Departamento de Ciência da Computação Projeto LibertasBR Marcus Flávio de Lima - mflima@dcc.ufmg.br Esta documentação é livre; você pode redistribuí-la e/ou modificá-la sob os termos da Licença Pública Geral GNU conforme publicada pela Free Software Foundation; tanto na sua versão 2, como qualquer versão posterior (a seu critério). A distribuição desta documentação é feita na expectativa de que ela seja útil, porém, sem nenhuma garantia; nem mesmo a garantia implícita de comerciabilidade ou adequação a uma finalidade específica. Consulte a Licença Pública Geral do GNU para mais detalhes