# $Id$

OP Cloud Connector v.4.4
https://fitosoft.com/webhelp/source/connector.htm

(c) 2019 Fitosoft, Inc. <info@fitosoft.com>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

=============================================================================

OP is a software package for comprehensive print management in small and 
medium-sized companies, schools, colleges and organizations. 
OP enables the control, quota allocation and restriction of printing and 
printer usage. This print management system provides centralized administration over 
all printing resources, printers, paper and toner.

OP Connector allows you to connect to OP server via network.

OP Desktop Connector requires Tea4CUPS and pkpgcounter.

=============================================================================

Installation :
--------------

1. Download OP Cloud Connector from: https://fitosoft.com/downloads/

2. Extract archive
$ tar -zxf op_cloud_connector.tar.gz

3. Open op_desktop_connector directory
$ cd op_cloud_connector

4. Give the shell permission to execute install script 
$ sudo chmod 755 install.sh

5. Run install script
$ sudo ./install.sh

Either from CUPS' web interface, add new printers with
'Tea4CUPS managed' in front of the device's name.

Or by directly modifying CUPS' printers.conf file, or with
the lpadmin command line tool, just prepend each DeviceURI
value with 'tea4cups://'. If you modified printers.conf
directly instead of using lpadmin then don't forget to
restart CUPS.
(Use this last method if autodetection doesn't work because
the version of CUPS you use is too old)

To remove 'tea4cups://' for all printers launch remove_tea4cups.py 

You need to open port 443 (UDP and TCP). This port must be accessible 
from the Internet on the machine running the OP Cloud Connector.
 
================
Troubleshooting:

1. Set "trace = 1" in the [global] section of /etc/cups/op-cloud-connector.conf
2. Print something on a print queue managed by Tea4CUPS.
3. Look at /etc/cups/op_trace.txt file for diagnostic and error messages.
	
==================================================
Please report any problem to the info@fitosoft.com
