Set connector attributes to personal information exchange file (PFX) - SmartPlant Markup Plus - Version 2019 SP 1 (10.0.1) - Installation & Upgrade

SmartPlant Markup Plus Installation

Language
English (United States)
Product
SmartPlant Markup Plus
Search by Category
Installation & Upgrade
SmartPlant Foundation / SDx Version
10
SmartPlant Markup Plus Version
10.0 (2019)
  1. Obtain a personal information exchange (PFX) certificate for your domain. The certificate must include the entire chain, which includes both the root and intermediate certificates, generated by your respective IT team. Copy it to a folder on the server where SmartPlant Markup Plus Server is installed.

    In addition, make sure all SSL certificates (including intermediate certificates) are imported to: Local Computer > Personal and Local Computer > Trusted Root Certification Authorities in IIS Manager.

  2. Stop the following services:

    1. Apache Tomcat

    2. Brava! Job Processor

      If you are using a version prior to SmartPlant Markup Plus 2019 Service Pack 1, the job processor service is called Blazon Job Processor.

      Go to Start > Administrative Tools > Services to stop and start services.

  3. Open the Apache Tomcat configuration file:

    [Apache installation folder]\Apache Software Foundation\Tomcat [version]\conf\server.xml

  4. Find the <Connector> element with the port number 8443, which is commented out.

    If you entered a different port number when installing SmartPlant Markup Plus Server, you will need to replace "8443" with the port number you entered.

  5. Uncomment the <Connector> element by removing the commenting brackets around it.

  6. Add the following attributes to the <Connector> element:

    Attribute names are case sensitive.

    Attribute

    Description

    sslImplementationName

    Defines a Java Secure Socket Extension (JSSE) connector. Setting this value to org.apache.tomcat.util.net.jsse.JSSEImplementation causes Apache Tomcat to use JSSE SSL, even if the APR library is loaded.

    asyncTimeout

    The timeout value, in milliseconds, for long-running processes, such as opening or publishing very large PDF files. We recommend a minimum setting of 600000.

    keystoreFile

    Full path to the PFX file. Use double backslashes (\\) in the folder path.

    keystorePass

    Password for the PFX file.

    keystoreType

    PKCS12 for the PFX file.

    In the following example, the below attributes are used with SmartPlant Markup Plus 2019 Service Pack 1 and Apache Tomcat 9:

    The below attributes can also be used with SmartPlant Markup Plus 2019 and Apache Tomcat 8.5.

    <Connector port="8443"

    protocol="org.apache.coyote.http11.Http11NioProtocol"

    connectionTimeout="60000" maxThreads="150" SSLEnabled="true"

    scheme="https" secure="true"

    clientAuth="false" sslProtocol="TLS">

    keystoreFile="C:\\certificate\\[MyFile].pfx"

    keystorePass="myPassword" keystoreType="PKCS12"

    asyncTimeout="1000000"

    </Connector>

  7. Find the <Connector> element with the port number 8080.

  8. Add the asyncTimeout attribute to the <Connector> element, setting the attribute to at least 600000:

    Attribute names are case sensitive.

    In the following example, the below attributes are used with SmartPlant Markup Plus 2019 Service Pack 1 and Apache Tomcat 9:

    The below attributes can also be used with SmartPlant Markup Plus 2019 and Apache Tomcat 8.5.

    <Connector port="8080" protocol="HTTP/1.1"

    connectionTimeout="60000"

    asyncTimeout="1000000"

    redirectPort="8443" />

  9. Restart the services in the following order:

    1. Brava! Job Processor

      If you are using a version prior to SmartPlant Markup Plus 2019 Service Pack 1, the job processor service is called Blazon Job Processor.

    2. Apache Tomcat

      Go to Start > Administrative Tools > Services to stop and start services.