llvupdate command

Purpose

Performs the Live Library Update (LLU) operation for the specified processes without a downtime for workloads.

Syntax

Preview mode

llvupdate -P -l <logfile>

Execution mode

llvupdate -p '<pid1> <pid2>...'  [ -n <retries> ] [ -t <timeout> ] [ -l <logfile> ]

llvupdate -a -l <logfile> -t <timeout> -n <retries>

llvupdate -a -e '<pid1> <pid2>...'  [ -n <retries> ] [ -t <timeout> ] [ -l <logfile> ]

Description

The llvupdate command performs the LLU operation that eliminates the downtime for workloads when the AIX operating system is updated.

Before you start updating the library, you can run the llvupdate command in the preview mode. The command output in preview mode provides a list of LLU-capable processes that have at least one LLU-capable library that is newer than the library that is used by the process.

You can run the llvupdate command in the following scenarios:

After the Live Update operation. You can use the llvupdate command to update the libraries for the running processes while the workloads are running on the surrogate logical partition.
As an independent operation. If the updated versions of LLU-capable libraries are available in the form of service updates or interim fixes, you can run the llvupdate command to update the libraries without downtime.

Note:

Only the root user can run the llvupdate command.
You cannot run the llvupdate command separately when a Live Update operation is in progress. For more information about all restrictions, see restrictions of using llvupdate command for LLU operation.

Flags

-h

Displays help information about the command, various flags, and available options.

-P

Specifies the preview mode.

The command scans all the running processes on the system. It checks the currently loaded library by the system and compares it to the currently installed libraries. The command displays processes that are LLU-capable and also reports the processes that have an LLU operation in progress.

-p '<pid1> <pid2> …'

Initiates the Live Library Update for the specified processes. When you use the -p flag, the llvupdate command monitors the progress of the LLU operation of each process and stops the operation for any process that does not complete the update operation within the timeout period.

-a

Performs the same function as the -p flag except that this flag scans all the processes and initiates the Live Library Update operation for all LLU-capable processes according to the timeout policy.

-e '<pid1> <pid2> …'

Performs the same function as the -p flag except that this flag excludes the specified processes from the Live Library Update operation.

-l <logfile>

Specifies the log file that you want to use. By default, the log file is /var/adm/ras/liveupdate/logs/llvupdlog.<date.time>.

-n <retries>

Specifies the number of times the Live Library Update operation must be attempted. The default value is 3.

-t <timeout>

Specifies the time for all threads in a process to reach a state after which the LLU operation can be performed. If the LLU operation cannot be started within this timeout period, the operation is canceled for that process and is retried after 10 seconds up to a number of attempts that are specified by the -n <retries> flag. The default timeout period is 30 seconds. The maximum timeout value is 300 seconds.

Examples

To identify the LLU-capable processes and any LLU operations that are in progress before starting an LLU operation and to specify a specific log file, enter the following command:
```
llvupdate -a -t 25 -n 5 -l /tmp/foo
```
In the preceding example, the llvupdate command log information is saved in the /tmp/foo file. The default log file is /var/adm/ras/liveupdate/logs/llvupdlog.
To run the LLU operation for specific processes and to specify 5 as the number of retries that must be attempted with a timeout period of 2 minutes, enter the following command:
```
llvupdate -p 'p1 p2 p3' -t 120 -n 5
```
To run the LLU operation for all LLU-capable processes, enter the following command:
```
llvupdate -a 
```
To run the LLU operation for all LLU-capable processes except the specified processes and to specify 5 as the number of retries that must be attempted with a timeout period of 2 minutes, enter the following command:
```
llvupdate -a -e 'p1 p2 p3' -t 120 -n 5
```