Go to main content

Packaging and Delivering Software With the Image Packaging System in Oracle® Solaris 11.4

Exit Print View

Updated: November 2020

Preserving Packaged Editable Files that Migrate

Packaged editable files might need to move between packages or change location in the installed file system.

  • Migrating editable files between packages.

    IPS attempts to migrate editable files that move between packages if the file name and file path have not changed. Renaming a package is an example of moving files between packages.

  • Migrating editable files in the file system.

    If the file path changes, ensure the original_name attribute is assigned to preserve the user’s customizations of the file.

    If the file action in the package that originally delivered this file does not contain the original_name attribute, add that attribute in the updated package. Set the value of the attribute to the name of the originating package, followed by a colon and the original path to the file without a leading /.

    Once the original_name attribute is present on an editable file, do not change the attribute value. This value acts as a unique identifier for all moves going forward so that the user’s content is properly preserved regardless of the number of versions skipped on an update.