document labview installation

2024-09-04 16:45:08 +02:00
parent b07c3d9aeb
commit ccc4ecdc3c
1 changed files with 97 additions and 3 deletions
--- a/admin-guide/configuration/labview.md
+++ b/admin-guide/configuration/labview.md
@@ -1,8 +1,102 @@
 # LabView

-We have a site license for LabView, so you can download the software directly from the [NI Portal](https://www.ni.com/en/support/downloads/software-products).
+We have a site license for LabView, the license server is `lic-ni.psi.ch:27020`.

-Please register with your PSI email address.

-The License server is `lic-ni.psi.ch:27020`.
+## Installation of LabView
+
+Select the desired version on the [NI Download Portal](https://www.ni.com/en/support/downloads/software-products/download.labview.html#544131).
+
+It downloads a zip file which you need to extract and to install the rpm file according to your OS, e.g.:
+
+```
+sudo dnf install ni-labview-2024-pro-24.3.1.49155-0+f3-rhel9.noarch.rpm
+```
+
+This now installs the package repository for given LabView version. Now it is just left to install it
+
+
+```
+sudo dnf install ni-labview-2024-pro
+```
+
+Note that by default the package repository file will be removed by the next Puppet run.
+To avoid this set `rpm_repos::purge: false` in Hiera or check the chapter "Installation via Puppet and Hiera".
+
+## Installation of LabView Drivers
+
+Again select you desired version on the [NI Download Portal] (https://www.ni.com/en/support/downloads/drivers/download.ni-linux-device-drivers.html#544344).
+
+Again it downloads a zip file you need to extract and then install the suitable rpm file, e.g.:
+
+```
+sudo dnf install ni-rhel9-drivers-2024Q3.rpm
+```
+
+This now installs the package repository for the drivers. Next install the needed drivers, e.g.
+
+```
+sudo dnf install ni-488.2
+```
+
+Now the kernel drivers need to be prepared
+
+```
+sudo dkms autoinstall
+```
+
+and finally reboot to prepare everything for showtime.
+
+
+Note that by default the package repository file will be removed by the next Puppet run.
+To avoid this set `rpm_repos::purge: false` in Hiera or check the next chapter "Installation via Puppet and Hiera".
+
+
+## Installation via Puppet and Hiera
+
+Above example could also be configured with Hiera:
+
+```
+rpm_repos::repo::labview:
+    name: 'labview'
+    descr: "NI LabVIEW 2024 Q3 pro"
+    baseurl: 'https://download.ni.com/ni-linux-desktop/LabVIEW/2024/Q3/f1/pro/rpm/ni-labview-2024/el9'
+    gpgkey: 'https://download.ni.com/ni-linux-desktop/stream/ni-linux-desktop-2019.pub'
+    disable: false
+    gpgcheck: false
+    repo_gpgcheck: true
+
+rpm_repos::repo::labview_drivers:
+    name: 'labview_drivers'
+    descr: "NI Linux Software 2024 Q3"
+    baseurl: 'https://download.ni.com/ni-linux-desktop/2024/Q3/rpm/ni/el9'
+    gpgkey: 'https://download.ni.com/ni-linux-desktop/stream/ni-linux-desktop-2019.pub'
+    disable: false
+    gpgcheck: false
+    repo_gpgcheck: true
+
+rpm_repos::default:
+    - 'labview'
+    - 'labview_drivers'
+
+base::pkg_group::labview:
+  - 'ni-labview-2024-pro'
+  - 'ni-488.2'
+
+base::package_groups:
+  - 'labview'
+```
+
+The main difficulty is to figure out the repository URLs, which is easiest done by the manual download, unpack and install the rpm file. Or by inspecting its content.
+
+But with this Hiera configuration the setup can easily be replicated to other machines or to recreate the current setup.
+
+What still needs to be done on first installation and cannot be automated with Puppet is:
+Now the kernel drivers need to be prepared
+
+```
+sudo dkms autoinstall
+```
+and the following reboot.
+