Configure the MobilePrint listening port and use a certificate with a name different than the hostname
  • 09 Apr 2024
  • 1 Minute to read
  • Dark
    Light
  • PDF

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

  • Dark
    Light
  • PDF

Article summary

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


Was this article helpful?


Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.