Configure the MobilePrint listening port and use a certificate with a name different than the hostname

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