Home    Search    Up    Reference Manuals    Return   

Gensys.2001

Installation of virtual machine Mint193-gensys-2001

Only the necessary steps in the below list needs to be done.
Section 1) can be skipped if you have VirtualBox 6.1.4 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.4, 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.4 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, or choose "none". (The "Host Key Combination" is mainly useful in case you don't have a mouse)
      Finish by clicking "OK"
  2. Download and uncompress the documentation and the verification examples:
    N.B. In this step you will create the directories: free_models, homepage, homepage_theory 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, homepage_theory 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 directory above. Also create a directory where you can keep your own work files.
      E.g.: "analyse"
    3. Download the following files:
      free_models-2001.exe    = Free vehicle models
      homepage-2001.tgz       = Documentation and tutorials
      homepage_theory-2001.exe= Theory
      verif-2001.exe          = Verification directory
      
      The files can be downloaded with the following links: free_models-2001.exe homepage-2001.exe homepage_theory-2001.exe verif-2001.exe
      N.B webpage mega.nz requires a webbrowser that handles HTML5 and allows JavaScript to write files. Currently Chrome and Firefox works best.
      The MD5 message-digest algorithm should give you the following output if all files has been downloaded without errors:
      md5sum *
      8bea10074cc1e7c8ffd5be9d3452cdb5  free_models-2001.exe
      ffa9bc953150cfe4decfe476efe106f4  homepage-2001.exe
      d2b8ca608597e41f5ebe38965acc993a  homepage_theory-2001.exe
      f1b6999af75eb3d13483a160dcf7c0d4  verif-2001.exe
      
    4. Move the downloaded files to your Shared Folder (Users\Public\gensys" or "$HOME/gensys"). Execute the downloaded files, and they will unpack themselves. (If you are extracting the files on a Linux host via "wine". Make sure the exe-files have read and execute permissions)
    5. The files free_models-2001.exe, homepage-2001.exe, homepage_theory-2001.exe and verif-2001.exe can now be removed.
  3. Download and install the virtual machine:
    1. Download the following self-extractors:
      Mint193-gensys-2001.exe        = The virtual machine
      Mint193-gensys-2001.7z.00[1-5] = Sub-files to Mint193-gensys-2001.exe
      The files can be downloaded with the following links:
      Mint193-gensys-2001.exe
      Mint193-gensys-2001.7z.001
      Mint193-gensys-2001.7z.002
      Mint193-gensys-2001.7z.003
      Mint193-gensys-2001.7z.004
      Mint193-gensys-2001.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. The MD5 message-digest algorithm should give you the following output if all files has been downloaded without errors:
      md5sum *
      412b53c2de58f511d02f2a47dbfe57b7  Mint193-gensys-2001.7z.001
      928b0f85dd48b8a1e01bf9760a4df91d  Mint193-gensys-2001.7z.002
      e0ce907fac765e8d5015bb7fbb9e278f  Mint193-gensys-2001.7z.003
      b891c95e65c295e15d58417c55bccbce  Mint193-gensys-2001.7z.004
      6383495b614f94391d0c5c5a9d7ff4eb  Mint193-gensys-2001.7z.005
      c01b5bc40aa5bc2ea388b0e80227999b  Mint193-gensys-2001.exe
      
    2. Contact info@gensys.se to get a link to a valid license file for your installation.
    3. 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. Move file Mint193-gensys-2001.exe and its sub-files to the directory containing your virtual machines ("C:\Users\Public\VirtualBox VMs" or "$HOME/VirtualBox VMs"). File Mint193-gensys-2001.exe is a self-extractor file. Execute the file and the whole virtual machine will be unpacked. (If you are extracting the files on a Linux host via "wine". Make sure the exe-files have read and execute permissions)
    5. Go to directory Mint193-gensys-2001 created by Mint193-gensys-2001.exe. Start the virtual machine by double-clicking file Mint193-gensys-2001.vbox.
    6. Activate Shared Clipboard
      Mark virtual machine "Mint193-gensys-2001" and click "Settings".
      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
    7. Set primary memory
      Mark virtual machine "Mint193-gensys-2001" and click "Settings".
      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". Recommended size of primary memory is 1500MB - 2000MB. Choosing too high value can lead to slow a execution, because the host machine may start swapping its memory.
    8. Set number of processors
      Mark virtual machine "Mint193-gensys-2001" and click "Settings".
      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 with green.
    9. Activate Shared Folders
      Mark virtual machine "Mint193-gensys-2001" and click "Settings".
      On the left side in the popup-window select "Shared Folders"
      On the right side select "gensys /home/gensys/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
      Check "Make Permanent" (if the option is visible)
      If option "Mountpoint" is visible write "gensys" in this field.
      Click OK
    10. Start the virtual machine by clicking the green arrow marked "Start" in the VirtualBox main window.
    11. Install Gensys license file.
      Start webbrowser firefox in the virtual machine. Enter the link mentioned under 2) above, and download the file. Save the license file in directory "/opt/gensys/gensys-2001/bin".
      Add execute permissions to file gen_processor_ID_check:
      chmod +x /opt/gensys/gensys-2001/bin/gen_processor_ID_check
      
    12. 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, restart the virtual machine.
      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".
    13. File Mint193-gensys-2001.exe and its sub-files can now be removed.
    14. Unfortunately it has shown that copy & paste between host and guest computer with the VirtualBox 6.1.4 Guest Additions don't work. One way of solving this problem is to download: VBoxGuestAdditions_6.1.5-136459.iso
      After downloading the iso image. Do the following steps:
      1. Create a mount point e.g.: sudo mkdir /mnt/iso
      2. Mount the ISO file: sudo mount -o loop VBoxGuestAdditions_6.1.5-136459.iso /mnt/iso
      3. Verify it's mounted: df
      4. Go to /mnt/iso and run autorun.sh: cd /mnt/iso; ./autorun.sh; cd -
      5. Unmount the ISO file: sudo umount /mnt/iso/
      6. Restart your virtual machine.
Troubleshooting

If you have problems with file downloading.
Please check the following:

After installation

Please test your installation by running the tutorial examples: README




Gen_calclib

  1. New wheel/rail-coupling coupl creep_fasim_4

Gplot

  1. Read the new GPdat-format 2001 which is easier to read and it handles up to 10 contact patches simultaneous in contact.

Mplot

  1. In addition to curves, also accept scalars, constants and negative variables in command "print".