Register an FT Optix Extractor

This topic describes the steps to register and configure an FT Optix extractor for FT Optix data to egress to FactoryTalk DataMosaix.
Prerequisites
  • A project is created using FactoryTalk DataMosaix.
  • FactoryTalk Optix Studio and FactoryTalk Optix DataMosaix Connector (FT DataMosaix_Optix_Connector.msi file) are installed on your system.
NOTE:
Make sure that the
FTDM-FTOptix FTDataMosaix Connector
 feature is enabled in the Manage Access > Features tab. For more information, refer to Enable or Disable Features.
Register an FT Optix Extractor
  1. On the Management Console, select the
    Extractor Info
     tab.
    The Extractor Listing page is displayed.
  2. Click the Add [] icon.
    The
    Extractor Info Detail
    page is displayed.
    Extractor Info Detail
  3. In the
    General Info
     section, provide a unique and meaningful name for your Extractor in the
    Source Name
     field. The Source Name works as the identifier for your extractor. You can search for an extractor using the Source Name. By default, DataMosaix populates a source name.
    Source Name example: EXT_1406230728_createproject_v1.
    Here, EXT stands for the extractor, 140623 is the date in ddmmyy format, 0728 is the timestamp in hhmm format, and createproject_v1 is the project in which you are currently working. You can use the default source name or create your own.
  4. (Optional) Provide the location details. This is additional optional information that can help you identify an extractor when you have many extractors for different plants/sites/locations.
  5. From the Associated Roles drop-down list, select at least one role. You can refer to various roles and capabilities by clicking
    Role Reference
    .
    NOTE:
    The Associated Roles drop-down is visible and available only for Project Admin users or users within the Organization with a Project Admin Role assigned.
    You can select multiple roles from the Associated Roles drop-down list. In the search bar, you can search for any specific role from the list. If you want to apply all the roles to the application, select the
    Select All
     check box.
    Next, you can select a pipeline or create a new pipeline. When you create a new pipeline, you have the option of selecting from an existing dataset or creating a new dataset.
  6. In the
    Pipeline Name
     field, search for a specific pipeline by entering the first characters and select a pipeline. On selecting a pipeline, the Pipeline External ID and Dataset Name fields are populated.
    To create a new pipeline, select the
    + Create Pipeline
     option.
    The Create Pipeline dialog box is displayed.
    Create Pipeline
  7. Provide the following Pipeline information to create a new pipeline.
    • Pipeline Name
    • Pipeline External ID
    • Pipeline Description (Optional)
  8. When you create a pipeline, you can either select an existing dataset or create a new dataset. Select a Dataset from the
    Dataset Name
     search field, if you want to use an existing Dataset.
    If you choose to create a new Dataset, the Dataset-related fields will be displayed. Provide the following dataset information.
    • Dataset Name
    • Dataset Description
  9. Click
    Add
    . Based on the options you choose (select or create), the Pipeline and Dataset information is either populated or created and displayed on the Extractor Info Detail page.
  10. In the
    Source Info
     section, select the source type of extractor as
    FT OPTIX
    .
    Extractor Info Detail - FT OPTIX Extractor
  11. Click
    Save and Apply
    .
    The
    Generated info Saved
     pop-up window displays the configuration information. You can view the configuration file details by clicking
    View generated configuration file
    . Alternatively, you can also copy and save the information for future use by clicking
    Copy All
    . Click
    Download
     to download the config.yml file that includes all the configuration information that you can use to run the extractor.
    Extractor Configuration File Download
  12. Click
    Download
    .
    The config.yml file is downloaded in the Downloads folder of your local machine.
  13. Click
    Close
     to close the pop-up window.
    The new extractor is displayed under Extractor Listing.
Configuring FT Optix to Connect to DataMosaix
Make sure that you have installed the FactoryTalk Optix Studio application on your system. Once you select the source type as FT Optix in the Source Info section, a link to download the application will appear (Get FactoryTalk Optix). You can also download the FactoryTalk Optix Studio from FactoryTalk Hub. For more information on installation, refer to Install FactoryTalk Optix Studio.
  1. Launch the FactoryTalk Optix Studio application.
  2. Click
    New
     [+].
  3. Provide the
    Name
     and
    Location
     details.
    New FT Optix Project
    NOTE: In the Location field, you must provide the exact location where you installed the FT DataMosaix_Optix_Connector.msi file.
  4. Click
    Create
    .
