Skip to content

08-extras.md

Latest commit

 

History

History
131 lines (112 loc) · 6.61 KB

08-extras.md

File metadata and controls

131 lines (112 loc) · 6.61 KB

Extra Utilities

1. Wine

For running simple Windows tools without a full VM.

Wine Installation Guide (Ubuntu Users)

sudo apt-get install wine-stable 
sudo apt install winetricks ttf-mscorefonts-installer

Install newest Version of wine:

https://ubuntuhandbook.org/index.php/2026/01/wine-11-0-released-how-to-install/

sudo mkdir -p /etc/apt/keyrings
wget -O - https://dl.winehq.org/wine-builds/winehq.key | sudo gpg --dearmor -o /etc/apt/keyrings/winehq-archive.key
sudo wget -NP /etc/apt/sources.list.d/ https://dl.winehq.org/wine-builds/ubuntu/dists/noble/winehq-noble.sources
sudo apt update
sudo apt install --install-recommends winehq-stable

NET Framework 4.8 Compatibitlity

Running net 4.8 applications in Wine by creating a separate wine prefix with win32 or win64. (We recommend win64). Microsoft Data Access components must also be installed otherwise mono uses a Oracle provider when connecting to an SQL-Server.

32-bit OS:

WINEPREFIX="$HOME/.wine-dotnet48" WINEARCH=win32 winecfg

64-bit OS:

WINEPREFIX="$HOME/.wine-dotnet48" WINEARCH=win64 winecfg

Install dotnet (don't use the default wine-mono, because it lacks of 100% compatibility!)

WINEPREFIX="$HOME/.wine-dotnet48" winetricks -q dotnet48
WINEPREFIX="$HOME/.wine-dotnet48" winetricks mdac28

Important notes for using iPlus-framework applications V4 (net48)

There is an issue when iPlus is started and have to read the metadata files. To get it running the absolute path to the metadata has to be set. And backslashes must be set twice because linux interprets it as an escape character! Here an example:

    <add name="iPlusMESV4_Entities" connectionString="metadata=C:\\iPlus\V4\\Dostofarm\\Debug\\iplusmesv4.csdl|C:\\iPlus\V4\\\Dostofarm\\\Debug\\iplusmesv4.ssdl|C:\\iPlus\V4\\Dostofarm\\Debug\\iplusmesv4.msl;provider=System.Data.SqlClient;provider connection string=&quot;data source=gipDLVmSQL1.incus;initial catalog=DostofarmV4;persist security info=True;user id=gip;password=netspirit;MultipleActiveResultSets=True;Asynchronous Processing=True;App=iPlus_dbApp&quot;"
    providerName="System.Data.EntityClient" />

Starting applications

  • Run 
    WINEPREFIX="/home/yourusername/.wine-dotnet48" wine gip.variobatch.client.exe
  • Read or log debug output examples 
    WINEPREFIX="/home/yourusername/.wine-dotnet48" WINEDEBUG=+file wine gip.variobatch.client.exe 2>&1 | grep "csdl|ssl|msl"
WINEPREFIX="/home/yourusername/.wine-dotnet48" WINEDEBUG=+file wine gip.variobatch.client.exe > debug_paths.log 2>&1

Issues with Rendering KDE/Wayland (Black Context Menu)

```bash
WINEPREFIX="/home/yourusername/.wine-dotnet48" winetricks ddr=gdi
```

Printing

  • PDF and XPS-Utils XPS-Utils are needed, because iPlus prints with XPS: 
    sudo apt install printer-driver-cups-pdf
sudo apt install libcups2:i386
sudo apt install libgxps-utils
sudo apt install libcups2:i386 libpaper1:i386 libpango-1.0-0:i386
  • GENERIC CUPS-PDF Printer Open Printer Settings and select "GENERIC CUPS-PDF Printer (no options)" as driver
  • DISABLE XPS Object Model This is necessary if you have set WINEs Windows Profile to >= Win 10. Modern Windows versions (10/11) enable the XPS OM path by default because they support the underlying COM interfaces. Wine's implementation of these newer interfaces (likely in prntvpt.dll or similar) may be incomplete, leading to a CreateXpsOMSerializationManager() exception. Set this registry key in wine: 
    WINEPREFIX="/home/yourusername/.wine-dotnet48" wine reg add "HKCU\Software\Microsoft\DotNet\Printing" /v DisableXpsOmPrinting /t REG_DWORD /d 1 /f

Scaling

Open Wine config and set scaling to 120dpi:

WINEPREFIX="/home/yourusername/.wine-dotnet48" winecfg
WINEPREFIX="/home/yourusername/.wine-dotnet48" winetricks settings fontsmooth=rgb

Useful wine commands

  • wineserver -k: Kills all Windows apps (simulates a hard power-off/reboot).
  • wineserver -w: Waits until all Windows apps in the prefix have exited.
  • wineboot -r: Simulates a reboot of the Windows system.
  • wineboot -i: Initializes the wineprefix. (resets settings!)
  • winecfg: Opens the configuration dialog for wine
  • wine regedit: Opens the registry editor
  • wine cmd: Opens the command window
  • wine control: Opens the control panel (Internet options, installed software)

iPlus in Startmenu

  1. Open KDE Menu Editor
  2. Add a new entry
  3. Set Parameters (example)
    • Environment: WINEPREFIX=/home/yourusername/.wine-dotnet48/
    • Application: wine
    • Arguments: '/home/yourusername/SHARED/Devel/iPlusGit/V4/iPlusMES/bin/Debug/gip.mes.client.exe'

Fonts

If you have a Windows Installation just copy the fonts from "C:\Windows\Fonts" to your linux folder "/usr/local/share/fonts/". (According to MS EULA this is not allowed 🙈)

iPlus Property log

iPlus uses Manages Esent for logging of property values. Therefore the Esent.Interop.dll needs the esent.dll from the System32 Directory. This esent.dll is a complex database engine core to Windows. Wine's version of this DLL is often a "stub," meaning the file exists but the actual code inside JetCreateInstance is empty or just returns an error code that .NET then translates into an exception.

  1. Therefore copy the original esent.dll from a Win 10 or Win 11 installation into the directory of your wine prefix. For instance
    • in the example prefix from above "/home/yourusername/.wine-dotnet48/drive_c/windows/system32/" (legacy V4 Version of iplus)
    • or the standard prefix "/home/yourusername/.wine/drive_c/windows/system32/" if you run there the net core Version V5 of iPlus.
  2. Then run winecfg in your wine prefix.
  3. Go to the Libraries tab.
  4. Type esent in the "New override for library" box and click Add.
  5. Ensure it is set to (native, builtin). This tells Wine to use the real Windows file you just provided instead of its own stub.

DEBUGGING 🐞

  1. Download dnSpy
  2. Start dnSpy ( in the same wine-prefix as you have started iPlus. For iPlus V5 (net core) you must use the win64 Version. For iPlus V4 you can also use the win64 Version or the netframework version of dnSpy.

2. Microsoft Teams

Use the unofficial "Teams for Linux" client which wraps the web version effectively. GitHub: Teams for Linux

3. Thunderbird

Standard email client setup. Mozilla Support