A.0 Advanced Configuration for iPrint Mobile Service (Optional)

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.