<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>OpenText Analytics Database 26.2.x – Managing licenses</title>
    <link>/en/admin/managing-licenses/</link>
    <description>Recent content in Managing licenses on OpenText Analytics Database 26.2.x</description>
    <generator>Hugo -- gohugo.io</generator>
    
	  <atom:link href="/en/admin/managing-licenses/index.xml" rel="self" type="application/rss+xml" />
    
    
      
        
      
    
    
    <item>
      <title>Admin: Obtaining a license key file</title>
      <link>/en/admin/managing-licenses/obtaining-license-key-file/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/admin/managing-licenses/obtaining-license-key-file/</guid>
      <description>
        
        
        &lt;p&gt;Follow these steps to obtain a license key file:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;Log in to the &lt;a href=&#34;https://softwaresupport.softwaregrp.com/&#34;&gt;Software Entitlement Key site&lt;/a&gt; using your passport login information. If you do not have a passport login, create one.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;On the Request Access page, enter your order number and select a role.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Enter your request access reasoning.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Click &lt;strong&gt;Submit&lt;/strong&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;After your request is approved, you will receive a confirmation email. On the site, click the &lt;strong&gt;Entitlements&lt;/strong&gt; tab to see your database software.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Under the Action tab, click &lt;strong&gt;Activate&lt;/strong&gt;. You may select more than one product.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;The License Activation page opens. Enter your Target Name.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Select your database version and the quantity you want to activate.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Click &lt;strong&gt;Next&lt;/strong&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Confirm your activation details and click Submit.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;The Activation Results page displays. Follow the instructions in &lt;a href=&#34;../../../en/admin/managing-licenses/installing-or-upgrading-license-key/new-license-installations/#&#34;&gt;New license installations&lt;/a&gt; or &lt;a href=&#34;../../../en/admin/managing-licenses/installing-or-upgrading-license-key/license-changes/#&#34;&gt;License changes&lt;/a&gt; to complete your installation or upgrade.&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;

      </description>
    </item>
    
    <item>
      <title>Admin: Understanding licenses</title>
      <link>/en/admin/managing-licenses/understanding-licenses/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/admin/managing-licenses/understanding-licenses/</guid>
      <description>
        
        
        &lt;p&gt;OpenText™ Analytics Database has flexible licensing terms. It can be licensed on the following bases:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;Term-based (valid until a specific date).&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Size-based (valid to store up to a specified amount of raw data).&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Both term- and size-based.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Unlimited duration and data storage.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Node-based with an unlimited number of CPUs and users (one node is a server acting as a single computer system, whether physical or virtual).&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;A pay-as-you-go model where you pay for only the number of hours you use. This license is available on your cloud provider&#39;s marketplace.&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Your license key has your licensing bases encoded into it. If you are unsure of your current license, you can &lt;a href=&#34;../../../en/admin/managing-licenses/viewing-your-license-status/&#34;&gt;view your license information from within the database&lt;/a&gt;.

&lt;div class=&#34;alert admonition note&#34; role=&#34;alert&#34;&gt;
&lt;h4 class=&#34;admonition-head&#34;&gt;Note&lt;/h4&gt;

OpenText™ Analytics Database does not support license downgrades.

&lt;/div&gt;&lt;/p&gt;
&lt;p&gt;&lt;a name=&#34;License&#34;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2 id=&#34;trial-license&#34;&gt;Trial license&lt;/h2&gt;
&lt;p&gt;The 30‑day Trial license is the current evaluation option for OpenText™ Analytics Database (Vertica). It provides a supported way to explore the database capabilities in a time‑limited environment before transitioning to a commercial license. For more information about trial entitlements and getting started, see &lt;a href=&#34;../../../en/getting-started/community-edition-ce/#&#34;&gt;Trial license as the Evaluation Option&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;The license cannot be installed co-located in a Hadoop infrastructure and used to query data stored in Hadoop formats.&lt;/p&gt;
&lt;h2 id=&#34;opentexttrade-analytics-database-for-sql-on-apache-hadoop-license&#34;&gt;OpenText™ Analytics Database for SQL on Apache Hadoop license&lt;/h2&gt;
&lt;p&gt;OpenText™ Analytics Database for SQL on Apache Hadoop is a separate product with its own license. This documentation covers both products. Consult your license agreement for details about available features and limitations.&lt;/p&gt;

      </description>
    </item>
    
    <item>
      <title>Admin: Installing or upgrading a license key</title>
      <link>/en/admin/managing-licenses/installing-or-upgrading-license-key/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/admin/managing-licenses/installing-or-upgrading-license-key/</guid>
      <description>
        
        
        &lt;p&gt;The steps you follow to apply your OpenText™ Analytics Database license key vary, depending on the type of license you are applying and whether you are upgrading your license.&lt;/p&gt;

      </description>
    </item>
    
    <item>
      <title>Admin: Viewing your license status</title>
      <link>/en/admin/managing-licenses/viewing-your-license-status/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/admin/managing-licenses/viewing-your-license-status/</guid>
      <description>
        
        
        &lt;p&gt;You can use several functions to display your license terms and current status.&lt;/p&gt;
&lt;h2 id=&#34;examining-your-license-key&#34;&gt;Examining your license key&lt;/h2&gt;
&lt;p&gt;Use the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/display-license/#&#34;&gt;DISPLAY_LICENSE&lt;/a&gt; SQL function to display the license information. This function displays the dates for which your license is valid (or &lt;code&gt;Perpetual&lt;/code&gt; if your license does not expire) and any raw data allowance. For example:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT DISPLAY_LICENSE();
                  DISPLAY_LICENSE
---------------------------------------------------
 Vertica Systems, Inc.
2007-08-03
Perpetual
500GB

