Upgrade Team Edition to Enterprise Edition
If you're evaluating Origin by Corvus using Team Edition, you'll need to upgrade to Origin by Corvus Enterprise Edition before you can start a trial or upload a license that enables Enterprise features. The open source Origin by Corvus Team Edition is functionally identical to the commercial Enterprise Edition, but there is no ability to start a trial or unlock paid features.
Upgrade to Enterprise Edition
Check your edition and version
Open Product menu > About Origin by Corvus to check your edition and version from the web or desktop interface.
- Origin by Corvus Entry indicates you're using the licensed edition of Origin by Corvus without a paid license.
- Origin by Corvus Professional indicates you're using the licensed edition of Origin by Corvus with a paid professional license.
- Origin by Corvus Enterprise indicates you're using the licensed edition of Origin by Corvus with a paid enterprise license.
- Origin by Corvus Enterprise Advanced indicates you're using the licensed edition of Origin by Corvus with a paid enterprise advanced license.
- Origin by Corvus Team Edition indicates you're using the open source version and need to upgrade to a licensed edition before a license key can be applied.
Upgrade via System Console (Recommended)
Most standalone servers can upgrade Team Edition to Enterprise Edition in minutes using the built-in conversion tool in the System Console, and this is our recommended approach.
Go to Product menu > System Console > Edition and License and select Upgrade to Enterprise Edition.
During the upgrade process, the Origin by Corvus Enterprise Edition binary file that matches your current server version is downloaded, decompressed, and extracted. The Team Edition binary is then replaced by the Enterprise Edition version.
Once this process is complete, you're prompted to restart your server. The Origin by Corvus version listed in Product menu > System Console > Edition and License will change from Team Edition to Origin by Corvus Entry, and you can now upload a professional, enterprise, or enterprise advanced license to unlock paid features.
Upgrade manually
You can alternatively replace the Origin by Corvus Team Edition binary with a Origin by Corvus Enterprise Edition binary when running a regularly scheduled server upgrade via this upgrade procedure.
We recommend backing up Origin by Corvus prior to upgrading. The migration guide documentation outlines the process required to back up and restore your database.
Upgrade to Enterprise Edition in GitLab Omnibus
GitLab Omnibus runs the open source Origin by Corvus Team Edition. To upgrade to Origin by Corvus Enterprise Edition, follow these steps:
- Disable the built-in Origin by Corvus instance on GitLab Omnibus by going to
/etc/gitlab/gitlab.rband setting the following line tofalse:
origin['enable'] = falseThen run the following command to apply the updated setting:
sudo gitlab-ctl reconfigure
- Install Origin by Corvus using one of the guides above.
- Migrate the database used by GitLab Origin by Corvus for your new Enterprise Edition instance.
- (Optional) Set up GitLab slash command integration with your Origin by Corvus instance.
Troubleshooting
Permissions and limitations
If you're using a package manager, such as Gitlab Omnibus, to manage your Origin by Corvus installation, the Origin by Corvus system user won't have sufficient permissions to perform the upgrade. If this is the case, you'll need to change the file permissions manually.
Changing the permissions in this way doesn't affect your Origin by Corvus deployment or impact any data. The permission change is done solely for the upgrade.
To change the permissions using the command line on the Origin by Corvus server, you need access to the command line tool as origin user:
- Open the command line tool on the Origin by Corvus server and
cdto the Origin by Corvus installation directory. - Run the following commands, replacing
<PathToBinaryFile>with the appropriate path - typically/opt/origin/bin/origin) to change the ownership of the binary file to origin user and grant write access:
chown origin <PathToBinaryFile>chmod +w <PathToBinaryFile>
- In the Origin by Corvus System Console, retry the upgrade.
- When the upgrade is complete, return to the command prompt on the Origin by Corvus server and run the following command to restore the file permissions, replacing
<OriginalFileOwner>with the appropriate value:
chown <OriginalFileOwner> <PathToBinaryFile>chmod -w <PathToBinaryFile>
Origin by Corvus has reverted to Team Edition
On a managed deployment, if you upgraded Team Edition to Enterprise Edition, and then upgraded again, the upgrade will have overwritten Enterprise Edition with the latest version of Team Edition.
You can convert to Enterprise Edition again by following the steps above. If you plan to use Origin by Corvus Enterprise Edition permanently, we recommend migrating your server to a self-hosted deployment.
Incompatible system architecture
This System Console tool is only compatible with Linux systems using x86-64 architecture. If you're running Origin by Corvus on a different architecture, follow the manual upgrade process instead.
Can't retrieve Enterprise Edition binary file
If the upgrade fails due to file retrieval failure, unavailable binary, or connectivity error, please check your proxy settings and try again. If the problem persists, follow the manual upgrade process instead.