{"id":1911,"date":"2018-07-13T01:00:00","date_gmt":"2018-07-13T01:00:00","guid":{"rendered":"http:\/\/inswwdev.azurewebsites.net\/au\/insights\/uncategorized\/enterprise-vault-server-settings-migration-wizard-a-handy-tip-you-didnt-know\/"},"modified":"2024-09-20T03:29:50","modified_gmt":"2024-09-20T03:29:50","slug":"enterprise-vault-server-settings-migration-wizard-a-handy-tip-you-didnt-know","status":"publish","type":"post","link":"https:\/\/www.insentragroup.com\/nz\/insights\/geek-speak\/migrations\/enterprise-vault-server-settings-migration-wizard-a-handy-tip-you-didnt-know\/","title":{"rendered":"Enterprise Vault Server Settings Migration Wizard \u2013 A Handy Tip You Didn\u2019t Know\u2026"},"content":{"rendered":"<p style=\"text-align: justify;\">I recently came across an unexpected issue when performing a migration and upgrade from EV 11.0.1 to a newly built EV 12.2 server on Windows 2012 R2 using the Enterprise Vault 12.3 Server Settings Migration Wizard.<\/p>\n<p style=\"text-align: justify;\">Now, I\u2019m not going to talk about the step-by-step process to migrate and upgrade Enterprise Vault using the Server Settings Migration Wizard as this is fully documented by Veritas<span>&nbsp;<\/span><a rel=\"noopener nofollow\" href=\"https:\/\/www.veritas.com\/support\/en_US\/article.100038733\" target=\"_blank\">here<\/a>.<\/p>\n<p style=\"text-align: justify;\">The issue I encountered was during the import process when the wizard was performing schema version validation checks against the Enterprise Vault databases. In my scenario the wizard was failing on the validation of the<span>&nbsp;<\/span><strong><em>EnterpriseVaultAudit<\/em><\/strong><span>&nbsp;<\/span>database. Just a tad annoying as the wizard will not allow you to continue the import process until you fix the issue.<\/p>\n<p style=\"text-align: justify;\">So, what is the problem? The wizard has these checks in place to mitigate the risk of an unsuccessful or unsupported upgrade from occurring. Well in my case I needed to somehow by-pass this check as the<span>&nbsp;<\/span><strong><em>EnterpriseVaultAudit<\/em><\/strong><span>&nbsp;<\/span>database schema version was at version<span>&nbsp;<\/span><strong>3<\/strong><span>&nbsp;<\/span>which is the<span>&nbsp;<\/span><strong>correct<\/strong><span>&nbsp;<\/span>level for EV 11.0.1 CH5.<\/p>\n<p style=\"text-align: justify;\"><strong>IMPORTANT:<span>&nbsp;<\/span><\/strong>I cannot stress this enough. Do not attempt to perform the \u201chackery\u201d outlined in this blog unless you:<\/p>\n<ol>\n<li>Have the blessing from Veritas Technical Support or Engineering<\/li>\n<li>You have verified that all the EV databases are at the right schema level for the version of EV you are upgrading from<\/li>\n<\/ol>\n<p style=\"text-align: justify;\">So, how to verify the schema level of your Enterprise Vault databases? Easy, run the following SQL Queries:<\/p>\n<p style=\"text-align: justify;\">For the EV Directory database schema version run the following:<\/p>\n<p style=\"text-align: justify;\"><span>USE&nbsp;&nbsp;<\/span><span>EnterpriseVaultDirectory&nbsp;<\/span><\/p>\n<p style=\"text-align: justify;\"><span>SELECT<\/span>&nbsp;&nbsp;<span>SchemaVersion&nbsp;<\/span><br><span>FROM<\/span>&nbsp;&nbsp;<span>DirectoryEntry<\/span><\/p>\n<p style=\"text-align: justify;\">For the EV VaultStore database schema version run the following:<\/p>\n<p style=\"text-align: justify;\"><span>USE&nbsp;<\/span><span>&nbsp;<\/span><span>EnterpriseVaultDirectory<\/span><\/p>\n<p style=\"text-align: justify;\"><span>SELECT&nbsp;<\/span><span>SchemaVersion&nbsp;<\/span><br><span>FROM&nbsp;&nbsp;&nbsp;<\/span><span>VaultStoreEntry<\/span><\/p>\n<p style=\"text-align: justify;\">For the EV Fingerprint database schema version run the following:<\/p>\n<p style=\"text-align: justify;\"><span>USE&nbsp;<\/span><span>EnterpriseVaultDirectory&nbsp;<\/span><\/p>\n<p style=\"text-align: justify;\"><span>SELECT<\/span>&nbsp;<span>SchemaVersion&nbsp;<\/span><br><span>FROM&nbsp;&nbsp;<\/span><span>&nbsp;FingerPrintCatalogueDatabase<\/span><\/p>\n<p style=\"text-align: justify;\">For the EV FSAReportingDatabase schema version run the following:<\/p>\n<p style=\"text-align: justify;\"><span>USE&nbsp;<\/span><span>EnterpriseVaultDirectory&nbsp;<\/span><\/p>\n<p style=\"text-align: justify;\"><span>SELECT&nbsp;<\/span><span>SchemaVersion&nbsp;<\/span><br><span>FROM&nbsp;&nbsp;&nbsp;<\/span><span>FSAReportingDatabase<\/span><\/p>\n<p style=\"text-align: justify;\">For the EV Monitoring database schema version run the following:<\/p>\n<p style=\"text-align: justify;\"><span>USE&nbsp;<\/span><span>EnterpriseVaultDirectory<\/span><\/p>\n<p style=\"text-align: justify;\"><span>SELECT<\/span>&nbsp;<span>SchemaVersion<\/span><br><span>FROM&nbsp;&nbsp;<\/span><span>&nbsp;MonitoringSettings<\/span><\/p>\n<p style=\"text-align: justify;\">For the EV Audit database schema version run the following:<\/p>\n<p style=\"text-align: justify;\"><span>USE&nbsp;<\/span><span>EnterpriseVaultAudit<\/span><\/p>\n<p style=\"text-align: justify;\"><span>SELECT&nbsp;<\/span><span>SchemaVersion<\/span><br><span>FROM&nbsp;&nbsp;&nbsp;<\/span><span>Audit<\/span><\/p>\n<p style=\"text-align: justify;\">Once you\u2019ve obtained the schema version for all the EV databases, cross-reference your results using the tables found in the following Veritas Technote<span>&nbsp;<\/span><a rel=\"noopener nofollow\" href=\"https:\/\/www.veritas.com\/support\/en_US\/article.100020901\" target=\"_blank\">article<\/a>.<\/p>\n<p style=\"text-align: justify;\">So now, let the hackery begin\u2026<\/p>\n<p style=\"text-align: justify;\">Contained within the installation folder of the Enterprise Vault Server Settings Migration Wizard is an XML file named<span>&nbsp;<\/span><strong><em>ServerMigration.exe.config<\/em><\/strong>. In this file you will see a bunch of keys you can use to override certain checks performed by the wizard during the import process. For example:<\/p>\n<p style=\"text-align: justify;\">To override all the EV database schema checks, you would add the following key in the<span>&nbsp;<\/span><strong>&lt;appSettings&gt;<\/strong>section of the ServerMigration.exe.config XML file:<\/p>\n<p style=\"text-align: justify;\"><strong><em>&lt;add key=\u201dOverrideDatabaseSchemaChecks\u201d value=\u201dtrue\u201d\/&gt;<\/em><\/strong><\/p>\n<p style=\"text-align: justify;\">If you needed to override the EV version check, you would add:<\/p>\n<p style=\"text-align: justify;\"><strong><em>&lt;add key=\u201dOverrideEVVersionCheck\u201d value=\u201dtrue\u201d\/&gt;<\/em><\/strong><\/p>\n<p style=\"text-align: justify;\">Lastly, to override the Operating System version check, you would add:<\/p>\n<p style=\"text-align: justify;\"><strong><em>&lt;add key=\u201dOverrideOperatingSystemCheck\u201d value=\u201dtrue\u201d\/&gt;<\/em><\/strong><\/p>\n<p style=\"text-align: justify;\">Now, I imagine you would need to be in a fairly desperate situation if you needed to by-pass<span>&nbsp;<\/span><strong>all<\/strong><span>&nbsp;<\/span>EV database schema checks, the EV version check or OS version check. I definitely wouldn\u2019t do it unless I had no other choice and had the full blessing of Veritas Technical Support as misuse of these keys could potentially place your EV environment in an unstable and unsupported state.<\/p>\n<p style=\"text-align: justify;\">The less riskier approach is to override an individual EV database schema check which is what I needed to do during my upgrade. The key I needed to add was:<\/p>\n<p style=\"text-align: justify;\"><strong><em>&lt;add key=\u201dAcceptedAuditSchemaVersions\u201d value=\u201d<\/em><\/strong><strong><em>3\u2033\/&gt;<\/em><\/strong><\/p>\n<p style=\"text-align: justify;\">Now for the moment of truth. Go ahead and restart the Enterprise Vault Server Settings Migration Wizard in import mode and follow the bouncing ball. There you go. You\u2019re back on track with your EV migration and upgrade. Happy days.<\/p>\n\n\n<figure class=\"wp-block-image size-full\"><a href=\"https:\/\/www.insentragroup.com\/nz\/email-archive-migration\/?utm_source=insentra&amp;utm_medium=email&amp;utm_campaign=email-migration-best-practice-guide&amp;utm_term=email-signature-nz\" target=\"_blank\" rel=\"noopener\"><img fetchpriority=\"high\" decoding=\"async\" width=\"600\" height=\"180\" src=\"https:\/\/www.insentragroup.com\/nz\/wp-content\/uploads\/sites\/18\/2022\/08\/email_archive_migration_banner_2022.png\" alt=\"\" class=\"wp-image-11026\" srcset=\"https:\/\/www.insentragroup.com\/nz\/wp-content\/uploads\/sites\/18\/2022\/08\/email_archive_migration_banner_2022.png 600w, https:\/\/www.insentragroup.com\/nz\/wp-content\/uploads\/sites\/18\/2022\/08\/email_archive_migration_banner_2022-300x90.png 300w\" sizes=\"(max-width: 600px) 100vw, 600px\" \/><\/a><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>I recently came across an unexpected issue when performing a migration and upgrade from EV 11.0.1 to a newly built EV 12.2 server on Windows 2012 R2 using the Enterprise Vault 12.3 Server Settings Migration Wizard. Now, I\u2019m not going to talk about the step-by-step process to migrate and upgrade Enterprise Vault using the Server&hellip; <a class=\"more-link\" href=\"https:\/\/www.insentragroup.com\/nz\/insights\/geek-speak\/migrations\/enterprise-vault-server-settings-migration-wizard-a-handy-tip-you-didnt-know\/\">Continue reading <span class=\"screen-reader-text\">Enterprise Vault Server Settings Migration Wizard \u2013 A Handy Tip You Didn\u2019t Know\u2026<\/span><\/a><\/p>\n","protected":false},"author":89,"featured_media":1912,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"content-type":"","footnotes":""},"categories":[22],"tags":[],"class_list":["post-1911","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-migrations","entry"],"_links":{"self":[{"href":"https:\/\/www.insentragroup.com\/nz\/wp-json\/wp\/v2\/posts\/1911","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.insentragroup.com\/nz\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.insentragroup.com\/nz\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.insentragroup.com\/nz\/wp-json\/wp\/v2\/users\/89"}],"replies":[{"embeddable":true,"href":"https:\/\/www.insentragroup.com\/nz\/wp-json\/wp\/v2\/comments?post=1911"}],"version-history":[{"count":1,"href":"https:\/\/www.insentragroup.com\/nz\/wp-json\/wp\/v2\/posts\/1911\/revisions"}],"predecessor-version":[{"id":11030,"href":"https:\/\/www.insentragroup.com\/nz\/wp-json\/wp\/v2\/posts\/1911\/revisions\/11030"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.insentragroup.com\/nz\/wp-json\/wp\/v2\/media\/1912"}],"wp:attachment":[{"href":"https:\/\/www.insentragroup.com\/nz\/wp-json\/wp\/v2\/media?parent=1911"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.insentragroup.com\/nz\/wp-json\/wp\/v2\/categories?post=1911"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.insentragroup.com\/nz\/wp-json\/wp\/v2\/tags?post=1911"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}