(1 row)
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;You can also query the &lt;a href=&#34;../../../en/sql-reference/system-tables/v-catalog-schema/licenses/#&#34;&gt;LICENSES&lt;/a&gt; system table to view information about your installed licenses. This table displays your license types, the dates for which your licenses are valid, and the size and node limits your licenses impose.&lt;/p&gt;
&lt;p&gt;Alternatively, use the &lt;a href=&#34;../../../en/sql-reference/system-tables/v-catalog-schema/licenses/#&#34;&gt;LICENSES&lt;/a&gt; table in Management Console. On your database Overview page, click the License tab to view information about your installed licenses.&lt;/p&gt;
&lt;h2 id=&#34;viewing-your-license-compliance&#34;&gt;Viewing your license compliance&lt;/h2&gt;
&lt;p&gt;If your license includes a raw data size allowance, OpenText™ Analytics Database periodically audits your database&#39;s size to ensure it remains compliant with the license agreement. If your license has a term limit, the database also periodically checks to see if the license has expired. You can see the result of the latest audits using the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/get-compliance-status/#&#34;&gt;GET_COMPLIANCE_STATUS&lt;/a&gt; function.&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;
=&amp;gt; select GET_COMPLIANCE_STATUS();
                       GET_COMPLIANCE_STATUS
---------------------------------------------------------------------------------
 Raw Data Size: 2.00GB +/- 0.003GB
 License Size : 4.000GB
 Utilization  : 50%
 Audit Time   : 2011-03-09 09:54:09.538704+00
 Compliance Status : The database is in compliance with respect to raw data size.
 License End Date: 04/06/2011
 Days Remaining: 28.59
(1 row)
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;To see how your ORC/Parquet data is affecting your license compliance, see &lt;a href=&#34;../../../en/admin/managing-licenses/viewing-license-compliance-hadoop-file-formats/#&#34;&gt;Viewing license compliance for Hadoop file formats&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;viewing-your-license-status-through-mc&#34;&gt;Viewing your license status through MC&lt;/h2&gt;
&lt;p&gt;Information about license usage is on the Settings page. See &lt;a href=&#34;../../../en/admin/managing-licenses/monitoring-db-size-license-compliance/#&#34;&gt;Monitoring database size for license compliance&lt;/a&gt;.&lt;/p&gt;

      </description>
    </item>
    
    <item>
      <title>Admin: Viewing license compliance for Hadoop file formats</title>
      <link>/en/admin/managing-licenses/viewing-license-compliance-hadoop-file-formats/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/admin/managing-licenses/viewing-license-compliance-hadoop-file-formats/</guid>
      <description>
        
        
        &lt;p&gt;You can use the &lt;a href=&#34;../../../en/sql-reference/system-tables/v-monitor-schema/external-table-details/#&#34;&gt;EXTERNAL_TABLE_DETAILS&lt;/a&gt; system table to gather information about all of your tables based on Hadoop file formats. This information can help you understand how much of your license&#39;s data allowance is used by ORC and Parquet-based data.&lt;/p&gt;
&lt;p&gt;The database computes the values in this table at query time, so to avoid performance problems, restrict your queries to filter by table_schema, table_name, or source_format. These three columns are the only columns you can use in a predicate, but you may use all of the usual predicate operators.&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT * FROM EXTERNAL_TABLE_DETAILS
    WHERE source_format = &amp;#39;PARQUET&amp;#39; OR source_format = &amp;#39;ORC&amp;#39;;
-[ RECORD 1 ]---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
schema_oid            | 45035996273704978
table_schema          | public
table_oid             | 45035996273760390
table_name            | ORC_demo
source_format         | ORC
total_file_count      | 5
total_file_size_bytes | 789
source_statement      | COPY FROM &amp;#39;ORC_demo/*&amp;#39; ORC
file_access_error     |
-[ RECORD 2 ]---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
schema_oid            | 45035196277204374
table_schema          | public
table_oid             | 45035996274460352
table_name            | Parquet_demo
source_format         | PARQUET
total_file_count      | 3
total_file_size_bytes | 498
source_statement      | COPY FROM &amp;#39;Parquet_demo/*&amp;#39; PARQUET
file_access_error     |
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;When computing the size of an external table, OpenText™ Analytics Database counts all data found in the location specified by the COPY FROM clause. If you have a directory that contains ORC and delimited files, for example, and you define your external table with &amp;quot;COPY FROM *&amp;quot; instead of &amp;quot;COPY FROM *.orc&amp;quot;, this table includes the size of the delimited files. (You would probably also encounter errors when querying that external table.) When you query this table, the database does not validate your table definition; it just uses the path to find files to report.&lt;/p&gt;
&lt;p&gt;You can also use the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/audit/#&#34;&gt;AUDIT&lt;/a&gt; function to find the size of a specific table or schema. When using the AUDIT function on ORC or PARQUET external tables, the error tolerance and confidence level parameters are ignored. Instead, the AUDIT always returns the size of the ORC or Parquet files on disk.&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; select AUDIT(&amp;#39;customers_orc&amp;#39;);
   AUDIT
-----------
 619080883
(1 row)
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Admin: Moving a cloud installation from by the hour (BTH) to bring your own license (BYOL)</title>
      <link>/en/admin/managing-licenses/moving-cloud-installation-from-by-hour-bth-to-bring-your-own-license-byol/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/admin/managing-licenses/moving-cloud-installation-from-by-hour-bth-to-bring-your-own-license-byol/</guid>
      <description>
        
        
        &lt;p&gt;OpenText™ Analytics Database offers two licensing options for some of the entries in the &lt;a href=&#34;https://aws.amazon.com/marketplace/search/results?x=0&amp;amp;y=0&amp;amp;searchTerms=vertica&#34;&gt;Amazon Web Services Marketplace&lt;/a&gt; and &lt;a href=&#34;https://cloud.google.com/marketplace/&#34;&gt;Google Cloud Marketplace:&lt;/a&gt;&lt;br /&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Bring Your Own License (BYOL)&lt;/strong&gt;: a long-term license that you &lt;a href=&#34;../../../en/admin/managing-licenses/obtaining-license-key-file/&#34;&gt;obtain through an online licensing portal&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;Vertica &lt;strong&gt;by the Hour (BTH)&lt;/strong&gt;: a pay-as-you-go environment where you are charged an hourly fee for both the use of Vertica and the cost of the instances it runs on. The Vertica by the hour deployment offers an alternative to purchasing a term license. If you want to crunch large volumes of data within a short period of time, this option might work better for you. The BTH license is automatically applied to all clusters you create using a BTH MC instance.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;If you start out with an hourly license, you can later decide to use a long-term license for your database. The support for an hourly versus a long-term license is built into the instances running your database. To move your database from an hourly license to a long-term license, you must create a new database cluster with a new set of instances.&lt;/p&gt;
