Install Wandelbots NOVA
Installing Wandelbots NOVA means to commission and prepare the physical robot environment, to set up the selected instance and to install the Wandelbots NOVA Foundation Services on an instance type of your choice.
Prerequisites
- Ensure that you're using a fast broadband connection.
- Ensure that you're using a personal computer that was designed after 2015 for communication and stability purposes.
- Open the terminal on your personal computer.
Select instance
Depending on whether you want to use Wandelbots NOVA in a productive environment, different instance types are recommended.
- Only physical instances / IPC are suited to run in production lines.
- Cloud instances and virtual machines are suited to develop robotic applications and test with physical robots.
Cloud instance
On cloud instances provided via the Developer Portal, Wandelbots NOVA is already installed.
- Start a cloud instance via the Developer Portal (opens in a new tab).
You can directly start using Wandelbots NOVA.
Virtual machines and physical instances / IPCs
You can install Wandelbots NOVA on virtual machines and physical instances / IPCs. Wandelbots NOVA runs on top of AlmaLinux therefore AlmaLinux will be installed within the process of installing NOVA.
Processor requirements
- CPU: 8 cores
- RAM: 16 GB
- HDD: 250 GB in /var/lib/rancher
- NET: 1 Gbit network connection with access to the web
Prerequisites
Have a USB-stick with 4 GB free disk space, a USB cable keyboard, USB cable mouse and a display with DP cable at hand.
The physical instance has to be supported by Wandelbots NOVA.
-
Download the Wandelbots NOVA ISO from the Download center in the Developer Portal. Plug the USB-Stick into your personal computer and copy the Wandelbots NOVA image onto the USB stick a software for writing image files.
-
Plug the USB-stick into the physical instance.
-
Connect your physical instance/IPC to the internet by plugging a regular ethernet cable into its LAN-3 port.
-
Connect the physical instance to power, to the display, and keyboard. Further information about ports and interfaces can be found in the manufacturer's original documentation.
-
Press F12 when turning the IPC on to open the boot menu.
After a couple of seconds, a device list is displayed. -
Select your USB stick out of the device list (most likely, the name refers to its manufacturer and starts with
UEFI
). -
Select "Install Wandelbots NOVA" from the boot menu to start the installation process.
Installation process
Installation of AlmaLinux
First, the operating system required for Wandelbots NOVA, AlmaLinux, is installed. The unattended installation can take up to 15 minutes.
A reboot will occur automatically once the installation succeeded.
Save the user credentials & IP address
After the installation of AlmaLinux is successfully completed, you'll be prompted to log in.
Ignore the login prompt on the screen!
The instance's name, the IP address and the first user credentials are displayed on the screen (connected to the physical instance/IPC).
Remember to keep the displayed user name and password at hand.
Install Wandelbots NOVA
- Switch to the personal computer's terminal and connect to the instance via SSH by
enteringssh <instance-username>@<instance-ip-address>
into the terminal.
Replace<instance-username>
and<instance-ip-address>
with the instance's name and IP address. - Log in with the user credentials displayed on the screen (connected to the physical instance/IPC).
You're then prompted to set a new password.
If you've successfully set your password, you're logged out automatically and are prompted to log in with your password.
In case you forget your password, contact Wandelbots GmbH Customer Support. For password retrievals of physical instances, Customer Support has to be on site.
- Enter
ssh <instance-username>@<instance-ip-address>
into the terminal AGAIN. Replace<instance-username>
and<instance-ip-address>
with the instance's name and IP address. You're prompted to confirm the installation start. - Confirm the installation start with Y and Enter.
You're prompted to enter the license key. - Copy and paste the license key starting with "dckr_pat" from the Developer Portal's download section on the "Download Wandelbots NOVA" card.
- Start the installation with Enter.
The installation starts. The installation process can take up to 3 minutes. After the installation is completed, a link to the Wandelbots NOVA home screen of your instance is displayed. - Open your instance's home screen.
Optional: Connect to a physical robot
CAUTION
Danger in case of insufficient qualification of users
People can be injured if unqualified user groups set up the physical robot environment.
- Only qualified user groups designated by the operating company may set up the physical robot environment.
- Keep unqualified user groups away from the area of risk.
If you want to connect Wandelbots NOVA to one or more physical robots, use our cell setup blueprints and setup instructions to set up your physical robot environment.
Connect the robot to the configured network port. Per default, this is enp3s0
, matching LAN1, unless configured otherwise during the installation of AlmaLinux.
Ensure that the physical robot and the IPC are within the same subnet.
Congrats! You have successfully installed Wandelbots NOVA. 🎉
Continue by connecting your physical setup to Wandelbots NOVA or set up a virtual programming environment by adding a virtual robot to your cell.