Skip navigation
All Places > Knowledge Base & Downloads > Blog > 2014 > May
2014

How do I configure the MobilePrint listening port?  Also, can I use a certificate with a common name (CN) that is different than the hostname of the MobilePrint server?

 

1. First, shutdown the MobilePrint services. There are 5 services. Here is a common shutdown order:

  • Pharos Systems MobilePrint Website Service
  • Pharos Systems MobilePrint Authenticator Service
  • Pharos Systems MobilePrint Worker Service
  • Pharos Systems MobilePrint Workflow Service
  • Pharos Systems MobilePrint Configurator Service

 

2. Next, locate the 2 MobilePrint configuration files named "LocalServer.config.xml" and "MobilePrint.Configurator.config.xml". Here are their default locations:

  • C:\Program Files (x86)\PharosSystems\MobilePrint\LocalServer.config.xml
  • C:\ProgramData\PharosSystems\MobilePrint\MobilePrint.Configurator.config.xml

 

3. To change the default port number 9001 to 443, edit both configuration files and replace 9001 with 443.

 

Example 1: LocalServer.config.xml


<BootstrappingConfiguration>
<Port>443</Port>
<AppDataLocation>C:\ProgramData\PharosSystems\MobilePrint\</AppDataLocation>
<Configurators json:Array="true" xmlns:json="http://james.newtonking.com/projects/json"> 
<Name>MY MOBILEPRINT SERVER HOSTNAME</Name> 
<Port>443</Port> 
<Zone>Global</Zone>
</Configurators>
</BootstrappingConfiguration>



Example 2: MobilePrint.Configurator.config.xml


<ServerConfiguration>
  <Port>443</Port>
  <PrintServers json:Array="true" xmlns:json="http://james.newtonking.com/projects/json">
    <Name>DO NOT CHANGE PRINT SERVER HOSTNAME</Name>
    <Port>808</Port>
  </PrintServers>
  <Workflows json:Array="true" xmlns:json="http://james.newtonking.com/projects/json">
    <Name>MY MOBILEPRINT SERVER HOSTNAME</Name>
    <Port>443</Port>
  </Workflows>
  <Workers json:Array="true" xmlns:json="http://james.newtonking.com/projects/json">
    <Name>MY MOBILEPRINT SERVER HOSTNAME</Name>
    <Port>443</Port>
  </Workers>
<Configurators json:Array="true" xmlns:json="http://james.newtonking.com/projects/json">
    <Name>MY MOBILEPRINT SERVER HOSTNAME</Name>
    <Port>443</Port>
  </Configurators>
  <Authenticators json:Array="true" xmlns:json="http://james.newtonking.com/projects/json">
    <Name>MY MOBILEPRINT SERVER HOSTNAME</Name>
    <Port>443</Port>
  </Authenticators>
  <Websites json:Array="true" xmlns:json="http://james.newtonking.com/projects/json">
    <Name>MY MOBILEPRINT SERVER HOSTNAME</Name>
    <Port>443</Port>
  </Websites>
</ServerConfiguration>




4. To change the MobilePrint certificate, edit the configuration file named "LocalServer.config.xml"

 

5. MobilePrint uses the certificate configured as <SslThumbprint>MY CERTIFICATE THUMBPRINT</SslThumbprint> where MY CERTIFICATE THUMBPRINT is the hexadecimal thumbprint of a certificate in the Windows Certificate Manager (certmgr.mmc) on the MobilePrint server.

 

<SslOverrideConfiguration>
  <RequireTrustedCertificates>false</RequireTrustedCertificates>
  <SslThumbprint>MY CERTIFICATE THUMBPRINT</SslThumbprint>
</SslOverrideConfiguration>


 

6. In addition, the certificate's common name (CN) should match the hostname configured as <Name>MY MOBILEPRINT SERVER HOSTNAME</Name> in both "LocalServer.config.xml" and "MobilePrint.Configurator.config.xml"

  • See Example 1 and 2 above.
  • The issuer or central authority (CA) who issued (signed) the CN certificate must be stored in the Windows Certificate Manager (certmgr.mmc) as a trusted or root certification authority.

 

7. Now, start the MobilePrint services. Here is a common start order:

  • Pharos Systems MobilePrint Configurator Service
  • Pharos Systems MobilePrint Workflow Service
  • Pharos Systems MobilePrint Worker Service
  • Pharos Systems MobilePrint Authenticator Service
  • Pharos Systems MobilePrint Website Service

Symptoms:

  • iMFP for Xerox fails to successfully manage a Xerox device.
  • The management console shows success (device status is Managed) but the blocking screen on the Xerox device does not show the expected screen with the key.
  • It may show a soft keyboard and request authentication.
  • Attempting authentication may result in a DNS error message.

 

Environment:

  • iMFP for Xerox version 2.5 or higher (software only solution)
  • Xerox device with McAfee enabled

 

Cause:

With the McAfee feature enabled on some Xerox devices some of the configuration performed by the iMFP for Xerox management console appears to be blocked. As a result the installation and configuration is incomplete resulting in the symptom above.

 

Resolution:

Disable the McAfee protection on the Xerox device. This is performed from the web interface of the device, Properties tab in the Security section. This will require a reboot of the device. After the device reboots use the Management Console remove the Pharos and then reinstall the Pharos solution. At this point the installation should succeed and the expected blocking screen will be displayed.

 

  NOTE: Pharos is working with Xerox to understand this further. A software update may be made available in the future to address this. On some devices with McAfee enabled our installation process works fine. We do not yet understand fully what is causing this. We have observed that McAfee can be successfully re-enabled after Pharos installation and the engine runs successfully.

