This article describes the steps to for fresh install and Upgrade from prior versions
CruzOC 10.0.3 – Installation Instructions
New Installation
The standard product is provided in a single install package for Windows or Linux and is also the same package used for new or trial installs. You simply execute the .exe for windows or .bin for Linux and the install wizard will walk through the necessary steps. You may install either package on your physical or virtual server. A Linux OVA is also available for import on a VMware host. For additional information refer to CruzOC installation Tips.
Upgrades (Upgrade an existing CruzOC Installation)
- ALERT! 10.0.3 upgrade ***************************************************************************
CruzOC v10.0.3 includes a DB upgrade to Mysql 8 and requires additional manual steps when upgrading. Failure to perform these additional step will result in an corrupted db.
***************************************************************************
-
- If you are upgrading the OVA (Virtual Appliance), you will need to apply the Linux version of the new software package. When upgrading the OVA, the install wizard is Linux CLI based and will have CLI prompts for the needed inputs.
EOL/EOS - Current product support includes product releases for the last two major releases or the last two years. Defects or other resolved issues may be backported/patched or supported at Dorado Software’s discretion if they are within the last two major releases or two-year time frame. Prior releases are considered EOL/EOS and may be supported at Dorado's discretion; however, defects or access to new features will generally require an upgrade to a supported version.
- If you are upgrading the OVA (Virtual Appliance), you will need to apply the Linux version of the new software package. When upgrading the OVA, the install wizard is Linux CLI based and will have CLI prompts for the needed inputs.
Please refer to the Upgrade Path Matrix in this document for specific information on your upgrade path.
*As a reminder, starting with Version 9.x release on Feb 1, 2020, OMNM has been rebranded to Cruz Operation Center (CruzOC). This was strictly a branding and GUI cosmetic change. There were no changes to any features or functionality. Upgrades and product support from prior versions will continue to be fully supported.
Upgrade Path Matrix
- ALERT! 10.0.3 upgrade ***************************************************************************
CruzOC v10.0.3 includes a DB upgrade to Mysql 8 and requires additional manual steps when upgrading. Failure to perform these additional step will result in an corrupted db.
*************************************************************************** - X = Supported direct upgrade path
- NA = Not Applicable
- NS =Not Supported or not tested. A direct upgrade path may be supported but will require a test upgrade to be performed and validated.
| Upgrade Path Matrix | |||||||||||
| Dell OpenManage Network Manager / OMNM | Dorado CruzOC | ||||||||||
| Release date | 1-Feb-2021 | 1-Jul 2021 | 1-Aug-2022 | 28-Feb-2023 | |||||||
| Version upgrade to → | 6.5 | 6.5.2 | 6.5.3 | 8.0 | 8.0.1 | 9.0.0 | 9.0.1 | 10 | 10.0.1 | 10.0.2* | 10.0.3 |
| From | |||||||||||
| ↓ | |||||||||||
| 6.5 | NA | X | X | NS | NS | NS | NS | NS | NS | NS | NS |
| 6.5.2 | NA | X | X | X | NS | NS | NS | NS | NS | NS | |
| 6.5.3 | NA | X | X | NS | NS | NS | NS | NS | NS | ||
| 8.0 | NA | X | X | NS | NS | NS | NS | NS | |||
| 8.0.1 | NA | X | X | NS | NS | NS | NS | ||||
| 9.0.0 | NA | X | X | NS | NS | NS | |||||
| 9.0.1 | NA | X | X | X | S** | ||||||
| 10.0.0 | NA | X | X | S** | |||||||
| 10.0.1 | NA | X | S** | ||||||||
| 10.0.2 | NA | X* | |||||||||
| 10.0.3 | NA | ||||||||||
* v10.0.2 was a limited release and not generally available. Additional mysql 8 migration step are not required since 10.0.2.x is already using mysql 8
**S Supported and requires manual steps. See steps below.
Before Upgrading
*****************************************************************************************
WARNING: These pre-upgrade steps are mandatory and standard for ANY/ALL upgrades including path updates. These will ensure that the pre-upgrade state of the system is recoverable in the event of an upgrade failure.
****************************************************************************************
Backup Database
- If using a virtualized server, take a snapshot of your system prior to upgrade or
- Backup your databases
- Open command line window or linux console and source Environment Variables:
- type oware for Windows or . /etc/.dsienv for Linux
- Execute the following to export your DB:
- mysqldump -u root -pdorado --single-transaction --all-databases --triggers --routines --events >all_databases.sql
- Open command line window or linux console and source Environment Variables:
NOTE: dorado is default password, if it has been changed, please provide changed password mysqldump file will be located in diretory where mysqldump file was executed from
Upgrading to Cruz v10.0.3 from a version prior to v9.0.1
When upgrading an earlier release to v10.0.3, it is recommend that you first upgrade to 9.0.1 per the upgrade paths matrix and then perform a direct upgrade from 9.0.1 to 10.0.3
If at any point you are upgrading from a version older than 8.0.1.66 to 8.0.1.66 or later, there is an additional POST upgrade steps required. Omitting this step will prevent you from gaining access to the Web UI.
For example upgrading v6.5 to 8.0.1x or v8.0.0 to v9.0 would require the POST upgrade steps. If you are already on 8.0.1.66 or later these POST upgrade steps are not required.
Once you are on v9.0.1 you may proceed with the following steps to upgrade to 10.0.3
NOTE: While it is highly recommended to upgrade to 9.0.1 before a direct upgrading to 10.0.3. A direct upgrade from any earlier release directly to 10.0.3 may be possible. This would require you to test and validate the direct upgrade using following the steps below
Windows CruzOC Upgrade (v9.0.1.x or v10.0.x) to v10.0.3
1. Move prepareMySQL5forUpgrade.zip file to $OWARE_ROOT/bin directory. NOTE: To find out the exact path, bring up command window, type in oware<ENTER>, type in cd $OWARE_ROOT/bin<ENTER>, type in pwd<ENTER>
2. Extract contents of prepareMySQL5forUpgrade.zip into $OWARE_ROOT/bin directory. NOTE: you should receive: prepareMySQL5forUpgrade & prepareMySQL5forUpgrade.cmd files
3. Open Command Prompt & Convert to Oware prompt: type in oware<ENTER> type in cd $OWARE_ROOT/bin <ENTER>
4. Run prepareMySQL5forUpgrade: prepareMySQL5forUpgrade -u %ROOT_USERNAME% -p %ROOT_PASSWORD Example: prepareMySQL5forUpgrade -u root -p dorado
5. Run 10.0.3 installation program
Linux CruzOC Upgrade (v9.0.1.x or v10.0.x) to v10.0.3
1. Copy Install Package to Linux box $HOME/install
NOTE: To find out the exact path, bring up console, type in . /etc/.dsienv<ENTER>, type in cd $HOME/install<ENTER>, type in pwd<ENTER>
2. Move prepareMySQL5forUpgrade.zip to $OWARE_ROOT/bin directory. In Console type in cd $OWARE_ROOT/bin <ENTER>. Type in tar -xvf $OWARE_ROOT/bin/prepareMySQL5forUpgrade.zip <ENTER> NOTE: you should receive prepareMySQL5forUpgrade & prepareMySQL5forUpgrade.cmd files
3. Run prepareMySQL5forUpgrade: prepareMySQL5forUpgrade -u %ROOT_USERNAME% -p %ROOT_PASSWORD% example: prepareMySQL5forUpgrade -u root -p dorado
4. Run 10.0.3 installation program
5. There is the expected failure toward the end of the installation
***************************************************************
Database Install Failure
------------------------ERROR - Database schema inspection failed
An error occurred while attempting to update the existing database
schema to be compatible with the current application components.
This installation WILL NOT function properly.<p>A log file containing the
failure is located at:
/opt/VAroot/cruzoc/app_setup.log Contact technical support to resolve the failure, then complete the installation by opening a new Command Prompt window and running the following commands:
dbevolve -a -x
ocpinstall -s
***************************************************************
6. After this expected failure close console exit.
7. Open new console & run repairMySQL8forUpgrade script:$HOME/install/repairMySQL8forUpgrade.sh
On completion the application will startup and will be ready to access after a short time.