The SGC upgrade bundle contains the components required to perform an upgrade of the OCSS7 SGC:

  • orca — the upgrade tool

  • packages/* — the packages required to upgrade the SGC

The upgrade bundle must be extracted prior to use.

Extracting the SGC Upgrade Bundle

The upgrade bundle must be extracted prior to first use:

$ unzip sgc-upgrade-bundle-3.0.0.1.zip
Archive:sgc-upgrade-bundle-3.0.0.1.zip
 extracting: sgc-upgrade-bundle-3.0.0.1/README
 extracting: sgc-upgrade-bundle-3.0.0.1/core/__init__.py
 extracting: sgc-upgrade-bundle-3.0.0.1/core/command.py
 extracting: sgc-upgrade-bundle-3.0.0.1/core/constants.py
 extracting: sgc-upgrade-bundle-3.0.0.1/core/exceptions.py
 extracting: sgc-upgrade-bundle-3.0.0.1/core/host.py
 extracting: sgc-upgrade-bundle-3.0.0.1/core/logger.py
 extracting: sgc-upgrade-bundle-3.0.0.1/core/terminal.py
 extracting: sgc-upgrade-bundle-3.0.0.1/core/upgrade_info.py
 extracting: sgc-upgrade-bundle-3.0.0.1/core/utils.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/__init__.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/common.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/feature_script_diff.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/orca_migrate_helper.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/rem_helper.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/sgc/__init__.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/sgc/sgc_api.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/sgc/sgc_backup.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/sgc/sgc_common.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/sgc/sgc_config.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/sgc/sgc_hazelcast_xml.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/sgc/sgc_node.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/sgc/sgc_package.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/sgc/sgc_views.py
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/slee-data-migration-package.zip
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/slee-data-transformation-standalone.jar
 extracting: sgc-upgrade-bundle-3.0.0.1/helpers/standardize_paths.py
 extracting: sgc-upgrade-bundle-3.0.0.1/licenses/third-party-licenses.txt
 extracting: sgc-upgrade-bundle-3.0.0.1/orca
 extracting: sgc-upgrade-bundle-3.0.0.1/packages/ocss7-3.0.0.1.zip
 extracting: sgc-upgrade-bundle-3.0.0.1/packages/packages.cfg
 extracting: sgc-upgrade-bundle-3.0.0.1/resources/orca-version.properties
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/__init__.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/apply_patch.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/cleanup.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/cleanup_rem.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/import_feature_scripts.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/major_upgrade.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/migrate.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/minor_upgrade.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/multi_stage_operation.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/orca_workflow.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/patch_common.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/prepare.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/prepare_new_rhino.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/revert_patch.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/rhino_only_upgrade.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/rollback.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/rollback_rem.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/run.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sentinel_upgrade.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/__init__.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_abort_revert.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_abort_upgrade.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_backup.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_commands.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_complete_revert.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_complete_upgrade.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_constants.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_install.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_prepare.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_prune_backups.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_revert_cluster.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_revert_node.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_rollback_revert.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_rollback_upgrade.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_start_node.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_start_revert.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_start_upgrade.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_status.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_stop_node.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_upgrade_cluster.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_upgrade_node.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_utils.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_validators.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/sgc/sgc_workflow.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/standardize_paths.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/status.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/upgrade_common.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/upgrade_rem.py
 extracting: sgc-upgrade-bundle-3.0.0.1/workflows/workflow_decorator.py

Following extraction, change to the extracted directory:

$ cd sgc-upgrade-bundle-3.0.0.1/

Orca Basics

The basic pattern that all orca commands follow is:

$ ./orca --hosts <host_list> <subcommand> <subcommand_arguments>

The <host_list> argument is a mandatory comma-separated list of hosts containing SGC nodes. --hosts can also be replaced with the short form -H.

The <subcommand> argument is the SGC specific sub command to execute.

<subcommand_arguments> are zero or more arguments specific to the sub command being executed.

Previous page Next page