If you are missing VirtualBox or if your VirtualBox-version is older than 6.1.30, it is necessary to do these steps:
-
Make sure your machine is equipped with a 64-bits processor.
Primary memory > 1 GB
Free hard disk space > 55 GB
Restart your machine and check in your BIOS that Virtualization Technology is enabled.
Information on how to adjust BIOS-settings can be found here: wikihow or lifewire - If necessary, uninstall the old VirtualBox-version.
- Download and install VirtualBox version 6.1.30 or newer.
-
Start program VirtualBox
-
In the PullDown-menu of program VirtualBox click "File -> Preferences"
On the left side in the popup-window select "Input"
On the right side select "Virtual Machine"
As default in VirtualBox "Host Key Combination" is set equal to Right CTRL. If you wish to be able to use your "Right CTRL"-Key, please choose another key. (The "Host Key Combination" is mainly useful in case you don't have a working mouse, and when you want to leave full screen mode)
Finish by clicking "OK"
N.B. In this step you will create the following three directories: free_models, homepage and verif. If you have old versions of these directories, they will be overritten.
If you want to keep your old versions of free_models, homepage and verif. You can skip this part, or you can uncompress the files at another location, and then compare the directories with each other using script opdiff_dir.
-
Create a directory where you want to keep Gensys documentation files, verification examples
and your own workfiles.
The directory must have permissions so it can be used as a Shared Folder with the virtual machine.
E.g.: "C:\Users\Public\gensys" on a Windows-host or "$HOME/gensys" on a UNIX-host. -
In the newly created work directory.
Also create a directory where you can keep your own work files.
E.g.: "analyse" -
Download the following files:
free_models-2201.7z = Free vehicle models homepage-2201.7z = Documentation and tutorials verif-2201.7z = Verification directory
Webpage mega.nz requires a webbrowser that handles HTML5 and allows JavaScript to create and write to files. Currently Chrome and Firefox works best.
Also make sure that no firewall prevents you from downloading files from the Internet.
The SHA256 message digest algorithm should give you the following output:3a2499c8bc768565e077a582086b108cabbbb74b439e6968563a8d4553e34895 free_models-2201.7z 11dfaf8cf3dc3d26e484f84959efcca39d2ec89b9eee972449b969c423d9a72c homepage-2201.7z 55986bbd7e32f0fd62b373adc5b5412190ee3c44d8d03783908728b4059bfc89 verif-2201.7z
The above output can be created with the following commands:
UNIX: sha256sum [a-z]*7z
Windows: certutil.exe -hashfile free_models-2201.7z SHA256 certutil.exe -hashfile homepage-2201.7z SHA256 certutil.exe -hashfile verif-2201.7z SHA256
-
Move the downloaded files to your Shared Folder (E.g. C:\Users\Public\gensys" or "$HOME/gensys").
Uncompress the files in program that handle 7-zip files.
(If you don't have a program for 7-zip files,
you can download a program with this link: www.7-zip.org/download.html)
When unzipping the 7-zipped files, please uncheck the checkbox under "Extract to:", otherwise the zipped files will not be extracted to the correct location. E.g.:
After 7-zipped files have been unzipped your directory should look as follows:
- The files free_models-2201.7z, homepage-2201.7z and verif-2201.7z can now be removed.
-
Download the following 7-zip files:
Mint203-gensys22.7z.001 Mint203-gensys22.7z.002 Mint203-gensys22.7z.003 Mint203-gensys22.7z.004 Mint203-gensys22.7z.005
N.B webpage mega.nz requires a webbrowser that handles HTML5 and allows JavaScript to write files. Currently Chrome and Firefox works best.
Also make sure that no firewall prevents you from downloading files from the Internet.
The SHA256 message digest algorithm should give you the following output:43d296b7787ba0cfe39d1790da86f8df6e6f3e4d2cb6dda2ec9d3c80cc5efbd8 Mint203-gensys22.7z.001 dbc2e88e31823450058db92861c9e1105a054a93080ceb30f7e031b3451f5785 Mint203-gensys22.7z.002 876002ed7110a3394677106549cd1e46d348cc1c3eb20d4fcbca2842811d2008 Mint203-gensys22.7z.003 0d331617db8d4676458245fefa6a9d88f00475c40454b927231f60638e41d689 Mint203-gensys22.7z.004 458f029f7318ab339abdf712eeef59d852978fb3d2158375eabef028046f8651 Mint203-gensys22.7z.005
UNIX: sha256sum Mint203-gensys22.7z.00?
Windows: certutil.exe -hashfile Mint203-gensys22.7z.001 SHA256 certutil.exe -hashfile Mint203-gensys22.7z.002 SHA256 certutil.exe -hashfile Mint203-gensys22.7z.003 SHA256 certutil.exe -hashfile Mint203-gensys22.7z.004 SHA256 certutil.exe -hashfile Mint203-gensys22.7z.005 SHA256
- Contact info@gensys.se to get a link to a valid license file for your installation.
-
Create a directory for your virtual machines.
If you are installing a virtual machine for the very first time. Please create a directory to store your virtual machines in. E.g.: "C:\Users\Public\VirtualBox VMs" on a Windows-host or "$HOME/VirtualBox VMs" on a UNIX-host.
-
Uncompress the file archive.
Move the five files downloaded under 3.1) to the location created under 3.3).
Mark file "Mint203-gensys22.7z.001" and with your right mouse button and select 7z -> Open Archive -> Extract.
After the virtual machine has been extracted, the five files "Mint203-gensys22.7z.00[1-5]" can be removed.
(If you don't have a program for 7-zip files, you can download a program with this link: www.7-zip.org/download.html)
When unzipping the 7-zipped files, please uncheck the checkbox under "Extract to:", otherwise the zipped files will not be extracted to the correct location. E.g.:
After 7-zipped files have been unzipped your directory should look as follows:
-
Setup the virtual machine.
Go to the newly created directory "Mint203-gensys22". Start VirtualBox by double-clicking file "Mint203-gensys22.vbox".
Mark the virtual machine "Mint203-gensys22" and click "Settings".-
Activate Shared Clipboard
On the left side in the popup-window select "General"
On the right side select "Advanced"
Under "Shared Clipboard" choose Bidirectional
Under "Drag'n'Drop" choose Bidirectional -
Set primary memory
On the left side in the popup-window select "System"
On the right side select "Motherboard"
Choose how much primary memory the virtual machine will have access to with the scale "Base Memory". Minimum recommended size is 1280MB. Maximum recommended size depend on the size of the primary memory of your host computer. You must choose a size within the green marked area of the scale. -
Set number of processors
On the left side in the popup-window, select "System"
On the right side, select "Processor"
Set number of processor(s) of your machine.
Valid number of processors are marked in green. -
Activate Shared Folders
On the left side in the popup-window select "Shared Folders"
On the right side select "gensys D:\gensys"
Click right mouse button and select "Edit Shared Folder"
Change "Folder Path" so it points to your "Shared Folder"-location. See under "Download and uncompress the documentation and the verification examples" above.
Folder Name: "gensys" must not be changed (N.B. Folder Name is case sensitive)
Do not check "Read-only".
Do not check "Auto-mount".
Leave text field "Mount point" blank
Check "Make Permanent" (if the option is visible)
Click OK
-
Activate Shared Clipboard
- In the VirtualBox main window, start the virtual machine by clicking the green arrow marked "Start"
-
Install Gensys license file.
Start webbrowser firefox in the virtual machine. Enter the link mentioned under 3.2) above, and download the file. Save the license file in directory "/opt/gensys/gensys-2201/bin".
Add execute permissions to file gen_processor_ID_check:
chmod +x /opt/gensys/gensys-2201/bin/gen_processor_ID_check
-
Configure the slurm queue system by editing file: /etc/slurm-llnl/slurm.conf
Under "NodeName", set number of available processors for each node in the cluster.
If you have many machines in your cluster, command "NodeName" can be given multiple times.
After the file /etc/slurm-llnl/slurm.conf has been updated, the virtual machine must be restarted in order to make the changes to take effect. In a terminal window: Test slurm by running program "/bin/hostname" via command sbatch:sbatch --output=sbatch.out <<+ #!/bin/sh /bin/hostname +
Output from the command will be sent to file sbatch.out
If file sbatch.out don't appear in your current work directory. Check if you can see the job in the Slurm graphical user interface:
sview &
If the status of the job is "PENDING". Open program "Oracle VM VirtualBox Manager" and go to Settings -> System -> Processor, and check that number of processors are greater or equal to the number defined in file /etc/slurm-llnl/slurm.conf.
If not, update file /etc/slurm-llnl/slurm.conf again, or shutdown the virtual machine and update number of processors in "Oracle VM VirtualBox Manager".