In addition to the Management Console, there are a few additional parameters that can be configured to fine-tune the iPrint service, based on your network and printing requirements. The iPrint Appliance Server Configuration file, located at /etc/opt/novell/iprintmobile/conf/iprintmobile.conf, allows you to customize the iPrint Mobile service per your requirements.
You must configure the iprintmobile.conf file manually. When assigning a value to any parameter, ensure that you uncomment the line, in order for the changes to take effect. After configuring the file, you must restart the iPrint Mobile service through the Management Console.
The advanced configuration is optional. For most environments, the configuration does not require modifications.
The iPrint Appliance server configuration file contains the following information:
Table A-1 iPrint Appliance Server Configuration File Contents
Parameter |
Default Value |
Function |
---|---|---|
home_directory |
/var/opt/novell/iprintmobile |
A directory on the file system that is used to store the data. This folder contains the service metadata and temporary job data. |
conversion_wait_time |
300 |
Duration of time (in seconds) that the job submission threads wait for the job conversion threads. |
db_backup_interval |
10000 |
Duration (in milliseconds) after which the database is backed up on the disk. |
is_test_setup |
false |
Set this flag if the server is being set up for testing and no dedicated email address is available. Print job requests are read-only from the Cabinet folder. |
job_submission_thread_timeout |
60 |
Duration (in seconds) for which an excess idle thread waits before terminating. |
delete_completed_job_data |
true |
Deletes the converted email print job data stored at /var/opt/novell/iprintmobile/jobs/. Set the value to false to retain the converted job data for email print jobs. The /var/opt/novell/iprintmobile/jobs/ folder does not maintain the IPP job data. IPP job data includes job data from the Novell iPrint app and Airprint. The job data for apps and AirPrint are stored in the PA spool directory of the Print Manager. WARNING:If you set the value to false, you must ensure that you delete the print job data regularly to free up disc space. If the disk space gets full, then email print jobs are not processed. |
fallback_to_local_converter |
false |
If the remote renderer fails, you can run the job through a local converter. |
num_email_receiver_threads |
0 |
Configure this parameter to the maximum number of threads to be used for processing multiple mailboxes. By default (when set to 0), the number of threads to email addresses ratio is 1:5 (1 thread per 5 email addresses). |
use_global_address_for_notifications |
false |
By default, notifications are sent from the printer-specific email address. Change the value to 'true' if you want to send notifications to users using the global email address. |
renderer_time_out |
180000 |
Duration (in milliseconds) after which a registered renderer times out and moves to an inactive state. |
verify_certificates |
false |
Disable certificate validation. |
renderingOnlyServiceEnabled |
true |
RenderOnly Configuration |
backendRenderingPollingInterval |
500 |
Backend Rendering Polling Interval (in milliseconds) |
incoming_mail_server_port |
- |
This configuration overwrites the default port information configured by Appliance for IMAP and POP mail protocols to communicate with the mail servers. For default port information, see Incoming Mail Server Parameters. |
outgoing_mail_server_port |
- |
This configuration overwrites the default port information configured by Appliance for SMTP mail protocol to communicate with the mail servers. For default port information, see Outgoing Mail Server Parameters. |
email_polling_interval |
30000 |
Configures the interval (in milliseconds) at which emails are fetched from mail servers. |
subject_optional_for_printer_specific_emails |
true |
Stops printing emails without the correct iPrint email print command. By default this value is 'true.' Emails forwarded to the printer-specific email address, with or without a subject line, are printed. |
email_reconnect_interval |
30 |
If the email server is unavailable, iPrint Appliance tries to reconnect to the email server after the specified duration (in seconds). |
pdf_conversion_thread_count |
10 |
Number of threads allocated to PDF job conversion. |
enable_client_login |
false |
By default this value is ‘false’. Set this value to ‘true’ if you require user authentication in apps for printer-based license. |
driver_update_interval |
60 |
Duration (in minutes) after which driver update is triggered. |
default_network_interface |
eth0 |
Change the default value, if you have multiple NIC cards configured and you want to publish the AirPrint printers via a different Network interface. |
direct_pdf_print |
- |
Add and set this value to ‘true’ to enable direct pdf printing. If this parameter is not added or set to ‘false’, then the printing is done in the earlier way where the jobs are rendered by the Renderer. |
proxy_server_hostname |
- |
Add and specify the value as IP address or host name along with port number. Whenever a user adds the proxy configured iPrint server in the iPrint mobile app, it will automatically get configured with the Proxy server. All the requests of the mobile app users will be redirected to the iPrint server thru the proxy server. For example, http://proxy.mycompany.com:8080 |