== Installing eCUPS - a Visual Step by Step Guide ==

This was originally part of the [HowTo HOWTO].  It has been moved to its own page as the screenshots are rather out of date, and the HOWTO now includes more up-to-date ones.  However, it still may be useful for people.

'''Note:''' The CUPS screenshots below were taken from version 1.3.9, hence the significant difference in appearance from 1.4.''x''.  The CUPS port driver screenshots are also from an older version, and may appear slightly different from the current release.

Screenshots and text originally provided by Ed Durrant.  You will notice that one or two things are done slightly different from the description in the HOWTO - for instance, in this example the 'regular' (or non-Simplified) driver for the printer is used, which leads to many more options being offered in the printer configuration.

[[BR]]
[[BR]]


[=#visual]
=== Step by step visual CUPS printer setup in web admin program (USB or Network connected) ===

First of all start your web browser and point it at http://localhost:631/ 

[[BR]]

[[Image(http://farm4.static.flickr.com/3577/3436643257_e38665d10e_o_d.jpg)]]

Now click on the administration tab

[[BR]]

[[Image(http://farm4.static.flickr.com/3569/3437450528_7126c08836_o_d.jpg)]]

Then click on "Find new printers"

[[BR]]
 
[[Image(http://farm4.static.flickr.com/3319/3437450648_2dbf894e9e_o_d.jpg)]]

In this case, as my printer is both connected to the network and connected by a USB cable to my PC, both connections are listed - select whichever you wish to set up at this point.

[[BR]]

[[Image(http://farm4.static.flickr.com/3590/3437450750_db6dd2236d_o_d.jpg)]]

A description is already filled in for you, but feel free to change the text as you wish.

[[BR]]

[[Image(http://farm4.static.flickr.com/3341/3437450840_e744988fd1_o_d.jpg)]]

Select the correct printer driver - in my case as my Officejet 6310 is not listed I use the OJ 7110 instead - I have found this works fine (you can always change this later to find the best match for your printer).

[[BR]]

[[Image(http://farm4.static.flickr.com/3602/3437451142_de474f285a_o_d.jpg)]]

Set up the default printer options that you want to use.

[[BR]]

[[Image(http://farm4.static.flickr.com/3647/3437451248_429e9dca10_o_d.jpg)]]

That's it ! You have now set up your printer under CUPS - press the send test page and hopefully you'll get a nice printout.
The next stage is now to set up the OS/2 print object to print to the CUPS Daemon - see those details later in this documentation.

[[BR]]
[[BR]]

[=#obj_visual]
=== Step by step visual OS2 printer object setup for a CUPS attached printer ===

Open the printer folder and click on add printer:

[[Image(http://farm4.static.flickr.com/3337/3436989266_00fa9c70df_o_d.jpg)]] [[BR]]

Select local printer.

[[BR]]

[[Image(http://farm4.static.flickr.com/3323/3436183577_17d281496c_o_d.jpg)]] [[BR]]

Click on install printer driver, click on "other printer driver location" and type in where you put the eCUPS printer driver (I suggested \OS2\DLL\CUPS earlier) - then press the refresh key. all the printers in the CUPS file will now appear, scroll down and select the printer driver for your printer (or a near model), and press Install.

[[BR]]


[[Image(http://farm4.static.flickr.com/3611/3436183847_1e8abb9473_o_d.jpg)]] [[BR]]

Press OK to load the driver. Now change the printer name field to something reasonable from "printer" that is currently in the field and press the create key and your printer object will be created and the install dialog will close (but you haven't finished yet ....).

[[BR]]

[[Image(http://farm4.static.flickr.com/3654/3436990144_d857519403_o_d.jpg)]] [[BR]]

Open the properties of your new printer object and select the "printer driver" tab, make sure the new driver is highlighted in both boxes.

You can press the job properties button as this point if you wish but you'll find the settings are the same as you set when you created the printer in the CUPS admin webpage. If you look at the properties of the Printer driver you can also set some printer parameters. In general I leave these areas as they are.

[[BR]]

Now press on the "output port" tab and press install new port:

[[Image(http://farm4.static.flickr.com/3656/3436184471_40b82f348f_o_d.jpg)]] [[BR]]

Because you put the eCUPS Port Driver into OS2\DLL earlier, you will now get a whole lot of CUPS drivers to chose from - simply highlight CUPS1 and press "Install".

[[BR]]

[[Image(http://farm4.static.flickr.com/3384/3436184959_519033b50d_o_d.jpg)]] [[BR]]

Double click the new port driver and you will get its configuration panel - this is where we link the OS/2 print system to the CUPS print system! - The first field says "localhost" we will leave that as it is as the printer is connected to this PC - if it was connected to CUPS running on another PC, you could put that PCs IP address or hostname in here. What is important is the second field - this is the name of the printer within the CUPS configuration - you'll see I have loaded up the CUPS web admin page in manage printer to show you this - in this case the name is "HP_Officejet_6300_series". Press "save properties" and close the printer setup panels and you are finished. 

Just to prove this ....

[[Image(http://farm4.static.flickr.com/3647/3436990894_36f0ae82b6_o_d.jpg)]] [[BR]]

Here is the printer dialog in Firefox with the new CUPS connected printer available to print the same as any other OS/2 printer !

[[BR]]
[[BR]]