Registering workstation clients#10646
Registering workstation clients#10646katarzyna-koltun-mx wants to merge 3 commits intodevelopmentmendix/docs:developmentfrom
Conversation
|
@MXLino @mendix-nleimer Can you take a look at the proposed document and let me know if you have any corrections? |
|
Watch the sprint demo from Feb 5 - UI changes. |
MXLino
left a comment
There was a problem hiding this comment.
We need to adjust a few things, as the described steps do not correspond to the latest version.
| weight: 30 | ||
| --- | ||
|
|
||
| ## Introduction |
There was a problem hiding this comment.
I would add here a little bit more context:
The ultimate goal of the Mendix Workstation Client is to establish a secure and reliable connection between the Mendix Application Client and the specific hardware, peripherals, or local data sources attached to that same workstation. This vital connection is facilitated via the Workstation Connector and the Workstation Client.
To enable this crucial functionality, the registration process is a critical first step: it onboards your local Workstation Client installation into your Mendix Workstation Management environment. This onboarding allows for centralized management, configuration deployment, and monitoring of your clients, ensuring they are properly set up to bridge your Mendix applications with the physical world.
|
|
||
| 1. Navigate to the **Workspaces** page in [Workstation Management](https://workstation.home.mendix.com/). | ||
| 2. Click **Create Workspace**, or select an existing workspace from the overview. | ||
| 3. Click **Create Station**. |
There was a problem hiding this comment.
To remain consistent, I would also add here: ...,or select an existing station from the list for which no computer is yet registered.
| 3. Click **Create Station**. | ||
| 4. Enter a name for the station and optionally select or create a group to categorize it, such as *Assembly*. | ||
| 5. Add devices in the **Devices** section. | ||
| 6. Click **Register Computer** to register your computer. |
There was a problem hiding this comment.
Should we add some orientation help? For example: Click “Register Computer,” located at the top right of the banner, to start registering a computer.
| 1. Navigate to the **Workspaces** page in [Workstation Management](https://workstation.home.mendix.com/). | ||
| 2. Click **Create Workspace**, or select an existing workspace from the overview. | ||
| 3. Click **Create Station**. | ||
| 4. Enter a name for the station and optionally select or create a group to categorize it, such as *Assembly*. |
There was a problem hiding this comment.
I think point 4 and 5 we can skip here. specifically number 5 is not needed to register a computer,
| 4. Enter a name for the station and optionally select or create a group to categorize it, such as *Assembly*. | ||
| 5. Add devices in the **Devices** section. | ||
| 6. Click **Register Computer** to register your computer. | ||
| 7. Click **Download** to navigate to the Workstation Client listing in the Marketplace, download the Client installer for Windows, install it, and launch it. |
There was a problem hiding this comment.
Click Download to navigate to the Workstation Client listing in the Marketplace. Download and install the Client installer for Windows, then launch the application.
We should also add here the links to the different Versions of the Client, or if we have the links already somewhere else at least mention the available options.
For Windows: https://marketplace.mendix.com/link/component/247448
For Windows (portable version): https://marketplace.mendix.com/link/component/247456
For Linux ARM64: https://marketplace.mendix.com/link/component/247459
For maxOS: https://marketplace.mendix.com/link/component/253905
| The **Create Bulk Registration Token** dialog opens. You can use it to activate a time-limited token which can then be entered into the registration field of multiple Workstation Clients. | ||
|
|
||
| 4. Specify the timeframe during which the token is valid. | ||
| 5. Copy the token to a clipboard and save it in a secure location. For security reasons, the token is only displayed once. |
There was a problem hiding this comment.
This part is outdated. We have revised it, and as long as the token is active, it can be viewed and copied by the appropriate roles.
| 4. Specify the timeframe during which the token is valid. | ||
| 5. Copy the token to a clipboard and save it in a secure location. For security reasons, the token is only displayed once. | ||
| 6. Click **Activate Token**. The **Stations** page displays the timeframe during which the bulk registration is scheduled. | ||
| 7. Use an automated script to distribute the token to client computers during the allowed timeframe. For example, on Windows machines, you can use the following script: `Start-Process -FilePath {path where the Workstation Client is installed} -ArgumentList "--registration-token {bulk registration token}" -Wait` |
There was a problem hiding this comment.
I would describe it as an option: You can also...
It would be good to add the command for Linux here as well. Alawi will provide us with the commands tomorrow after testing.
| 6. Click **Activate Token**. The **Stations** page displays the timeframe during which the bulk registration is scheduled. | ||
| 7. Use an automated script to distribute the token to client computers during the allowed timeframe. For example, on Windows machines, you can use the following script: `Start-Process -FilePath {path where the Workstation Client is installed} -ArgumentList "--registration-token {bulk registration token}" -Wait` | ||
|
|
||
| After the command runs, the Workstation Clients display the status **Waiting for station assignment**. This indicates that the clients are registered, but not yet associated with a specific station. On the **Stations** page in Workstation Management, you can now see placeholder stations also named **Waiting for station assignment**. These stations correspond to computers which were registered during bulk import. |
There was a problem hiding this comment.
After the command runs or the token is entered manually, the Workstation Clients will initially display the status "Computer not matched to available station." This status indicates that while the clients are successfully registered, they haven't yet been associated with a specific station.
To view these newly registered clients, refresh the Stations page in Workstation Management. You'll find them listed under a separate section as "unassigned computers."
Alternatively, you can pre-configure the computer name for a station in advance. This is done by entering the computer's name in the "Auto-Accepted Computer Name" field when creating a new station or editing an existing one. If the computer name is pre-configured, the client will automatically switch to an Active status with the correct configuration upon registration, and the station status in Workstation Management will update to "Computer Registered" after refresh.
There was a problem hiding this comment.
Ok I see the automatically assigning is documented on the bottom.
|
|
||
| After the command runs, the Workstation Clients display the status **Waiting for station assignment**. This indicates that the clients are registered, but not yet associated with a specific station. On the **Stations** page in Workstation Management, you can now see placeholder stations also named **Waiting for station assignment**. These stations correspond to computers which were registered during bulk import. | ||
|
|
||
| 8. On the **Stations** page, click **View** by a placeholder **Waiting for station assignment** station. |
There was a problem hiding this comment.
Point 8 and 9 is also outdated:
In the case of an “unassigned computer,” you have three options:
- Accept Computer: Creates an empty station.
- Assign Computer: Allows us to assign an existing configured station.
- Reject Computer: Rejects the computer and disconnects/deregisters it.
|
|
||
| Instead of reassigning computers to stations manually after the bulk import, you can configure stations to automatically accept computers with a specific name. | ||
|
|
||
| 1. On the **Stations** page, click the three-dot menu by the station where you want to automatically register a computer. |
There was a problem hiding this comment.
This can also be configured during creation.
No description provided.