[Task]: Refactor packaging and installer to artifact-based workflow and support legacy migration

[oehrlis]

Task Description

Update packaging, build, and installation scripts to use a modern artifact-based workflow. Create scripts to assemble artifacts for /u00/app/oracle/local/oudbase, refactor the installer to fetch and extract the tarball, remove legacy payload logic, and document migration and upgrade steps. Ensure CI/CD pipeline fully exercises the new process and migration path for legacy installs is clearly supported.

Task Type

CI/CD

Affected Component

Build system

Priority

High (Important, should be done soon)

Motivation

Migrating to an artifact-based workflow simplifies packaging and releases, enables robust CI/CD, and decouples source layout from system install path. Directly supports new repo structure and future pipeline automation. Reduces risk from legacy build steps and onboarding.

Implementation Plan

1. Draft new packaging/build script to assemble artifact for /u00/app/oracle/local/oudbase
2. Rewrite installer to fetch/extract tarball and handle installation, permissions, and optional migration logic
3. Test installer and artifact on clean system
4. Remove embedded payload/build logic and old scripts
5. Document all changes, migration, and test process

Files to Modify

- packaging/build.sh (new)
- packaging/installer/oudbase_install.sh (new)
- packaging/root/u00/app/oracle/local/oudbase (new tree)
- Remove oudbase_install.sh from root
- Update docs and install scripts

Code Examples

Testing Approach

• CI builds and tests artifact/installer successfully
• Manual verification on clean target system
• Upgrade from legacy layout is covered and validated
• All migration/usage docs reviewed/tested by peer

Acceptance Criteria

• Packaging and installation scripts updated for artifact-based workflow
• Legacy payload installs removed
• Build script produces correct tarball
• Installer tested on clean system
• Documentation and upgrade guide updated
• CI test and packaging verified
• Peer-reviewed/approved

Breaking Changes

Major breaking changes

Dependencies

• Blocked by restructure-layout (Restructure repository layout for clarity and maintainability #144)
• Related to CI/CD and documentation update tasks

Risks and Considerations

• Migration script and installer must cover edge cases for legacy installs
• Risk of incomplete migration impacting legacy users
• Permissions and system path must be rigorously tested
• Minimize downtime for users updating

Estimated Effort

No response

Subtasks

- [ ] Draft/build new packaging script
- [ ] Refactor installer
- [ ] Remove all payload/install logic
- [ ] Add/Update docs for install/upgrade
- [ ] Validate packaging in CI
- [ ] Peer review

Documentation Updates Required

• README.md (install/build instructions)
• docs/UPGRADE_FROM_OLD_LAYOUT.md
• packaging/build.sh, packaging/installer/oudbase_install.sh
• Remove old oudbase_install.sh
• Inline packaging/install script comments

Additional Notes

No response

Pre-submission Checklist

• I have searched existing issues to avoid duplicates
• I have provided a clear implementation plan
• I have defined acceptance criteria
• I have considered backward compatibility