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.
In iPrint Appliance 1.1 new parameters are added to the iprintmobile.conf file. The parameters are: stellent_conversion_thread_count, pdf_conversion_thread_count, convert_stellent_pdf_using_external_renderer, enable_client_login,and driver_update_interval.
NOTE:The newly added parameters in 1.1 might be missing when you upgrade from an earlier version. You can manually update the iprintmobile.conf file with these parameters.
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). |
stellent_conversion_thread_count |
5 |
Number of threads allocated for job conversion. |
pdf_conversion_thread_count |
10 |
Number of threads allocated to PDF job conversion. |
convert_stellent_pdf_using_external_renderer |
true |
If this is set to false the PDF job data is not send to the remote renderer, even if the remote renderer is configured and active. |
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. |