search

exasol / bucketfs-client

Command line client for BucketFS
MIT License
2 stars 1 forks source link

Improvement ideas for the User Guide #38

Open allipatev opened 3 months ago

allipatev commented 3 months ago
  1. Markup for the hyperlink near "SuSE: OpenJDK build of the Leap project" is seemingly broken.
  2. The tool seems to have quite a wide set of requirements. In my Ubuntu 22.04 running in a VirtualBox VM (host system is Windows 11) it's failing with 
    alex@alex-VirtualBox:~$ /home/alex/Downloads/bfsc-linux_x86 ls bfss://localhost:2581/default
The current machine does not support all of the following CPU features that are required by the image: [CX8, CMOV, FXSR, MMX, SSE, SSE2, SSE3, SSSE3, SSE4_1, SSE4_2, POPCNT, LZCNT, AVX, AVX2, BMI1, BMI2, FMA].
Please rebuild the executable with an appropriate setting of the -march option.alex@alex-VirtualBox:~$
  3. A trailing newline after the error message above would be useful.
  4. It is not crystal clear from the User Guide if the native executable supports "Linux" or "Ubuntu Linux".
  5. Again to wide system requirements, on Rocky Linux release 8.9 (Green Obsidian) the tool fails with 
    $ ~/Downloads/bfsc-linux_x86 bfsc ls bfss://localhost:2581/default
<path>/bfsc-linux_x86: /lib64/libc.so.6: version `GLIBC_2.32' not found (required by <path>/bfsc-linux_x86)
<path>/bfsc-linux_x86: /lib64/libc.so.6: version `GLIBC_2.34' not found (required by <path>/bfsc-linux_x86)

  6. For release 1.1.2 this is Ubuntu 22.04 with glibc 2.32.

Maybe one can refresh this part (the latest version is 2.0.0)?

  1. "Retrieving the Password" section. /exa/etc/EXAConf is not a publicly available interface. Luckily, one can use ConfD job bucketfs_info.
ckunki commented 1 month ago

Notes for potential updates to the documentation:

The version of glibc installed on a linux system can be inquired with 

$ ldd --version

Which will print ldd (GNU libc) 2.38 for example.

https://askubuntu.com/questions/1345342 describes how to install a different version of glibc

Note: The error message described above is displayed by the operating system or the glue code generated by the binary generator, see raalvm/setup-graalvm. Exasol bucketfs-client can probably not change the formatting of the error message, e.g. insert a newline.

See graalvm, native-image, BuildOptions for build options to Graal VM, that could be added to the command native-image in GitHub workflow native-image.yml.

-march: generate instructions for a specific machine type. Defaults to x86-64-v3 on AMD64 and armv8-a on AArch64. Use -march=compatibility for best compatibility, or -march=native for best performance if a native executable is deployed on the same machine or on a machine with the same CPU features. To list all available machine types, use -march=list.

redcatbear commented 4 weeks ago

@ckunki , please fill custom fields and add to next Kehrwoche.