...

Prerequisites

• Check which machines are currently supported.

• Make sure the current version of MES and the Aggregator package you downloaded are compatible.

• Assure that the machines are connected to the network. (LAN / WLAN)

• 3YOURMIND’s Aggregator must be downloaded and available in the network. Alternatively a cloud version of the aggregator must be enabled. See below for more details.

• Access to 3YOURMIND’s Agile MES Admin and Service Panel. (minimum of version 3.14)

• Assure that all system requirements are met.
  

1. Obtaining IP address and port

Ultimaker

• Make sure the machine is part of the network.

• On the onboard UI of the machine go to System → Network → Connection Status to obtain the IP address and port.

...

• Access the machine's API documentation at https://si2381/api, replace si2381 with the actual ID of the machine. Navigate to the OPC UA Documentation and look for the Endpoint URL.

• You must have purchased the EOSCONNECT Core license (40194). The purchased license will be activated on the machine after its first setup. To acquire additional licenses, or renew existing ones that are about to expire, contact your EOS field service technician.

Stratasys

• Open the Stratasys Control Center

• Navigate to the Services tab and click on Manage FDM Systems

• The IP Address will be in the second column from the right

...

• Install the HP SmartStream 3D Command Center Client which is able to detect Command Center Servers within the network. The hostname/IP address can be found in the Network connectivity tab.

...

• .

...

Renishaw

• Once you log into your InfiniAM app you will be redirected to {base_url}/app/#!/current-status.

• Use {base_url} as url in the configuration.

2. Machine specific connection information

...

• Generate an API Key at https://print.carbon3d.com/api_keys by clicking the Create API Key button. This will automatically download a secret.json file.

• The unique_name of the machine is displayed as serial number on https://print.carbon3d.com/queue. In this example it is 2B001W.

  

  It is also visible on the screen of the machine.

...

EOS

• Obtain username and password at https://si2381/gui/auth, replace si2381 with the actual ID of the machine. This page is secured with a login and you will need to use your EOScada credentials to access it. Only EOScada credentials that have the role of Supervisor can add new clients.

...

• Create an API token. See https://www.eiger.io/developer#section/Getting-Started for instructions.

• Use the API Access Key as username and the API Secret Key as password in the below configuration.

Renishaw

• Obtain an account with API access rights on your InfiniAM instance.

• Use the Email address as username together with your password in the below configuration.

3. Obtain API Token and Agile MES Service ID

...

Setup a user

1. Login to the 3YOURMIND Platform as a user that has access to the organisation and admin panel.

2. Go to User Panel > Users.

3. Click on Invite User.

4. Fill it with those infos (Make sure that “Send invitation via E-Mail…” is unchecked):
   

   Image Modified

   (The E-Mail Address does not need to exist)
   

5. Click on Save.

Provide access to the organization's fulfillment partners

1. Go to the 3YOURMIND admin panel.

2. Go to Fulfillment partner.

3. Open each service under the Fulfillment partner List.

4. Add the user you created to the list of users.

5. Click on Save.

Create API token

1. Go back to the homepage of the admin panel.

2. Go to Users under Authentication and Authorization.

3. Search for the user you created.

4. Click on Create Token.

...

Login to the 3YOURMIND Platform with a user that has access to the service panel.

Option 1:

1. Visit the dashboard of the service panel

2. The number in the URL represents the service id. E.g. https://[your-domain]/service-panel/1/dashboard/ (service id would be "1")

Option 2:

1. Visit https://[your-domain]/api/v2.0/service-panel/services/.

2. Note the id of the service.
   

   Image Modified

4.

...

Create a configuration

Create a

...

Together with the binary release you will find a sample configuration file called config.sample.json. Rename it to config.json and open it in a text editor:

...

text file with the content as shown below. The file must follow the JSON notation (with comments). We recommend using a text editor like Visual Studio Code or Notepad++.

{
  "machines": [
      [// ...], // please visit the machine childconfiguration pages below for configuration details
of all supported machines],
  "mes_services": [
    {
      "id": 1,
      "url": "https://print.3yourmind.com/api/v2.0/machine/730/",
      "token": "28c1610a1240ecc5e9eae9b2e3a0554e64e8eeaf"
    }
  ],
  "aggregator_id": "my aggregator"
}

If you are planning on deploying our Aggregator on a Windows server then you can use the config.sample.json that come with the download as a basis for your configuration.

Machines

In the machine section, you will need to configure the URL(s) of the machine(s), give them a name of your choice, define their type, and provide a list of mes_service identifiers you want to send data to. Please refer to the tables below to see the configuration details of our supported machines/interfaces:

...

Carbon3D Machine Configuration

EOS Connect Machine Configuration

Ford MQTT Configuration

Formlabs Machine Configuration

...

MTConnect Machine Configuration

Octoprint Machine Configuration

Renishaw Machine Configuration

Ultimaker Machine Configuration

...

Example:
with 730 as serviceId:

{
  "id": 1,
  "url": "https://print.3yourmind.com/api/v2.0/machine/730/",
  "token": "28c1610a1240ecc5e9eae9b2e3a0554e64e8eeaf"
}

...

5. Deploy the Aggregator

...

The aggregator configuration can also be uploaded in the admin panel. To configure the aggregator through the admin panel follow the steps below at

Home › B3_Machine › Aggregator configurations

1. Click ADD AGGREGATOR CONFIGURATION

2. Select your Site

3. Paste the aggregator config into the Content field

4. Save

Wait for 20-30s and check for errors in the admin panel under Aggregator configuration errors. If the Error field is empty then the configuration is valid.

At this point, the Aggregator should have already pulled the new configuration and started reading data from the machines

5. Start the Aggregator

Make sure that the Aggregator is in the same network as each machine you want to connect to.

• Make sure the Aggregator executable and the config.json you created are in the same directory. (The config.json file is not needed if you uploaded the config in the admin panel).

• Run the executable.

Optionally install the Aggregator as a Windows service

• Make sure the install-as-service.bat and uninstall-service.bat are in the Aggregator's directory.

• Double-click on install-as-service.bat.

To remove the service and stop the Aggregator double-click on uninstall-service.bat.

Optionally adjust the settings of the service:

...

Click on Windows Start, type Services and hit enter to open the service configuration panel.

...

For shared-cloud customers

Aggregator On Windows is the only supported option for shared-cloud customers.

For dedicated-cloud customers

1. Aggregator On Windows covers all connectivity cases, but requires manual installation and maintenance.

2. Aggregator In Docker is a low maintenance option that can be used if all machines have an internet connection and a cloud API. Reach out to our customer support team to enable the Aggregator for your deployment.

For on-premise customers

1. Aggregator In Docker is part of our installation package and is the recommended option if the 3YOURMIND MES and all machines are in the same network.

2. Aggregator On Windows covers all connectivity cases, but requires manual installation and maintenance.

6. Activate Machine Connectivity in the Agile MES

1. Login to the 3YOURMIND Platform with a user that has access to the Service Panel. If you do not have access to the service panel, please look at Service Panel.

2. Open the Service Panel.

3. Go to Settings > Workstations.

4. Select the workstation that the machine should get connected to.

5. Select the machine in the Machine Connectivity section.

6. Click on Connect Machine.

...