PrizmDoc® v14.4 Release - Updated April 1, 2025
PrizmDoc Worker Overview / Worker API Developer Guide / How to Run the AI Hub
How to Run the AI Hub

Introduction

This section describes how to run the Worker as a Docker container.

Steps to Run the Worker

  1. Create a Docker network so the containers can communicate:

     docker network create prizmdoc
    
    
  2. Run MySQL Server:

     docker run --name=mysql --detach --rm --network prizmdoc --publish 3306:3306 --env MYSQL_LOG_CONSOLE="TRUE" --env MYSQL_DATABASE=ProcessManager --env MYSQL_ROOT_PASSWORD=root mysql:8.0 --max_allowed_packet=100M --general_log=1 --general_log_file=/var/lib/mysql/mysql.log --innodb_use_native_aio=0
    
    
  3. Configure PrizmDoc Server (NOTE: PrizmDoc Server version must be 13.25 or later).

    Before you can run PrizmDoc Server, you'll need a config file. You can create a default config file using the Docker image's init-config command. After following the step below to create a default config file, see Configuring PrizmDoc Server to configure the central database connection string. If you are using the AI Hub, you will also need to specify a license that includes any of the AI features that you would like to use.

    For Windows (PowerShell):

    First, make sure you've created a config directory on your host file system:

     mkdir config
    
    

    Then, use the init-config command to create a new prizm-services-config.yml file in your config directory:

     docker run --rm -e ACCEPT_EULA=YES --volume $pwd/config:/config accusoft/prizmdoc-server init-config
    
    

    This will create a new PrizmDoc Server config file on your Windows host filesystem at .\config\prizm-services-config.yml.

    For Mac or Linux (bash):

    Use the init-config command to create a new prizm-services-config.yml file:

     docker run --rm -e ACCEPT_EULA=YES --volume $(pwd)/config:/config accusoft/prizmdoc-server init-config
    
    

    This will create a new PrizmDoc Server config file on your host filesystem at ./config/prizm-services-config.yml.

  4. Run PrizmDoc Server (NOTE: PrizmDoc Server version must be 13.25 or later):

     docker run --rm --env ACCEPT_EULA=YES --network prizmdoc --publish 18681:18681 --name prizmdoc-server accusoft/prizmdoc-server
    
    

    Wait until you see the following output in the console:

     [info] Starting Product Runner...
     [info] product-runner has been started correctly.
     [info] Starting PCCIS Watchdog process...
     [info] PCCIS Watchdog has been started correctly.
    
    
  5. Run Process Manager:

    If you are using a Metered or Evaluation license:

     docker run --name=process-manager --detach --rm --network prizmdoc --publish 3000:3000 --publish 3001:3001 --env LOG_LEVEL=info --env "DATABASE_CONNECTION_STRING=mysql://root:root@mysql:3306/ProcessManager" --env "PRIZMDOC_SERVER_URL=http://prizmdoc-server:18681" --env ACCEPT_EULA=YES accusoft/process-manager
    
    

    If you are using an Offline Metered or OEM license:

     docker run --name=process-manager --detach --rm --network prizmdoc --publish 3000:3000 --publish 3001:3001 --env LOG_LEVEL=info --env "DATABASE_CONNECTION_STRING=mysql://root:root@mysql:3306/ProcessManager" --env "PRIZMDOC_SERVER_URL=http://prizmdoc-server:18681" --env ACCEPT_EULA=YES --env "SOLUTION_NAME_IG=<Your_ImageGear_Solution_Name>" --env "SOLUTION_KEY_IG=<Your_ImageGear_Solution_Key>" --env "LICENSE_KEY_IG=<Your_ImageGear_License_Key>" --env "SOLUTION_NAME_SZ=<Your_SmartZone_Solution_Name>" --env "SOLUTION_KEY_SZ=<Your_SmartZone_Solution_Key>" --env "LICENSE_KEY_SZ=<Your_SmartZone_License_Key>" accusoft/process-manager
    
    
  6. Run the Worker:

    To run the OCR Reader Worker:

     docker run --rm --env ACCEPT_EULA=YES --network prizmdoc --publish 4000:4000 --name ocr-worker --env "PROCESS_MANAGER_INTERNAL_URL=http://process-manager:3001" --env "WORKFILE_SERVICE_URL=http://prizmdoc-server:18681/PCCIS/V1/WorkFile" accusoft/ocr-reader-worker
    
    

    To run the AI Hub:

     docker run --rm --env ACCEPT_EULA=YES --network prizmdoc --publish 4100:4100 --name ai-hub --env "PROCESS_MANAGER_INTERNAL_URL=http://process-manager:3001" --env "WORKFILE_SERVICE_URL=http://prizmdoc-server:18681/PCCIS/V1/WorkFile" accusoft/ai-hub
    
    
  7. The Worker is ready to accept processes from the Process Manager.

Stopping

To stop the running Docker containers, use the following commands in the terminal:

To stop the OCR Reader Worker Docker container:

    docker stop ocr-worker
    docker stop process-manager
    docker stop prizmdoc-server
    docker stop mysql

To stop the AI Hub Docker container:

    docker stop ai-hub
    docker stop process-manager
    docker stop prizmdoc-server
    docker stop mysql