Goal:

  • Create customized Pharos Popup for Mac package.


Environment:

  • Pharos Uniprint Suite 8.3
  • Pharos Uniprint Suite 8.4
  • Apple MacOS 10.6
  • Apple MacOS 10.7
  • Apple MacOS 10.8
  • Apple MacOS 10.9

 

Resolution

As in previous versions of the Mac package, our most current offering allows for customization of the package for mass deployment.  This will allow users to install shared Pharos Uniprint Print Server queues at the same time that the Popup and Notify client are installed.

 

Please download the "TechNote Automatic Popup and Print Queue Configuration for Mac OS X" attached for those instructions. The Pharos Uniprint 8.3/8.4 MacOS X base package must be downloaded separately.

Goal:

  • Understand the current supported product list for Microsoft Windows Server 2012 R1 and R2.

 

Resolution

The following products include support for Microsoft Windows 2012 Server

 

Windows Server 2012 R1

Uniprint 8.3 Service Pack 1 (SP1) and earlier

  • Not Supported

 

Uniprint 8.4 and 9.0 General Release

  • Pharos Administrator
  • Pharos Remote
  • Pharos Reports
  • Principal Server (Database, License, etc.)
  • Print Server (LPD, Popup, Secure Release, etc.)
  • SignUp Server

 

Blueprint 5.0 and earlier

  • Not Supported

Blueprint 5.1 General Release

  • Analyst
  • Blueprint Administrator
  • Collector
  • Tracker
  • Site Monitor
    • Site Monitor Database: Supported
    • Site Monitor Service: Supported
    • Site Monitor Administrator: Not Supported

 

MobilePrint 1.3.1 and earlier

  • Not Supported

 

MobilePrint 1.3.2 and 2.0

  • Authenticator
  • Configurator
  • Website
  • Worker
  • Workflow

 

Windows Server 2012 R2

Uniprint 8.3 Service Pack 1 (SP1) and earlier

  • Not Supported

 

Uniprint 8.4 and 9.0 General Release

  • Pharos Administrator
  • Pharos Remote
  • Pharos Reports
  • Principal Server (Database, License, etc.)
  • Print Server (LPD, Popup, Secure Release, etc.)
  • SignUp Server

 

Blueprint 5.1

  • In Controlled Release - link to software available upon request

 

 

Blueprint 5.0 and earlier

  • Not supported 

 

MobilePrint 1.3.2 and earlier

  • Not Supported

 

MobilePrint 2.0

  • Authenticator
  • Configurator
  • Website
  • Worker
  • Workflow

Goal:

  • Configure Pharos MobilePrint to use Office 365 as its email server.

Environment:

  • Pharos MobilePrint 1.3.2 and 2.0
  • Microsoft Office 365

 

 

 

Resolution:

To configure Pharos MobilePrint for Microsoft Office 365 Mail Server, perform the following steps.

1. Obtain your Office 365 email settings


a. Sign in to your account using Outlook Web App. For help signing in, see Sign in to Outlook Web App (NOTE: this is a link to Microsoft.com)


b. In Outlook Web App, on the toolbar, click Settings (the Gear icon) > Options > Account > My account > Settings for POP and IMAP access.


c. The POP3, IMAP4, and SMTP server name and other settings you may need to enter are listed on the Settings for POP and IMAP Access page under POP setting or IMAP setting, and SMTP setting.


An example of the dialog box presented is shown below:


Office 365 mail settings


2. Configure MobilePrint

a. Launch the MobilePrint Administrator web page (https://<MobilePrint Server's hostname>:9001/admin/settings.html) and log in.


b. Go to the
Email Server Connection menu item.


c. Modify the IMAP and SMTP Account sections to reflect those found in the Office 365 configuration (step 1). An example is shown below. Please note that the Port, Username, and Password fields will be different.


MobilePrint email configuration


d. Save the configuration and test.

Symptoms:

  • ERROR: "Service cannot be started. System.TypeInitializationException: The type initializer for '<Module>' threw an exception. ---> System.AccessViolationException: Attempted to read or write protected memory. This is often an indication that other memory is corrupt."
  • Pharos Systems Secure Release Service fails to start
  • User cannot print (Secure Release or Direct)

Environment:

  • Uniprint 8.3 (any build)
  • Microsoft Windows Server
  • Microsoft .NET 4.5


Cause:

It has been found that the installation of Microsoft .NET 4.5 on a server running any build of Uniprint 8.3 (including Service Pack 1) will cause the Secure Release Service (SRS) to stop working due to an incompatibility between a component of SRS and a module installed with .NET 4.5. This can happen during Windows Update with the application of Microsoft patch KB2858725.


Resolution:

Please read below to determine what to do depending on the Uniprint server's current state:


Microsoft .NET 4.5 Is NOT Installed

Action: Do NOT install Microsoft .NET 4.5. You will be notified via the Pharos Communities site when it will be safe to install this version of .NET (this will be accompanied by an update to Uniprint).


Microsoft .NET 4.5 IS Installed

Action: Uninstall Microsoft .NET 4.5 and then reinstall Microsoft .NET 4.0. This will restore .NET 4.0 functionality. You will be notified via the Pharos Communities site when it will be safe to install this version of .NET (this will be accompanied by an update to Uniprint).