• This site is read-only while we complete some maintenance. You can't create or edit pages right now.

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Setting up the Batch and Analytics portals is straightforward.  Refer to the GlobalCapture configuration  Portal Management guide if additional details are required.

If the installation failed or some other factor has caused one or more of the portals to cease functioning, follow the steps outlined below.

...

  • Check to make sure the services are running on the server:
    • Mongo DB
      • If Mongo won’t start, there is an unrelated issue.  The most common cause for a Mongo start failure is low disk space.
    • ssBatchPortal
  • Ensure the URL provided for the Portal is using https.

Image RemovedImage Added

  • The user account specified for authentication should be in the fully qualified domain format (domain\username).
  • If there has been a password change recently, re-enter the password.

...

  • Check to see if a SSL certificate exists for the IP Address and Port specified in the Batch Portal configuration file (C:\GetSmart\BatchPortal\ssBatchPortal.exe.config).

Image RemovedImage Added

1. Open an administrative command prompt and enter:  netsh http show ssl

You should see an entry with the matching IP Address and Port:

Image RemovedImage Added

  • If you do not have a matching certificate binding in your list a new one will need to be created ( example in command prompt: netsh http add sslcert ipport=127.0.0.1:6457 certhash=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx appid={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} ).  A missing binding would imply some level of permissions issue during the original setup.
  • You may need to delete the old ssl SSL certificates in command prompt. This is an example of deleting a certificate in command prompt: netsh http delete sslcert ipport=127.17.0.64:6457 - you may have a different address.
  • Make sure the ssBatchPortal service is stopped and run the following command and Batch Portal should return the thumbprint of the SSL Certificate it just generated:

2. Run C:\GetSmart\BatchPortal\ Run ssBatchPortal.exe -ssl

 


Image RemovedImage Added

 3. Open the IIS Management Console.  Select your server, and double click Server Certificates in the Features View.

Image RemovedImage Added

4. The thumbprint reported back by the batch portal should now match an entry in the Server Certificates section of the IISIIS Manager:

Image RemovedImage Added

  • Return to the start of this document and verify again steps 1 – 4.

...

If you’ve done everything correctly and recieve receive a CERTENROLLLib.CX509 Error in the console (see image below), don’t panic. This is a known issue within the CertEnroll dll in Windows. We can easily bypass this by manually enrolling the cert.

Image RemovedImage Added

  1. Create a Self-Signed Cert in IIS – Name it ssBatchPortal
  2. Open up the cert by double clicking it and locate the “thumbprint” – copy and paste the thumbprint into a text editor and remove all spaces
  3. Rerun the -ssl command in Admin CMD but include the thumbprint as screenshot above demonstrate (yellow highlighter)
  4. You will receive no confirmation message. Run a netsh http show ssl command to ensure the cert has been bound properly to the correct port and IP
  5. Confirm the certificate thumbprint in the Certificate properties is the same as the certificate hash in your netsh http show sslquery.
  6. Attempt to start Batch Portal service again

...

If your Batch Portal service is running but still red. Run service console to set the services to user running the services usually ssadministratorSSAdministrator



If these steps do not resolve your issue, please submit a support request to Square 9’s Software Support team by completing the support request form here: http://www.square-9.com/support

...