TRY NOW
book meeting
BACK TO KB LIST

Unable to use Veeam Agent for IBM AIX after LIBPATH variable has been changed

KB ID: 4273
Product: Veeam Agent for IBM AIX | 1.0 | 2.0 | 3.0 | 4.0 | 4.1 | 4.5 | 4.6 | 4.6.1 | 13
Published: 2022-01-18
Last Modified: 2026-09-21
mailbox
Get weekly article updates
By subscribing, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.

Cheers for trusting us with the spot in your mailbox!

Now you’re less likely to miss what’s been brewing in our knowledge base with this weekly digest

error icon

Oops! Something went wrong.

Please, try again later.

Article Applicability

This article is relevant only to Veeam Agent for IBM AIX 13.0.2.2108 and lower.

Starting in Veeam Agent for IBM AIX v13.1, the software resolves LIBPATH conflicts by configuring necessary aliases.

Challenge

In IBM AIX, it is possible to change the LIBPATH variable globally. However, doing so overrides the library loader domain configuration for all the applications running with system environment on that machine. If the LIBPATH is set to anything other than blank (default), the Veeam Agent for IBM AIX binaries ('veeam', 'veeamconfig', and 'veeamsvc') will fail to operate. 

Example: 
# LIBPATH=/usr/lib /opt/veeam/bin/veeamconfig

Could not load program /opt/veeam/bin/veeamconfig:
Could not load module /opt/veeam/lib/libVmbPlatformLib.so.
        Dependent module /usr/lib/libiconv.a(libiconv.so.2) could not be loaded.
        Member libiconv.so.2 is not found in archive
Could not load module veeamconfig.
        Dependent module /opt/veeam/lib/libVmbPlatformLib.so could not be loaded.
Could not load module .

Solution

To resolve this, implement the workaround below, which will set the LIBPATH variable to an empty (blank) value before running Veeam Agent for IBM AIX binaries.
  1. Create aliases for veeam and veeamconfig binaries so when they are called, they will operate with an empty LIBPATH:
    Note: The veeam binary is new starting in Veeam Agent for IBM AIX build 4.5.0.1616 .
alias veeamconfig="LIBPATH= /opt/veeam/bin/veeamconfig"
alias veeam="LIBPATH= /opt/veeam/bin/veeam"
To preserve this alias so it is not lost on reboot, it should be added to .bash_profile, .bashrc, or one of the system-wide equivalents /etc/profile and /etc/bashrc.
  1. Create an SH file that will set the LIBPATH to blank for starting the service, then make that sh file executable.
    1. Create the following file: /opt/veeam/bin/libpath.sh
    2. Add the following content to the file:
#!/usr/bin/sh
LIBPATH= /opt/veeam/bin/veeamservice
Note: There is a blank space after LIBPATH=
  1. Make the file executable:
chmod +x /opt/veeam/bin/libpath.sh
  1. Stop the veeamsvc service.
stopsrc -s veeamsvc
  1. Remove the veeamsvc service.
rmssys -s veeamsvc
  1. Add the service with the new SH file.
mkssys -s veeamsvc -R -p /opt/veeam/bin/libpath.sh -u 0 -S -n15 -f9
  1. Start the veeamsvc service.
startsrc -s veeamsvc
With these changes in place, the product will operate despite the LIBPATH set system-wide to any other value.
After every Veeam Agent upgrade, the veeamsvc must be recreated as documented in steps 3 and 4.

Updating crontab for Scheduled Jobs

After configuring scheduled jobs, you will need to manually edit the crontab entries using the "crontab -e" command. The entries from crontab will need to have "LIBPATH= " before the veeamconfig command, as shown in this example:

00 7 * * * LIBPATH= veeamconfig job start --id {GUID} --retriable --scheduled --highpriority > /dev/null

If this KB article did not resolve your issue or you need further assistance with Veeam software, please create a Veeam Support Case.

To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.

Spelling error in text

Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please, try again later.

You have selected too large block!

Please try select less.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case
By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
Verify your email to continue your product download
We've sent a verification code to:
  • Incorrect verification code. Please try again.
An email with a verification code was just sent to
Didn't receive the code? Click to resend in sec
Didn't receive the code? Click to resend
Start using Veeam:
Download the product
&
Activate the license key
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please, try again later.