Single Component

Single Component#

This tutorial explains how a virtual machine for one of these components is created based on the base image described here.

VirtualBox#

Import the base image#

Import the machine (File -> Import Appliance) with the following settings:

  • Tick only the network adapter checkbox.

  • MAC Address Policy: Include only NAT network adapter MAC addresses.

Create a Component Specific Folder in the Shared Folder#

Create a folder called SharedFolder on the host system and change the shared folder path under Settings -> Shared Folders to the new folder. In this new folder, create a component specific folder with one of the following names depending on the desired component:

  • aasdiscoveryservice

  • aasenvironment

  • aasregistry_service_release_log_mem

  • aasrepository

  • conceptdescriptionrepository

  • submodelregistry_service_release_log_mem

  • submodelrepository

Enable Port Forwarding (for VirtualBox)#

Create a new entry in the port forwarding list (Settings -> Network -> Adapter 1 -> Advanced -> Port Forwarding) with the following properties:

  • Host IP: 127.0.0.1

  • Host Port: <port>

  • Guest IP: 10.0.2.15

  • Guest Port: <port>

Alpine Linux#

The scripts used in the following can be found here.

Create a Component Folder on the Virtual Machine#

Execute:

mkdir /home/basyx_<component>

Place the Setup and Startup Scripts on the Virtual Machine#

Place basyx_<component>_setup.sh and basyx_<component>_startup.sh in the shared folder on the host system and execute:

mv /mnt/shared/basyx_<component>_setup.sh /home/basyx_<component>
mv /mnt/shared/basyx_<component>_startup.sh /home/basyx_<component>

Registry components have only a startup script.

Activate Automatic Execution of the Setup and Startup Scripts#

Add the following lines to crontab -e to the already existing line from the base image setup:

@reboot <base image command> && /bin/sh /home/basyx_<component>/basyx_<component>_setup.sh ; /bin/sh /home/basyx_<component>/basyx_<component>_startup.sh > /dev/tty1

Registry components have only a startup script.

Place the Executable on the Virtual Machine#

Place the .jar file of the respective component in the shared folder on the host system and execute:

mv /mnt/shared/<component>.jar /home/basyx_<component>

Export the Virtual Machine#

Export the machine as an ova file (File -> Export Appliance) with the following properties:

  • Format: Open Virtualization Format 1.0

  • MAC Address Policy: Include only NAT network adapter MAC addresses.

  • Appliance Settings: Tick only the network adapter checkbox.