Home    Search    Up    Reference Manuals    Return   

Gensys-2201

Installation of virtual machine "Mint203-gensys22"

Only the necessary steps in the below list needs to be done.
Section 1) can be skipped if you have VirtualBox 6.1.30 or newer already installed on your computer.
Section 2) can be skipped if you don't want to update the documentation and the verification examples.

  1. Install and configure program VirtualBox:
    If you are missing VirtualBox or if your VirtualBox-version is older than 6.1.30, it is necessary to do these steps:
    1. 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
    2. If necessary, uninstall the old VirtualBox-version.
    3. Download and install VirtualBox version 6.1.30 or newer.
    4. Start program VirtualBox
    5. 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"
  2. Download and uncompress the documentation and the verification examples:
    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.
    1. 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.
    2. In the newly created work directory. Also create a directory where you can keep your own work files.
      E.g.: "analyse"
    3. 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
    4. 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: □
    5. The files free_models-2201.7z, homepage-2201.7z and verif-2201.7z can now be removed.
  3. Download and install the virtual machine:
    1. 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
    2. Contact info@gensys.se to get a link to a valid license file for your installation.
    3. 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.
    4. 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: □
    5. 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".
      1. 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
      2. 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.
      3. 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.
      4. 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
    6. In the VirtualBox main window, start the virtual machine by clicking the green arrow marked "Start"
    7. 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
      
    8. 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".
After installation

Please test your installation by running the tutorial examples: README




Updates in the new machine

Gen_calclib

  1. In earlier Gensys-releases the length of each transition curve must be at least 2[m] long. In release Gensys-2201 the user has the possibility to define the keyword "e_abs_bend_ds". Which specifies the minimum length of the transition curves.
  2. Wheel/rail-coupling func wr_coupl_pra3 evaluates wear velocity versus lateral position on the wheel. The output is written to the external file ["id/" $IDENT "_pra3.m"]. Where $IDENT is the name of current ident.
  3. Two new couplings k12_f and c12_f which can be used for connecting masses of type m_rigid_12.

Kpf

  1. Higher accurancy and more robust code when calculating rofn