&lt;p&gt;To move from an hourly to a long-term license, follow these steps:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;Purchase a BYOL license. Follow the process described in &lt;a href=&#34;../../../en/admin/managing-licenses/obtaining-license-key-file/#&#34;&gt;Obtaining a license key file&lt;/a&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Apply the new license to your database.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Shut down your database.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Create a new database cluster using a BYOL marketplace entry.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Revive your database onto the new cluster.&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;The exact steps you must take depend on your database mode and your preferred tool for managing your database:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Eon Mode databases:&lt;/strong&gt; Use either &lt;a href=&#34;#Move&#34;&gt;the command line&lt;/a&gt; or &lt;a href=&#34;#Move2&#34;&gt;Management Console&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Enterprise Mode databases:&lt;/strong&gt; &lt;a href=&#34;#Move3&#34;&gt;Use the command line&lt;/a&gt; to switch licenses.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;a name=&#34;Move&#34;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2 id=&#34;moving-an-eon-mode-database-from-bth-to-byol-using-the-command-line&#34;&gt;Moving an Eon Mode database from BTH to BYOL using the command line&lt;/h2&gt;
&lt;p&gt;Follow these steps to move an Eon Mode database from an hourly to a long-term license.
&lt;p&gt;Obtain a long-term BYOL license from the online licensing portal, described in &lt;a href=&#34;../../../en/admin/managing-licenses/obtaining-license-key-file/#&#34;&gt;Obtaining a license key file&lt;/a&gt;.Upload the license file to a node in your database. Note the absolute path in the node&#39;s filesystem, as you will need this later when installing the license.Connect to the node you uploaded the license file to in the previous step.
Connect to your database using &lt;a class=&#34;glosslink&#34; href=&#34;../../../en/glossary/vsql/&#34; title=&#34;For more information, see Installing the vsql Client and the more general topic, Using vsql.&#34;&gt;vsql&lt;/a&gt; and view the licenses table:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT * FROM licenses;
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;Note the name of the hourly license listed in the NAME column, so you can check if it is still present later.&lt;/p&gt;
&lt;p&gt;Install the license in the database using the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/catalog-functions/install-license/#&#34;&gt;INSTALL_LICENSE&lt;/a&gt; function with the absolute path to the license file you uploaded in step 2:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT install_license(&amp;#39;&lt;span class=&#34;code-variable&#34;&gt;absolute path to BYOL license&lt;/span&gt;&amp;#39;);
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;View the licenses table again:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT * FROM licenses;
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;If only the new BYOL license appears in the table, skip to step 8. If the hourly license whose name you noted in step 4 is still in the table, copy the name and proceed to step 7.&lt;/p&gt;
&lt;p&gt;Call the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/catalog-functions/drop-license/#&#34;&gt;DROP_LICENSE&lt;/a&gt; function to drop the hourly license:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT drop_license(&amp;#39;&lt;span class=&#34;code-variable&#34;&gt;hourly license name&lt;/span&gt;&amp;#39;);
&lt;/code&gt;&lt;/pre&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;You will need the path for your cluster&#39;s communal storage in a later step. If you do not already know the path, you can find this information by executing this query:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT location_path FROM V_CATALOG.STORAGE_LOCATIONS
   WHERE sharing_type = &amp;#39;COMMUNAL&amp;#39;;
&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Synchronize your database&#39;s metadata. See &lt;a href=&#34;../../../en/eon/synchronizing-metadata/#&#34;&gt;Synchronizing metadata&lt;/a&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Shut down the database by calling the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/db-functions/shutdown/#&#34;&gt;SHUTDOWN&lt;/a&gt; function:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT SHUTDOWN();
&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;You now need to create a new BYOL cluster onto which you will revive your database. Deploy a new cluster including a new MC instance using a BYOL entry in the marketplace of your chosen cloud platform. See:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;a href=&#34;../../../en/setup/set-up-on-cloud/on-aws/deploy-using-cloudformation-templates/deploy-mc-and-aws-resources-with-cloudformation-template/#&#34;&gt;Deploy MC and AWS resources with a CloudFormation template&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;a href=&#34;../../../en/setup/set-up-on-cloud/on-gcp/deploy-from-google-cloud-marketplace/deploy-an-mc-instance-gcp-eon/#&#34;&gt;Deploy an MC instance in GCP for Eon Mode&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class=&#34;admonition important&#34; role=&#34;alert&#34;&gt;
&lt;h4 class=&#34;admonition-head&#34;&gt;Important&lt;/h4&gt;
Your new BYOL cluster must have the same number of primary nodes as your existing hourly license cluster.
&lt;/div&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Revive your database onto the new cluster. For instructions, see &lt;a href=&#34;../../../en/eon/revive-eon-db/reviving-an-eon-db-cluster/#&#34;&gt;Revive with communal storage&lt;/a&gt;. Because you created the new cluster using a BYOL entry in the marketplace, the database uses the BYOL you applied earlier.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;After reviving the database on your new BYOL cluster, terminate the instances for your hourly license cluster and MC. For instructions, see your cloud provider&#39;s documentation.&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;a name=&#34;Move2&#34;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2 id=&#34;moving-an-eon-mode-database-from-bth-to-byol-using-the-mc&#34;&gt;Moving an Eon Mode database from BTH to BYOL using the MC&lt;/h2&gt;
&lt;p&gt;Follow this procedure to move to BYOL and revive your database using MC:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;Purchase a long-term BYOL license from the online licensing portal, following the steps detailed in &lt;a href=&#34;../../../en/admin/managing-licenses/obtaining-license-key-file/#&#34;&gt;Obtaining a license key file&lt;/a&gt;. Save the file to a location on your computer.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;You now need to install the new license on your database. Log in to MC and click your database in the Recent Databases list.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;At the bottom of your database&#39;s Overview page, click the &lt;strong&gt;License&lt;/strong&gt; tab.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Under the Installed Licenses list, note the name of the BTH license in the License Name column. You will need this later to check whether it is still present after installing the new long-term license.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;In the ribbon at the top of the License History page, click the &lt;strong&gt;Install New License&lt;/strong&gt; button. The Settings: License page opens.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Click the &lt;strong&gt;Browse&lt;/strong&gt; button next to the &lt;strong&gt;Upload a new license box&lt;/strong&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Locate the license file you obtained in step 1, and click &lt;strong&gt;Open&lt;/strong&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Click the &lt;strong&gt;Apply&lt;/strong&gt; button on the top right of the page.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Select the checkbox to agree to the EULA terms and click &lt;strong&gt;OK&lt;/strong&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;After the license installs, click the &lt;strong&gt;Close&lt;/strong&gt; button.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Click the &lt;strong&gt;License&lt;/strong&gt; tab at the bottom of the page.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;If only the new long-term license appears in the &lt;strong&gt;Installed Licenses&lt;/strong&gt; list, skip to Step 16. If the by-the-hour license also appears in the list, copy down its name from the &lt;strong&gt;License Name&lt;/strong&gt; column.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;You must drop the by-the-hour license before you can proceed. At the bottom of the page, click the &lt;strong&gt;Query Execution&lt;/strong&gt; tab.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;In the query editor, enter the following statement:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;SELECT DROP_LICENSE(&amp;#39;&lt;span class=&#34;code-variable&#34;&gt;hourly license name&lt;/span&gt;&amp;#39;);
&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Click &lt;strong&gt;Execute Query&lt;/strong&gt;. The query should complete indicating that the license has been dropped.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;You will need the path for your cluster&#39;s communal storage in a later step. If you do not already know the path, you can find this information by executing this query in the Query Execution tab:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;SELECT location_path FROM V_CATALOG.STORAGE_LOCATIONS
   WHERE sharing_type = &amp;#39;COMMUNAL&amp;#39;;
