================================== Connecting to On-Site Lab Hardware ================================== This page guides users through setting up device drivers and connecting to lab hardware. PC Requirements --------------- Most of our drivers are complete, stand-alone installers. For Fluent and EVO, .NET Framework 4.8 is required but should already be on the PC. To check all supported software and versions, consult the specific driver page which you can find here :doc:`supported_adapters`. Installing the Drivers On-Site ------------------------------ #. You must obtain the .msi installer file for the corresponding lab hardware. These are available through Artificial. #. Either using online storage, like a google drive, or a USB stick loaded with the .msi file, move the installer onto the lab hardware PC. #. Run the .msi installer. This should be straightforward and should place a shortcut on the desktop. #. Start the driver using the shortcut on the desktop or by running :file:`Artificial.[DriverName]ApiServer.exe` directly from the directory :file:`C:/Program Files (x86)/Artificial/[DriverName]Server_Installer/bin`. If this does not work, consult the troubleshooting section. #. Using the two steps in the section below, confirm the driver is working. #. Congratulations, you have successfully completed this guide and installed your driver. Confirming the Driver is Working -------------------------------- If any of these indicators is not working or errors are shown, consult the troubleshooting section below. * First, upon running the driver, a command console window should appear. It should look something like below. It may take a minute, but startup logging information should appear and not contain red error text. .. image:: _static/DriverConsoleExample.png * Second, in a browser, validate the setup by visiting the below URL. If you were successful in your setup, you will see the page populate. Note, by default, the port is 49835 if using http, and for https is 44339. * http://localhost:49835/api/v1/web should show the server log. .. image:: _static/DriverApiPageExample.png Troubleshooting the Installed Driver ------------------------------------ #. Driver gives an error on install. * You may need to be logged in as Administrator or run the installer using the right-click menu option to "Run as Administrator". * You may need to consult with your IT department to confirm you have the correct permissions. #. Installed driver will not start or console window does not appear. * Confirm the console window is not just minimized by checking the Taskbar. * Try running the desktop shortcut as Administrator (using the right-click menu) or run :file:`Artificial.[DriverName]ApiServer.exe` directly as Administrator using the right-click menu. The file can be found in the standard installation directory :file:`C:/Program Files (x86)/Artificial/[DriverName]Server_Installer/bin`. * If the console just flashes briefly, open the Event Viewer application on the PC. In the app, look for the relevant error logs under EventViewer -> Windows Logs -> Application and also, EventViewer -> Windows Logs -> System. Adjust the settings of the PC as per the error. #. Console window displays errors. * If the driver is Fluent or EVOware, confirm .Net Framework 4.8 is installed. * Based on the errors you see in the window, try to adjust the configuration settings as described in the configuration settings page: :doc:`configuring_driver`. * Consult the page for that hardware which can be found here :doc:`supported_adapters` for any configuration specific to that hardware. #. The localhost URLs show errors. * Add rules for the specific port number in the Windows firewall advanced settings. * Change the port number used by the driver as described in the configuration settings page: :doc:`configuring_driver`. For any other problems or if these solutions do not fix your problem, send the error description and the steps tried to Artificial.