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