Difference between revisions of "Cups"

From Amahi Wiki
Jump to: navigation, search
 
(27 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This will add the cups printing system to a existing hda installation.
+
<br />
 +
The [http://www.amahi.org/apps/cups CUPS] web application is currently in Testing for Amahi 7 or greater.  This guide is incomplete, but when finished will allow manual adding the cups printing system to a existing HDA installation.
 
=== Initial system setup ===
 
=== Initial system setup ===
 
Check to see if cups is installed already. It quite often is if you installed Gnome or any other programs that might have printer support.
 
Check to see if cups is installed already. It quite often is if you installed Gnome or any other programs that might have printer support.
Line 7: Line 8:
 
     yum -y install cups
 
     yum -y install cups
 
=== Configure cups for remote access ===
 
=== Configure cups for remote access ===
Install links for local access to the Cups configuration website, or use whatever web browser you have if you have X installed.
+
Install links for local access to the cups configuration website, or use whatever web browser you have if you have X installed.
 
     yum -y install links
 
     yum -y install links
 
Navigate to the Links configuration page
 
Navigate to the Links configuration page
Quick cheatsheet for links:
+
Quick cheatsheet for links:
 
  Left and Right arrows go forward and backward on pages.
 
  Left and Right arrows go forward and backward on pages.
 
  Up and Down arrows move from one link to another
 
  Up and Down arrows move from one link to another
 
  SpaceBar goes down 1 page.
 
  SpaceBar goes down 1 page.
 
  Enter is the same as clicking a link, or puts a check in a box.
 
  Enter is the same as clicking a link, or puts a check in a box.
     links http://localhost:631
+
     links <nowiki>http://localhost:631</nowiki>
== Once in links ==
 
#goto Administration
 
Hit down arrow until on "Administration" then hit enter
 
#goto Allow Remote Administration
 
Hit down until the checkbox next to remote admin is highlit, then press enter
 
#"click" Save Changes
 
Hit down until "Save Changes" is highlit, and press enter
 
  
 +
=== Once in links ===
 +
#Hit down arrow until on "Administration" then hit enter
 +
#Hit down until the checkbox next to Allow Remote Administration is highlit, then press enter
 +
#Hit down until "Save Changes" or "change settings" is highlighted, and press enter
 +
#When asked for username and password use "root" and "yourownHDApassword" which was set while installing your hda. It seems that only user "root" save changes.
 +
#Press q to exit after changes are saved.
  
 +
=== Creating the webapp ===
 +
#Go to the apps on the dashboard and install Webapps if not installed already
 +
#Open the HDA Webapps configuration page
 +
#Create a new webapp named cups
 +
 +
=== Creating the Webapp Redirect ===
 +
Edit the config-file using a editor like "nano". Perhaps you have to install it first:
 +
    su -
 +
    yum -y install nano
 +
Now you can edit cups
 +
    su -
 +
    nano /etc/httpd/conf.d/*cups.conf
 +
Go down to line 5, and add this:
 +
    ProxyPass / <nowiki>http://localhost:631/</nowiki>
 +
    ProxyPassReverse / <nowiki>http://localhost:631/</nowiki>
 +
Press CTRL+X to exit and save.
 +
 +
== It should look like this ==
 +
<br/> 
 +
<pre> <VirtualHost *:80>
 +
     
 +
              ServerName cups
 +
              ServerAlias cups.yourdomain.net
 +
     
 +
     
 +
     
 +
              ProxyPass / http://localhost:631/
 +
              ProxyPassReverse / http://localhost:631/
 +
   
 +
              DocumentRoot /var/hda/web-apps/cups/html
 +
   
 +
              <Directory "/var/hda/web-apps/cups/html">
 +
              Options Indexes FollowSymLinks MultiViews
 +
              AllowOverride AuthConfig
 +
              Require all granted
 +
   
 +
              </Directory>
 +
   
 +
              ErrorLog  /var/hda/web-apps/cups/logs/error_log
 +
              CustomLog /var/hda/web-apps/cups/logs/access_log combined env=!d
 +
   
 +
      </VirtualHost>
 +
</pre>
 +
=== Restart httpd ===
 +
check that /var/hda/web-apps/cups/logs exists and is owned by apache:users
 +
Then restart httpd.
 +
 +
    systemctl restart httpd.service
 +
 +
=== Testing ===
 +
Go to a system on your network, and try going to <nowiki>http://cups</nowiki>
  
=== Creating the webapp ===
+
If you have problems connecting to the CUPS web UI, it may be because your DNS Server is not set correctly. Try using IP address in your browser:
# Open the HDA Webapps configuration page
+
<nowiki>http://IP_ADDRESS:631</nowiki> (replace IP_ADDRESS with your HDA IP address)
    http://hda/setup?sub=webapps&tab=app
 

Latest revision as of 01:07, 25 March 2016


The CUPS web application is currently in Testing for Amahi 7 or greater. This guide is incomplete, but when finished will allow manual adding the cups printing system to a existing HDA installation.

Initial system setup

Check to see if cups is installed already. It quite often is if you installed Gnome or any other programs that might have printer support.

   su -
   rpm -qa |grep cups

If you see cups, then you don't need the next line.

   yum -y install cups

Configure cups for remote access

Install links for local access to the cups configuration website, or use whatever web browser you have if you have X installed.

   yum -y install links

Navigate to the Links configuration page

Quick cheatsheet for links:
Left and Right arrows go forward and backward on pages.
Up and Down arrows move from one link to another
SpaceBar goes down 1 page.
Enter is the same as clicking a link, or puts a check in a box.
   links http://localhost:631

Once in links

  1. Hit down arrow until on "Administration" then hit enter
  2. Hit down until the checkbox next to Allow Remote Administration is highlit, then press enter
  3. Hit down until "Save Changes" or "change settings" is highlighted, and press enter
  4. When asked for username and password use "root" and "yourownHDApassword" which was set while installing your hda. It seems that only user "root" save changes.
  5. Press q to exit after changes are saved.

Creating the webapp

  1. Go to the apps on the dashboard and install Webapps if not installed already
  2. Open the HDA Webapps configuration page
  3. Create a new webapp named cups

Creating the Webapp Redirect

Edit the config-file using a editor like "nano". Perhaps you have to install it first:

   su -
   yum -y install nano

Now you can edit cups

   su -
   nano /etc/httpd/conf.d/*cups.conf

Go down to line 5, and add this:

   ProxyPass / http://localhost:631/
   ProxyPassReverse / http://localhost:631/

Press CTRL+X to exit and save.

It should look like this


 <VirtualHost *:80>
      
              ServerName cups
              ServerAlias cups.yourdomain.net
      
      
      
              ProxyPass / http://localhost:631/
              ProxyPassReverse / http://localhost:631/
     
              DocumentRoot /var/hda/web-apps/cups/html
     
              <Directory "/var/hda/web-apps/cups/html">
              Options Indexes FollowSymLinks MultiViews
              AllowOverride AuthConfig
              Require all granted
     
              </Directory>
     
              ErrorLog  /var/hda/web-apps/cups/logs/error_log
              CustomLog /var/hda/web-apps/cups/logs/access_log combined env=!d
     
      </VirtualHost>

Restart httpd

check that /var/hda/web-apps/cups/logs exists and is owned by apache:users Then restart httpd.

   systemctl restart httpd.service

Testing

Go to a system on your network, and try going to http://cups

If you have problems connecting to the CUPS web UI, it may be because your DNS Server is not set correctly. Try using IP address in your browser: http://IP_ADDRESS:631 (replace IP_ADDRESS with your HDA IP address)