&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Synchronize your database&#39;s metadata. See &lt;a href=&#34;../../../en/eon/synchronizing-metadata/#&#34;&gt;Synchronizing metadata&lt;/a&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;You must now stop your by-the-hour database cluster. At the bottom of the page, click the &lt;strong&gt;Manage&lt;/strong&gt; tab.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;In the banner at the top of the page, click &lt;strong&gt;Stop Database&lt;/strong&gt; and then click &lt;strong&gt;OK&lt;/strong&gt; to confirm.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;From the &lt;a href=&#34;https://aws.amazon.com/marketplace/search/results?x=0&amp;amp;y=0&amp;amp;searchTerms=vertica&#34;&gt;Amazon Web Services Marketplace&lt;/a&gt; or the &lt;a href=&#34;https://cloud.google.com/marketplace/&#34;&gt;Google Cloud Marketplace&lt;/a&gt;, deploy a new Vertica Management Console using a BYOL entry. Do not deploy a full cluster. You just need an MC deployment.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Log into your new MC instance and revive the database. See &lt;a href=&#34;../../../en/mc/cloud-platforms/aws-mc/reviving-an-eon-db-on-aws-mc/#&#34;&gt;Reviving an Eon Mode database on AWS in MC&lt;/a&gt; for detailed instructions.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;After reviving the database on your new environment, terminate the instances for your hourly license environment. To do so, on the &lt;a href=&#34;https://console.aws.amazon.com/cloudformation/home&#34;&gt;AWS CloudFormation Stacks page&lt;/a&gt;, select the hourly environment&#39;s stack (its collection of AWS resources) and click &lt;strong&gt;Actions&lt;/strong&gt; &amp;gt; &lt;strong&gt;Delete Stack&lt;/strong&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;a name=&#34;Move3&#34;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2 id=&#34;moving-an-enterprise-mode-database-from-hourly-to-byol-using-backup-and-restore&#34;&gt;Moving an Enterprise Mode database from hourly to BYOL using backup and restore&lt;/h2&gt;

&lt;div class=&#34;alert admonition note&#34; role=&#34;alert&#34;&gt;
&lt;h4 class=&#34;admonition-head&#34;&gt;Note&lt;/h4&gt;

Currently, AWS is the only platform supported for Enterprise Mode databases using hourly licenses.

&lt;/div&gt;
&lt;p&gt;In an Enterprise Mode database, follow this procedure to move to BYOL, and then back up and restore your database:
&lt;p&gt;Obtain a long-term BYOL license from the online licensing portal, described in &lt;a href=&#34;../../../en/admin/managing-licenses/obtaining-license-key-file/#&#34;&gt;Obtaining a license key file&lt;/a&gt;.Upload the license file to a node in your database. Note the absolute path in the node&#39;s filesystem, as you will need this later when installing the license.Connect to the node you uploaded the license file to in the previous step.
Connect to your database using &lt;a class=&#34;glosslink&#34; href=&#34;../../../en/glossary/vsql/&#34; title=&#34;For more information, see Installing the vsql Client and the more general topic, Using vsql.&#34;&gt;vsql&lt;/a&gt; and view the licenses table:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT * FROM licenses;
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;Note the name of the hourly license listed in the NAME column, so you can check if it is still present later.&lt;/p&gt;
&lt;p&gt;Install the license in the database using the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/catalog-functions/install-license/#&#34;&gt;INSTALL_LICENSE&lt;/a&gt; function with the absolute path to the license file you uploaded in step 2:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT install_license(&amp;#39;&lt;span class=&#34;code-variable&#34;&gt;absolute path to BYOL license&lt;/span&gt;&amp;#39;);
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;View the licenses table again:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT * FROM licenses;
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;If only the new BYOL license appears in the table, skip to step 8. If the hourly license whose name you noted in step 4 is still in the table, copy the name and proceed to step 7.&lt;/p&gt;
&lt;p&gt;Call the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/catalog-functions/drop-license/#&#34;&gt;DROP_LICENSE&lt;/a&gt; function to drop the hourly license:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT drop_license(&amp;#39;&lt;span class=&#34;code-variable&#34;&gt;hourly license name&lt;/span&gt;&amp;#39;);
&lt;/code&gt;&lt;/pre&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;Back up the database. See &lt;a href=&#34;../../../en/admin/backup-and-restore/#&#34;&gt;Backing up and restoring the database&lt;/a&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Deploy a new cluster for your database using one of the BYOL entries in the &lt;a href=&#34;https://aws.amazon.com/marketplace/search/results?x=0&amp;amp;y=0&amp;amp;searchTerms=vertica&#34;&gt;Amazon Web Services Marketplace&lt;/a&gt;. &lt;br /&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Restore the database from the backup you created earlier. See &lt;a href=&#34;../../../en/admin/backup-and-restore/#&#34;&gt;Backing up and restoring the database&lt;/a&gt;. When you restore the database, it will use the BYOL you loaded earlier.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;After restoring the database on your new environment, terminate the instances for your hourly license environment. To do so, on the &lt;a href=&#34;https://console.aws.amazon.com/cloudformation/home&#34;&gt;AWS CloudFormation Stacks page&lt;/a&gt;, select the hourly environment&#39;s stack (its collection of AWS resources) and click &lt;strong&gt;Actions&lt;/strong&gt; &amp;gt; &lt;strong&gt;Delete Stack&lt;/strong&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;After completing one of these procedures, see &lt;a href=&#34;../../../en/admin/managing-licenses/viewing-your-license-status/#&#34;&gt;Viewing your license status&lt;/a&gt; to confirm the license drop and install were successful.&lt;/p&gt;

      </description>
    </item>
    
    <item>
      <title>Admin: Auditing database size</title>
      <link>/en/admin/managing-licenses/auditing-db-size/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/admin/managing-licenses/auditing-db-size/</guid>
      <description>
        
        
        &lt;p&gt;You can use your OpenText™ Analytics Database software until columnar data reaches the maximum raw data size that your license agreement allows. The database periodically runs an audit of the columnar data size to verify that your database complies with this agreement. You can also run your own audits of database size with two functions:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;span class=&#34;sql&#34;&gt;&lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/audit/#&#34;&gt;AUDIT&lt;/a&gt;&lt;/span&gt;: Estimates the raw data size of a database, schema, or table.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;span class=&#34;sql&#34;&gt;&lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/audit-flex/#&#34;&gt;AUDIT_FLEX&lt;/a&gt;&lt;/span&gt;: Estimates the size of one or more flexible tables in a database, schema, or projection.&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The following two examples audit the database and one schema:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT AUDIT(&amp;#39;&amp;#39;, &amp;#39;database&amp;#39;);
  AUDIT
