These detailed instructions are indented to help deploy Cassini's Virtual Workstation on a Virtualbox Host machine to use as a target for Remote Test Exec Control via System Message (SM). The Cassini Virtual Workstation appliance (.ova) is intended to run on on a server or workstation with VirtualBox client to host the VM and bridged network configuration for direct access to the guest OS. For more information about the Guest OS, see also ArcaOS, eComStation (eCS), and OS/2. The Cassini user interface requires the operator launch the latest Cassini application by first logging into Guru and then choosing the latest available version from the Short Cuts button. The Db Manager application which listens to TCP port 50050 for System Messages (SM) used to load and start the Test Exec. The VM can be configured with Bridged Mode network to work with a remote development device or Host Only network to connect with the remote control software on the same host (local "offline" development).

1. Download and install the latest version of VirtualBox from their download page.
2. Download the custom "CassiniVM...ova" file linked in a separate message from Roos Instruments.
3. Choose File > Import Appliance... (.ova) and follow the prompts.
4. Choose Machine > Settings > Network, changed Attached To to Bridged Adapter and select the active network connection's Name.
   (Optional: use Host Only networking to work locally. Note: check host OS firewall if there are connection issues)
5. Launch the "CassiniVM ... v#.#" and configure with any OS customization like shared network drives and/or printers, default screen resolution, currently 1280x1024.
   Shared Folders with VirtualBox (RI Virtual Workstation, VBox 6+) https://roos.com/docs/RBEH-8K52LD
   Screen Resolution with Virtualbox (Cassini Virtual Workstation) https://roos.com/docs/RBEH-A9CPVP
6. Notice that Guru and DB Manager are launched automatically at startup.
7. Setup ArcaOS IP Address Settings (Default = DHCP). System Setup > Network > TCP/IP > TCP/IP Configuration > Host Names (set as "RoosRemote_G?????CA", location_GuruID)
8. Once booted, from the Files icon on the ArcaOS task bar, choose the Guru ID from Drives > Drive D > GuruKeys > [GuruID].zip to open the Archive Tool. This activates the selected Guru ID the next time Guru is restarted.
9. Notify the individual managing the Guru ID Licenses for your corporation that this specific Guru ID has been assigned to you. The same Guru IDs should NEVER be used concurrently.
10. Select the blue Extract files to icon (or File > Extract To menu) and enter "D:\" for the destination path, change File Paths to Extract full paths and press Extract button, then Yes to confirm replace existing file.
11. Restart Guru with new ID by choosing the Logon button on Guru, enter "roos inst" :"cathy" and then choose System > Shutdown to close Guru and allow the Startup script to automatically launch Guru.
12. Confirm the newly extracted GuruID matches the Guru Logon prompt; enter "roos inst" :"cathy".
13. Add a new connection (follow steps A for new Guru IDs) or restore the connections from the server (B for already deployed Guru IDs), depending on if this Guru ID has been initialized before.
1. To add Update/Backup Guru Server connections (First Time Install)
1. Choose Apps > Guru Address Book Admin > New Remote Address.
   Name = <Site>Guru, Address = <IP or hostname of guru server>, Address Type = Backup, then press Save.
2. Then select the newly added connection, choose Edit Selected, change Address Type = Update, then Save As.
3. Confirm there are now two entries in the list. Close the Guru Address Book Admin app with File > Exit.
4. Restart Guru again with System > Shutdown. Confirm that it restarts automatically with a green Logon button, indicating a valid Update connection to an Guru exists.
5. Confirm that more Guru Connections were not updated from the server connection by choosing Apps > Guru Address Book Admin and confirming that only two entries exist. If multiple entries exist, use the Delete Selected with the duplicate selected until there is only one "backup" and one "update" connection.
2. To restore Guru Server connections: (Upgrades)
1. Close Ri Guru Startup program by right clicking on the task named "Ri Guru Startup" from the OS task bar or Window List (CTRL + Esc) and choosing Close "Ri Guru Startup" to shutdown Guru.
2. Open a Command Prompt window, type "d: [enter]" then "cd riapps\guruserver [enter]"
3. Type "startApp.cmd -RiBackupGuru <guru hostname> -RiUpdateGuru <guru hostname> [enter]" to start Guru, replacing "<guru hostname>" with the IP or host name of the guru server, no brackets).
4. Choose Logon button on Guru and confirm the assigned Guru ID in the Logon prompt. Enter "Engineer" : "password" and continue. (note: "roos inst" :"cathy" may be disabled as soon as you connect to ADI's guru)
5. Restore Guru settings by selecting System > Restore. This should copy the last version of every guru object "owned" by the Guru ID, including the pair of RiGuruAddress objects. There is no progress bar, but the CPU graph should return to 0 when it completes.
6. Restart Guru (System > Shutdown) and launch Guru Autostart from Desktop > Computer > Startup > Ri GuruServer Startup. Confirm that it restarts automatically with a green Logon button, indicating a valid Update connection to an Guru exists.
14. Restart Guru again with System > Shutdown. Confirm that it restarts automatically with a green Logon button, indicating a valid Update connection to an Guru exists. Shut down the OS.
15. Identify the local IP address by opening a Command Window and typing "ifconfig lan0". Use this as your target IP address/hostname for Remote Control evaluation.
16. Backup this configuration by exporting the newly initialized VM using the File > Export Appliance... menu option and name it "CassiniVM <Location> <GuruID>.ova" (ie. "CassiniVM ADIGT GE267ZCA.ova"). and use this newly created file to recover this initialized Guru VM in the future.

1. Start the "CassiniVM..." and, once booted.
2. Choose Logon and type training for both username and password and choosing OK.
3. Choose Short Cuts and select training - released to launch the Cassini application.
4. Now ready to receive SM messages via a open network connection with TCP port 50060 the IP address.

• Confirm valid IP address with command window, ifconfig lan0.
• Choose Db Manager Guru button to see if Db Manager is running with "Text mode bridge enabled on port: 50060" with a white background, the background of Db Manager will turn yellow if the port is already connected with a previous instance of Db Manager.

Auto-Trial_Execs_v3.gzp