Changeset 94 for pykoticon/trunk/README

Show
Ignore:
Timestamp:
01/27/06 09:55:03 (19 years ago)
Author:
jerome
Message:

Installation instructions

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • pykoticon/trunk/README

    r89 r94  
    2020==================================================================== 
    2121 
    22 PyKotIcon is a cross-platform client-side print quota monitor for PyKota. 
     22PyKotIcon is a cross-platform client-side helper for PyKota. 
    2323 
    2424It is meant to be launched whenever the user logs in, and stay in  
     
    3030least one printer. 
    3131 
    32 When the user clicks (or double-clicks, depending on the client operating 
    33 system) on the icon, a table is displayed showing how many pages the 
    34 user has printed on each printer, as well as if he can still print or not, 
    35 and if is PyKota account is limited by a number of credits, the number 
    36 of credits remaining in his account is displayed. 
    37  
    3832INSTALLATION : 
    3933-------------- 
    4034 
    41   1 - On a web server : 
     35on the client : 
     36 
     37  $ python setup.py install 
     38  $ pykoticon pykota_server_ip_address local_tcp_port 
    4239   
    43       The first thing to do is to configure a web server to serve 
    44       PyKota's dumpykota.cgi CGI script. The best place to do so 
    45       is on the print server itself, but for performance reasons 
    46       you may prefer installing it elsewhere. 
    47        
    48       When installing, you have to ensure that the dumpykota.cgi 
    49       script will be able to read PyKota's configuration and to 
    50       access to PyKota's database, whatever it is, as a PyKota 
    51       administrator. Please refer to PyKota's documentaton for 
    52       details on how to do this. 
    53        
    54       You can protect access to this CGI script with a username 
    55       and password if you want. Please refer to your web server's 
    56       documentation for details on how to do this. 
    57        
    58   2 - On each client : 
     40on the pykota server : 
     41 
     42  $ ./tests/tests.py client_ip_address client_tcp_port 
    5943   
    60       Execute (double-click) on PyKotIcon's installation program,  
    61       and the software will install itself onto the local hard disk. 
    62        
    63       The installation procedure will ask you for the full URL to 
    64       dumpykota.cgi which should be installed and working on a 
    65       web server, accessible from the current computer. For example 
    66       enter : 
    67        
    68         http://printserver.example.com/cgi-bin/dumpykota.cgi 
    69          
    70       Then the insallation procedure will ask you to enter an optional 
    71       username and password, in the case the access to dumpykota.cgi 
    72       is protected. Just leave the fields blank if access is unrestricted, 
    73       else type in the correct username and password. 
    74        
    75   3 - You can now execute the pykoticon software. A good place to put 
    76       it under MS Windows is in the Startup folder, or in a netlogon 
    77       script. Under GNU/Linux and similar system, you can put a 
    78       command line to pykoticon in your ~/.Xsession file or configure 
    79       your desktop environment to automatically start it when opening 
    80       the session. 
    81        
     44NB : You need wxPython for PyKotIcon to work.   
     45   
     46NB2 : Don't expect too much yet ! This release is for developpers only.   
     47   
    8248==================================================================== 
    8349