----------
 76376696
(1 row)
&lt;/code&gt;&lt;/pre&gt;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT AUDIT(&amp;#39;online_sales&amp;#39;, &amp;#39;schema&amp;#39;);
  AUDIT
----------
 35716504
(1 row)
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;raw-data-size&#34;&gt;Raw data size&lt;/h2&gt;
&lt;p&gt;&lt;span class=&#34;sql&#34;&gt;AUDIT&lt;/span&gt; and &lt;span class=&#34;sql&#34;&gt;AUDIT_FLEX&lt;/span&gt; use statistical sampling to estimate the raw data size of data stored in tables—that is, the uncompressed data that the database stores. For most data types, the database evaluates the raw data size as if the data were exported from the database in text format, rather than as compressed data. For details, see &lt;a href=&#34;#Evaluati&#34;&gt;Evaluating Data Type Footprint&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;By using statistical sampling, the audit minimizes its impact on database performance. The tradeoff between accuracy and performance impact is a small margin of error. Reports on your database size include the margin of error, so you can assess the accuracy of the estimate.&lt;/p&gt;
&lt;p&gt;Data in ORC and Parquet-based external tables are also audited whether they are stored locally in the database cluster&#39;s file system or remotely in S3 or on a Hadoop cluster. &lt;span class=&#34;sql&#34;&gt;AUDIT&lt;/span&gt; always uses the file size of the underlying data files as the amount of data in the table. For example, suppose you have an external table based on 1GB of ORC files stored in HDFS. Then an audit of the table reports it as being 1GB in size.

&lt;div class=&#34;alert admonition note&#34; role=&#34;alert&#34;&gt;
&lt;h4 class=&#34;admonition-head&#34;&gt;Note&lt;/h4&gt;

The database audit does not verify that these files contain actual ORC or Parquet data. It just checks the size of the files that correspond to the external table definition.

&lt;/div&gt;&lt;/p&gt;
&lt;h2 id=&#34;unaudited-data&#34;&gt;Unaudited data&lt;/h2&gt;
&lt;p&gt;Table data that appears in multiple projections is counted only once. An audit also excludes the following data:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;Temporary table data.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Data in &lt;a href=&#34;../../../en/data-analysis/flattened-tables/&#34;&gt;SET USING&lt;/a&gt; columns.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Non-columnar data accessible through external table definitions. Data in columnar formats such as ORC and Parquet count against your totals.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Data that was deleted but not yet &lt;a href=&#34;../../../en/admin/working-with-native-tables/removing-table-data/purging-deleted-data/&#34;&gt;purged&lt;/a&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Data stored in system and work tables such as monitoring tables, &lt;a class=&#34;glosslink&#34; href=&#34;../../../en/glossary/data-collector/&#34; title=&#34;A utility that collects and retains database monitoring information.&#34;&gt;Data collector&lt;/a&gt; tables, and Database Designer tables.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Delimiter characters.&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;a name=&#34;Evaluati&#34;&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2 id=&#34;evaluating-data-type-footprint&#34;&gt;Evaluating data type footprint&lt;/h2&gt;
&lt;p&gt;The database evaluates the footprint of different data types as follows:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;Strings and binary types—CHAR, VARCHAR, BINARY, VARBINARY—are counted as their actual size in bytes using UTF-8 encoding.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Numeric data types are evaluated as if they were printed. Each digit counts as a byte, as does any decimal point, sign, or scientific notation. For example, &lt;code&gt;-123.456&lt;/code&gt; counts as eight bytes—six digits plus the decimal point and minus sign.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Date/time data types are evaluated as if they were converted to text, including hyphens, spaces, and colons. For example, vsql prints a timestamp value of &lt;code&gt;2011-07-04 12:00:00&lt;/code&gt; as 19 characters, or 19 bytes.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Complex types are evaluated as the sum of the sizes of their component parts. An array is counted as the total size of all elements, and a ROW is counted as the total size of all fields.&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&#34;controlling-audit-accuracy&#34;&gt;Controlling audit accuracy&lt;/h2&gt;
&lt;p&gt;&lt;span class=&#34;sql&#34;&gt;&lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/audit/#&#34;&gt;AUDIT&lt;/a&gt;&lt;/span&gt; can specify the level of an audit&#39;s error tolerance and confidence, by default set to 5 and 99 percent, respectively. For example, you can obtain a high level of audit accuracy by setting error tolerance and confidence level to 0 and 100 percent, respectively. Unlike estimating raw data size with statistical sampling, the database dumps all audited data to a raw format to calculate its size.

&lt;div class=&#34;admonition caution&#34; role=&#34;alert&#34;&gt;
&lt;h4 class=&#34;admonition-head&#34;&gt;Caution&lt;/h4&gt;

It is discouraged to perform database-wide audits at this level. Doing so can have a significant adverse impact on database performance.

&lt;/div&gt;&lt;/p&gt;
&lt;p&gt;The following example audits the database with 25% error tolerance:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT AUDIT(&amp;#39;&amp;#39;, 25);
  AUDIT
----------
 75797126
(1 row)
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;The following example audits the database with 25% level of tolerance and 90% confidence level:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT AUDIT(&amp;#39;&amp;#39;,25,90);
  AUDIT
----------
 76402672
(1 row)
&lt;/code&gt;&lt;/pre&gt;
&lt;div class=&#34;alert admonition note&#34; role=&#34;alert&#34;&gt;
&lt;h4 class=&#34;admonition-head&#34;&gt;Note&lt;/h4&gt;

These accuracy settings have no effect on audits of external tables based on ORC or Parquet files. Audits of external tables based on these formats always use the file size of ORC or Parquet files.

&lt;/div&gt;

      </description>
    </item>
    
    <item>
      <title>Admin: Monitoring database size for license compliance</title>
      <link>/en/admin/managing-licenses/monitoring-db-size-license-compliance/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/admin/managing-licenses/monitoring-db-size-license-compliance/</guid>
      <description>
        
        
        &lt;p&gt;Your OpenText™ Analytics Database license can include a data storage allowance. The allowance can consist of data in columnar tables, flex tables, or both types of data. The &lt;code&gt;AUDIT()&lt;/code&gt; function estimates the columnar table data size and any flex table materialized columns. The &lt;code&gt;AUDIT_FLEX()&lt;/code&gt; function estimates the amount of &lt;code&gt;__raw__&lt;/code&gt; column data in flex or columnar tables. In regards to license data limits, data in &lt;code&gt;__raw__&lt;/code&gt; columns is calculated at 1/10th the size of structured data. Monitoring data sizes for columnar and flex tables lets you plan either to schedule deleting old data to keep your database in compliance with your license, or to consider a license upgrade for additional data storage.

&lt;div class=&#34;alert admonition note&#34; role=&#34;alert&#34;&gt;
&lt;h4 class=&#34;admonition-head&#34;&gt;Note&lt;/h4&gt;

An audit of columnar data includes flex table real and materialized columns, but not &lt;code&gt;__raw__&lt;/code&gt; column data.

&lt;/div&gt;&lt;/p&gt;
&lt;h2 id=&#34;viewing-your-license-compliance-status&#34;&gt;Viewing your license compliance status&lt;/h2&gt;
&lt;p&gt;The database periodically runs an audit of the columnar data size to verify that your database is compliant with your license terms. You can view the results of the most recent audit by calling the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/get-compliance-status/#&#34;&gt;GET_COMPLIANCE_STATUS&lt;/a&gt; function.&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;
=&amp;gt; select GET_COMPLIANCE_STATUS();
                       GET_COMPLIANCE_STATUS
---------------------------------------------------------------------------------
 Raw Data Size: 2.00GB +/- 0.003GB
 License Size : 4.000GB
 Utilization  : 50%
 Audit Time   : 2011-03-09 09:54:09.538704+00
 Compliance Status : The database is in compliance with respect to raw data size.
 License End Date: 04/06/2011
 Days Remaining: 28.59
(1 row)
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Periodically running GET_COMPLIANCE_STATUS to monitor your database&#39;s license status is usually enough to ensure that your database remains compliant with your license. If your database begins to near its columnar data allowance, you can use the other auditing functions described below to determine where your database is growing and how recent deletes affect the database size.&lt;/p&gt;
&lt;h2 id=&#34;manually-auditing-columnar-data-usage&#34;&gt;Manually auditing columnar data usage&lt;/h2&gt;
&lt;p&gt;You can manually check license compliance for all columnar data in your database using the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/audit-license-size/#&#34;&gt;AUDIT_LICENSE_SIZE&lt;/a&gt; function. This function performs the same audit that the database periodically performs automatically. The &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/audit-license-size/#&#34;&gt;AUDIT_LICENSE_SIZE&lt;/a&gt; check runs in the background, so the function returns immediately. You can then query the results using &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/get-compliance-status/#&#34;&gt;GET_COMPLIANCE_STATUS&lt;/a&gt;.

&lt;div class=&#34;alert admonition note&#34; role=&#34;alert&#34;&gt;
&lt;h4 class=&#34;admonition-head&#34;&gt;Note&lt;/h4&gt;

When you audit columnar data, the results include any flex table real and materialized columns, but not data in the &lt;code&gt;__raw__&lt;/code&gt; column. Materialized columns are virtual columns that you have promoted to real columns. Columns that you define when creating a flex table, or which you add with &lt;code&gt;ALTER TABLE...ADD COLUMN&lt;/code&gt; statements are real columns. All &lt;code&gt;__raw__&lt;/code&gt; columns are real columns. However, since they consist of unstructured or semi-structured data, they are audited separately.

&lt;/div&gt;&lt;/p&gt;
&lt;p&gt;An alternative to AUDIT_LICENSE_SIZE is to use the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/audit/#&#34;&gt;AUDIT&lt;/a&gt; function to audit the size of the columnar tables in your entire database by passing an empty string to the function. This function operates synchronously, returning when it has estimated the size of the database.&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT AUDIT(&amp;#39;&amp;#39;);
  AUDIT
----------
 76376696
(1 row)
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;The size of the database is reported in bytes. The AUDIT function also allows you to control the accuracy of the estimated database size using additional parameters. See the entry for the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/audit/#&#34;&gt;AUDIT&lt;/a&gt; function for full details. The database does not count the AUDIT function results as an official audit. It takes no license compliance actions based on the results.

&lt;div class=&#34;alert admonition note&#34; role=&#34;alert&#34;&gt;
&lt;h4 class=&#34;admonition-head&#34;&gt;Note&lt;/h4&gt;

The results of the AUDIT function do not include flex table data in &lt;code&gt;__raw__&lt;/code&gt; columns. Use the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/audit-flex/#&#34;&gt;AUDIT_FLEX&lt;/a&gt; function to monitor data usage flex tables.

&lt;/div&gt;&lt;/p&gt;
&lt;h2 id=&#34;manually-auditing-__raw__-column-data&#34;&gt;Manually auditing __raw__ column data&lt;/h2&gt;
&lt;p&gt;You can use the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/audit-flex/#&#34;&gt;AUDIT_FLEX&lt;/a&gt; function to manually audit data usage for flex or columnar tables with a &lt;code&gt;__raw__&lt;/code&gt; column. The function calculates the encoded, compressed data stored in ROS containers for any &lt;code&gt;__raw__&lt;/code&gt; columns. Materialized columns in flex tables are calculated by the &lt;code&gt;AUDIT&lt;/code&gt; function. The &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/audit-flex/#&#34;&gt;AUDIT_FLEX&lt;/a&gt; results do not include data in the &lt;code&gt;__raw__&lt;/code&gt; columns of temporary flex tables.&lt;/p&gt;
&lt;h2 id=&#34;targeted-auditing&#34;&gt;Targeted auditing&lt;/h2&gt;
&lt;p&gt;If audits determine that the columnar table estimates are unexpectedly large, consider schemas, tables, or partitions that are using the most storage. You can use the AUDIT function to perform targeted audits of schemas, tables, or partitions by supplying the name of the entity whose size you want to find. For example, to find the size of the online_sales schema in the &lt;a href=&#34;../../../en/getting-started/introducing-vmart-example-db/&#34;&gt;VMart&lt;/a&gt; example database, run the following command:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; SELECT AUDIT(&amp;#39;online_sales&amp;#39;);
  AUDIT
----------
 35716504
(1 row)
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;You can also change the granularity of an audit to report the size of each object in a larger entity (for example, each table in a schema) by using the granularity argument of the AUDIT function. See the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/audit/#&#34;&gt;AUDIT&lt;/a&gt; function.&lt;/p&gt;
&lt;h2 id=&#34;using-management-console-to-monitor-license-compliance&#34;&gt;Using Management Console to monitor license compliance&lt;/h2&gt;
&lt;p&gt;You can also get information about data storage of columnar data (for columnar tables and for materialized columns in flex tables) through the Management Console. This information is available in the database Overview page, which displays a grid view of the database&#39;s overall health.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;The needle in the license meter adjusts to reflect the amount used in megabytes.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;The grace period represents the term portion of the license.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;The Audit button returns the same information as the AUDIT() function in a graphical representation.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;The Details link within the License grid (next to the Audit button) provides historical information about license usage. This page also shows a progress meter of percent used toward your license limit.&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;

      </description>
    </item>
    
    <item>
      <title>Admin: Managing license warnings and limits</title>
      <link>/en/admin/managing-licenses/managing-license-warnings-and-limits/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/admin/managing-licenses/managing-license-warnings-and-limits/</guid>
      <description>
        
        
        &lt;h2 id=&#34;term-license-warnings-and-expiration&#34;&gt;Term license warnings and expiration&lt;/h2&gt;
&lt;p&gt;The term portion of an OpenText™ Analytics Database license is easy to manage—you are licensed to use the database until a specific date. If the term of your license expires, you are alerted with messages appearing in the &lt;a class=&#34;glosslink&#34; href=&#34;../../../en/glossary/admin-tools/&#34; title=&#34;OpenText&amp;amp;trade; Analytics Database Administration Tools provides a graphical user interface for managing the database.&#34;&gt;Administration tools&lt;/a&gt; and &lt;a class=&#34;glosslink&#34; href=&#34;../../../en/glossary/vsql/&#34; title=&#34;For more information, see Installing the vsql Client and the more general topic, Using vsql.&#34;&gt;vsql&lt;/a&gt;. For example:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;=&amp;gt; CREATE TABLE T (A INT);
NOTICE 8723: Vertica license 432d8e57-5a13-4266-a60d-759275416eb2 is in its grace period; grace period expires in 28 days
HINT: Renew at https://softwaresupport.softwaregrp.com/
CREATE TABLE
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;Contact OpenText at &lt;a href=&#34;https://softwaresupport.softwaregrp.com/&#34;&gt;https://softwaresupport.softwaregrp.com/&lt;/a&gt; as soon as possible to renew your license, and then &lt;a href=&#34;../../../en/admin/managing-licenses/installing-or-upgrading-license-key/&#34;&gt;install the new license&lt;/a&gt;. After the grace period expires, the database stops processing DML queries and allows DDL queries with a warning message. If a license expires and one or more valid alternative licenses are installed, the database uses the alternative licenses.&lt;/p&gt;
&lt;h2 id=&#34;data-size-license-warnings-and-remedies&#34;&gt;Data size license warnings and remedies&lt;/h2&gt;
&lt;p&gt;If your database columnar license includes a raw data size allowance, the database periodically audits the size of your database to ensure it remains compliant with the license agreement. For details of this audit, see &lt;a href=&#34;../../../en/admin/managing-licenses/auditing-db-size/#&#34;&gt;Auditing database size&lt;/a&gt;. You should also monitor your database size to know when it will approach licensed usage. Monitoring the database size helps you plan to either upgrade your license to allow for continued database growth or delete data from the database so you remain compliant with your license. See &lt;a href=&#34;../../../en/admin/managing-licenses/monitoring-db-size-license-compliance/#&#34;&gt;Monitoring database size for license compliance&lt;/a&gt; for details.&lt;/p&gt;
&lt;p&gt;If your database&#39;s size approaches your licensed usage allowance (above 75% of license limits), you will see warnings in the &lt;a class=&#34;glosslink&#34; href=&#34;../../../en/glossary/admin-tools/&#34; title=&#34;OpenText&amp;amp;trade; Analytics Database Administration Tools provides a graphical user interface for managing the database.&#34;&gt;Administration tools&lt;/a&gt; , &lt;a class=&#34;glosslink&#34; href=&#34;../../../en/glossary/vsql/&#34; title=&#34;For more information, see Installing the vsql Client and the more general topic, Using vsql.&#34;&gt;vsql&lt;/a&gt;, and Management Console. You have two options to eliminate these warnings:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;Upgrade your license to a larger data size allowance.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Delete data from your database to remain under your licensed raw data size allowance. The warnings disappear after the next audit of the database size shows that it is no longer close to or over the licensed amount. You can also manually run a database audit (see &lt;a href=&#34;../../../en/admin/managing-licenses/monitoring-db-size-license-compliance/#&#34;&gt;Monitoring database size for license compliance&lt;/a&gt; for details).&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;If your database continues to grow after you receive warnings that its size is approaching your licensed size allowance, additional warnings are displayed in more parts of the system after a grace period passes. Use the &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/license-functions/get-compliance-status/#&#34;&gt;GET_COMPLIANCE_STATUS&lt;/a&gt; function to check the status of your license.&lt;/p&gt;
&lt;h2 id=&#34;if-your-premium-edition-database-size-exceeds-your-licensed-limits&#34;&gt;If your premium edition database size exceeds your licensed limits&lt;/h2&gt;
&lt;p&gt;If your Premium Edition database size exceeds your licensed data allowance, all successful queries from ODBC and JDBC clients return with a status of SUCCESS_WITH_INFO instead of the usual SUCCESS. The message sent with the results contains a warning about the database size. Your ODBC and JDBC clients should be prepared to handle these messages instead of assuming that successful requests always return SUCCESS.

&lt;div class=&#34;alert admonition note&#34; role=&#34;alert&#34;&gt;
&lt;h4 class=&#34;admonition-head&#34;&gt;Note&lt;/h4&gt;

These warnings for Premium Edition are in addition to any warnings you see in Administration Tools, vsql, and Management Console.

&lt;/div&gt;&lt;/p&gt;
&lt;h2 id=&#34;if-your-trial-license-database-size-exceeds-1-terabyte&#34;&gt;If your Trial license database size exceeds 1 terabyte&lt;/h2&gt;
&lt;p&gt;If your Trial license database size exceeds the limit of 1 terabyte, the database stops processing queries.&lt;/p&gt;
&lt;p&gt;To bring your database under compliance, you can choose to:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;Drop database tables. You can also consider truncating a table or dropping a partition. See &lt;a href=&#34;../../../en/sql-reference/statements/truncate-table/#&#34;&gt;TRUNCATE TABLE&lt;/a&gt; or &lt;a href=&#34;../../../en/sql-reference/functions/management-functions/partition-functions/drop-partitions/#&#34;&gt;DROP_PARTITIONS&lt;/a&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Upgrade to Commercial license.&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;

      </description>
    </item>
    
    <item>
      <title>Admin: Exporting license audit results to CSV</title>
      <link>/en/admin/managing-licenses/exporting-license-audit-results-to-csv/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/admin/managing-licenses/exporting-license-audit-results-to-csv/</guid>
      <description>
        
        
        &lt;p&gt;You can use &lt;code&gt;admintools&lt;/code&gt; to audit a database for license compliance and export the results in CSV format, as follows:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;admintools -t license_audit [--password=&lt;span class=&#34;code-variable&#34;&gt;password&lt;/span&gt;] --database=&lt;span class=&#34;code-variable&#34;&gt;database&lt;/span&gt;] [--file=&lt;span class=&#34;code-variable&#34;&gt;csv-file&lt;/span&gt;] [--quiet]
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;where:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;em&gt;&lt;code&gt;database&lt;/code&gt;&lt;/em&gt; must be a running database. If the database is password protected, you must also supply the password.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;code&gt;--file &lt;/code&gt;&lt;em&gt;&lt;code&gt;csv-file&lt;/code&gt;&lt;/em&gt; directs output to the specified file. If &lt;em&gt;&lt;code&gt;csv-file&lt;/code&gt;&lt;/em&gt; already exists, the tool returns an error message. If this option is unspecified, output is directed to &lt;code&gt;stdout&lt;/code&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;code&gt;--quiet&lt;/code&gt; specifies that the tool should run in quiet mode; if unspecified, status messages are sent to &lt;code&gt;stdout&lt;/code&gt;.&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Running the &lt;code&gt;license_audit&lt;/code&gt; tool is equivalent to invoking the following SQL statements:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;
select audit(&amp;#39;&amp;#39;);
select audit_flex(&amp;#39;&amp;#39;);
select * from dc_features_used;
select * from v_catalog.license_audits;
select * from v_catalog.user_audits;
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;Audit results include the following information:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;Log of used database features&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Estimated database size&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Raw data size allowed by your database license&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Percentage of licensed allowance that the database currently uses&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Audit timestamps&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The following truncated example shows the raw CSV output that &lt;code&gt;license_audit&lt;/code&gt; generates:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;
FEATURES_USED
features_used,feature,date,sum
features_used,metafunction::get_compliance_status,2014-08-04,1
features_used,metafunction::bootstrap_license,2014-08-04,1
...

LICENSE_AUDITS
license_audits,database_size_bytes,license_size_bytes,usage_percent,audit_start_timestamp,audit_end_timestamp,confidence_level_percent,error_tolerance_percent,used_sampling,confidence_interval_lower_bound_bytes,confidence_interval_upper_bound_bytes,sample_count,cell_count,license_name
license_audits,808117909,536870912000,0.00150523690320551,2014-08-04 23:59:00.024874-04,2014-08-04 23:59:00.578419-04,99,5,t,785472097,830763721,10000,174754646,vertica
...

USER_AUDITS
user_audits,size_bytes,user_id,user_name,object_id,object_type,object_schema,object_name,audit_start_timestamp,audit_end_timestamp,confidence_level_percent,error_tolerance_percent,used_sampling,confidence_interval_lower_bound_bytes,confidence_interval_upper_bound_bytes,sample_count,cell_count
user_audits,812489249,45035996273704962,dbadmin,45035996273704974,DATABASE,,VMart,2014-10-14 11:50:13.230669-04,2014-10-14 11:50:14.069057-04,99,5,t,789022736,835955762,10000,174755178

AUDIT_SIZE_BYTES
audit_size_bytes,now,audit
audit_size_bytes,2014-10-14 11:52:14.015231-04,810584417

FLEX_SIZE_BYTES
flex_size_bytes,now,audit_flex
flex_size_bytes,2014-10-14 11:52:15.117036-04,11850
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
  </channel>
</rss>
