Docker Deployments of StreamSets Data Collector and StreamSets Transformer - Changes in Product Activation

  • 26 November 2021
  • 0 replies
  • 238 views

Userlevel 4
Badge

up to 4.0.x) and StreamSets Transformer 3.16.0.


With the 3.19.0 release of Data Collector and the 3.16.0 release of Transformer, all Docker images will require product activation so that we can improve the product by having a closer relationship with users. This may impact how you deploy and upgrade your Data Collector and Transformer installations.


How is this change going to impact you?


For Docker installations registered with StreamSets Control Hub

  • If using Provisioning Agent
    • There is no impact.
  • If automating installation to register with Control Hub
    • There is no impact.
  • If configuring a new installation to register with Control Hub using the Data Collector/Transfomer UI
    • Activation will not be necessary
    • Please note that these steps are necessary for Data Collector versions from 3.19.0 to 4.0.x. The Data Collector version 4.1.0 does not require these steps:
    • You will need to run the Docker container with the following additional argument to the 'docker run' command:
      • For Data Collector (the argument is case sensitive): 
      • --env SDC_CONF_http_authentication=form
      • For Transformer (the argument must be lowercase):
      • --env transformer_conf_http_authentication=form
    • After starting the docker container, you will log in and follow the steps to register the installation with Control Hub.
  • If upgrading an installation that is already registered with Control Hub
    • There is no impact.


For Docker installations, which are not registered with StreamSets Control Hub

  • Please be aware that complete automation will not be possible without registering the installation with Control Hub. You will need to receive an activation code before you start using the Docker instance.
  • If configuring a new installation
    • The installation will need an activation code.
    • You can follow our recommendations on how to mount the data directory, and prepare your volumes.
    • Please note that these steps are necessary for Data Collector versions from 3.19.0 to 4.0.x. The Data Collector version 4.1.0 does not require these steps:
    • You will need to run the Docker container with the following additional argument to the 'docker run' command:
      • For Data Collector (the argument is case sensitive): 
      • --env SDC_CONF_http_authentication=form
      • For Transformer (the argument must be lowercase):
      • --env transformer_conf_http_authentication=form
    • After starting the container, search for the “SDC ID”. You can find it either in the '/data/sdc.id' file in the container or via the UI by selecting "Enter Activation Code".
    • Create a request for an activation code via our Support portal and include the following information:
      • SDC ID (also called Product ID)
      • Email address to identify who the product should be licensed to, if not yourself.
    • In the "Enter Activation Code" screen in the Data Collector or Transformer UI, enter the code provided by our Support Team.

  • If upgrading a Data Collector or Transformer installation
    • After upgrading the installation, you will need an activation code (if you have not already applied one).
    • Log in to the instance and search for the “SDC ID”. You can find it either in the '/data/sdc.id' file in the container or via the UI by selecting "Enter Activation Code".
    • Create a request for an activation code via our Support portal and include the following information:
      • SDC ID (also called Product ID)
      • Email address to identify who the product should be licensed to, if not yourself.
    • In the "Enter Activation Code" screen in the Data Collector or Transformer UI, enter the code provided by our Support Team.

 

For existing Docker deployments, there is no impact until you upgrade the installation.


For your questions, please create a request for our Support Team.


0 replies

Be the first to reply!

Reply