Install FT Optix - DataMosaix Connector
On the Extractor Info Detail page, once you select the source type as FT Optix in the Source Info field, a link to download the Optix connector (Get FactoryTalk Optix DataMosaix Connector) will appear, which you can use to download the Optix-DataMosaix connector installer file.
  1. Download the Optix DataMosaix connector installer file (FTDataMosaix_Optix_Connector.msi) from the Product Compatibility and Download Center (PCDC). Also, you can use this link to download the connector.
  2. Right-click on the FTDataMosaix_Optix_Connector.msi file and choose
    Run as Administrator
     to begin the installation.
  3. After the wizard initializes the setup, the 'SOFTWARE AND CLOUD SERVICES AGREEMENT' screen displays. Scroll down, accept the license agreement, and then click
    Install
    .
    Installer Setup
    By default, the installation takes place in the following location: C:\Program Files\Rockwell Automation\FTDataMosaix_Optix_Connector
  4. Once the installation is complete, the ‘Completed the FTOptix_DataMosaix_Connector Setup Wizard’ screen is displayed. Click
    Finish
     to close the installation window.
    After the installation is completed successfully, a shortcut to the ‘FactoryTalk Optix - DataMosaix Connector Setup’ will be created on your desktop.
    Connector Setup Shortcut
  5. Double-click on the
    FactoryTalk Optix - DataMosaix Connector Setup
     to open it.
    The 'FactoryTalk Optix - DataMosaix Connector Setup' window is displayed.
    Optix - DataMosaix Connector Setup
    NOTE:
    If you see a message about needing .NET to run the setup, download and install the latest version.
  6. Specify the exact location of the Optix project by clicking
    Browse
     and provide the project folder path.
  7. Click
    Deploy Connector
    .
    Upon successful completion, you will see a dialog box stating
    'Configuration Completed. Click on Browse Another if you want to configure the connector for another project'.
  8. (Optional) Click
    Browse Another
     to configure the connector for another Optix project.
NOTE:
After setting up the FT Optix - DataMosaix connector, you must restart the FT Optix application for changes to take effect.
Configuring FT Optix to Connect to DataMosaix – Continuation
  1. Restart the FT Optix Studio and open the project.
  2. If you have installed the connector file in the exact location of your Optix project, an FT DataMosaix Store will be created in the FT Optix DataStore. To view it, navigate to the
    Project view
     >
    DataStores
     and click on it to view all the stores created within.
    FT Optix DataStores
  3. Select the
    FTDataMosaixStore
     to view the Properties pane.
  4. In the
    Properties
     pane, provide the following information:
    • PushInstance
      - Provide the instance which needs to be pushed to the Cognite.
      Push Instance
    • ConfigFolderPath
       - Provide the exact path to the downloaded config.yml file.
      NOTE: Ensure that the file name 'config.yml' remains unchanged, as altering it may result in failure.
  5. To run the emulator, in the main toolbar, click Run on Emulator []
    The NetLogic security warning dialog box is displayed.
  6. Click
    Proceed
    .
    The project will get saved, and the application will initiate deployment and run the project. The following actions will take place automatically:
    • Asset creation.
    • Subscribe to tags.
    • Creation of flexible data model.
    Tip: In the bottom left corner, navigate to
    Emulator Output
      >
    Messages
     to view the status of actions with the timestamp details.
To View Newly Created Assets
  • FactoryTalk Datamosaix: On the Management Console, click the
    Modeling
     tab to view the newly created assets.
    Model Listing
    Tip: If you can’t see the newly created assets on the Model Listing page, click the Refresh [ ] icon to update the page.
  • Cognite Data Fusion: Navigate to
    Data Explorer
     >
    Assets
    .
    Assets
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.