syncroot Command

Purpose

Synchronizes a non-shared portion of installed software with a shared part.

Syntax

/usr/sbin/syncroot [ [ -a ] [ -i ] | [ -F ] [ -r ] ] [ -p ] [ -v ] [ -X ]

Flags

Item	Description
-a	Performs additional installation only. Does not downlevel the installp file sets (that is, uninstall, reject, force overwrite). Not valid with the -r flag.
-i	Only updates installp file sets. Not valid with the -r flag.
-F	Forces copy RPM files. Not valid with the -i flag.
-r	Only updates RPM files. Not valid with the -i flag.
-p	Previews operation. Do not actually performs the synchronization.
-v	Specifies the verbose mode.
-X	Expands file systems if necessary and possible.

Notes:

If you are logged into a version 6 workload partition, on a version 7 global system, and run the syncroot command, the operation will fail with the following error:

syncroot: Processing root part installation status.
Your global system is at a higher version than the WPAR.
Please log out of the WPAR and execute the migwpar command.
syncroot: Returns Status = FAILURE

For shared workload partitions (WPARs), if the installation history of the source system is different from the installation history of the target system, the restwpar command and the syncroot command might fail for few filesets. You might see a failure message that is similar to the following example for the syncroot command, at the end of the restwpar operation:
```
syncroot: Error synchronizing installp software
syncroot: Returns Status = FAILURE
```
You must restore or migrate the shared WPAR to a logical partition (LPAR) that has the installation history similar to the installation history of the source LPAR.

Security

Access Control: Only the root user can run this command.

Examples

To update all installp filesets in the root part, enter:
```
# syncroot -i
```
To perform an update of all RPM files and expand space automatically (if needed and possible ), enter:
```
# syncroot -r -X
```