OpenMetadata/openmetadata-docs/content/v1.0.0/deployment/upgrade/versions/013-to-100.md

title	slug
Upgrade 0.13 to 1.0	/deployment/upgrade/versions/013-to-100

Upgrade from 0.13 to 1.0

Upgrading from 0.13 to 1.0 can be done directly on your instances. This page will list few general details you should take into consideration when running the upgrade.

1.0.0 Highlights

Service Connection Updates

• Postgres:

  • The database field for Postgres connector has been made a required field as initial database is required to connect to Postgres.
  • Ingest All Database field has been added since earlier when database field was empty we were ingesting all the databases but since now we have made the database field required you need to enable Ingest All Database flag in case you want to ingest all the available database in OpenMetadata.

• BigQuery:

  • Removed: partitionQueryDuration, partitionQuery & partitionField
    • since these fields are not used during the ingestion and has already being moved to profiler hence we have removed these fields.

• Salesforce:

  • Removed: scheme, hostPort, supportsProfiler & supportsQueryComment
    • These fields are related to a SQLAlchemy based connector and since Salesforce is based on APIs and not SQLAlchemy, these fields has been removed

• Superset:

  • Removed: connectionOptions
    • This field was not being used anywhere, hence removed.

Breaking Changes for 1.0 Stable Release

JWT Authentication Public Keys URL Change

With Release 1.0.0, JWT Authentication endpoint needs to be updated from {OPENMETADATA_HOST_NAME}/api/v1/config/jwks to {OPENMETADATA_HOST_NAME}/api/v1/system/config/jwks. This is required as part of API Endpoints. The Environment variable name is AUTHENTICATION_PUBLIC_KEYS. It expects list of URLs. One of the URL will be for OpenMetadata JWT Authentication Endpoint.

Airflow Configuration & Pipeline Service Client

The new section on the openmetadata.yaml configuration for the Pipeline Service Client has been updated.

We now have a pipelineServiceClientConfiguration, instead of the old airflowConfiguration.

pipelineServiceClientConfiguration:
  className: ${PIPELINE_SERVICE_CLIENT_CLASS_NAME:-"org.openmetadata.service.clients.pipeline.airflow.AirflowRESTClient"}
  apiEndpoint: ${PIPELINE_SERVICE_CLIENT_ENDPOINT:-http://localhost:8080}
  metadataApiEndpoint: ${SERVER_HOST_API_URL:-http://localhost:8585/api}
  hostIp: ${PIPELINE_SERVICE_CLIENT_HOST_IP:-""}
  verifySSL: ${PIPELINE_SERVICE_CLIENT_VERIFY_SSL:-"no-ssl"} # Possible values are "no-ssl", "ignore", "validate"
  sslConfig:
    validate:
      certificatePath: ${PIPELINE_SERVICE_CLIENT_SSL_CERT_PATH:-""} # Local path for the Pipeline Service Client

  # Default required parameters for Airflow as Pipeline Service Client
  parameters:
    username: ${AIRFLOW_USERNAME:-admin}
    password: ${AIRFLOW_PASSWORD:-admin}
    timeout: ${AIRFLOW_TIMEOUT:-10}

Most existing environment variables remain the same, except for these three:

• AIRFLOW_HOST_IP → PIPELINE_SERVICE_CLIENT_HOST_IP
• AIRFLOW_VERIFY_SSL → PIPELINE_SERVICE_CLIENT_VERIFY_SSL
• AIRFLOW_SSL_CERT_PATH → PIPELINE_SERVICE_CLIENT_SSL_CERT_PATH

When upgrading, make sure to update the environment variables and, if working on Bare Metal, make sure to use the updated openmetadata.yaml.

Deprecation Notice

• When configuring Bots, JWT tokens will be the preferred method of authentication. Any existing SSO-based service accounts will continue to work on 1.0, but will be fully deprecated on future releases.
• As we added the new Impala connector, We will remove the impala scheme from Hive in the next release.

API Endpoint Changes

The following endpoints have been renamed in 1.0

Previous Endpoint	New Endpoint
api/v1	Removed
api/v1/services	Removed
api/v1/version	api/v1/system/version
api/v1/util/entities/count	api/v1/system/entities/count
api/v1/util/services/count	api/v1/system/services/count
api/v1/settings	api/v1/system/settings
api/v1/config	api/v1/system/config
api/v1/testSuite	api/v1/dataQuality/testSuites
api/v1/testCase	api/v1/dataQuality/testCases
api/v1/testDefinition	api/v1/dataQuality/testDefinitions
api/v1/automations/workflow	api/v1/automations/workflows
api/v1/events/subscription	api/v1/events/subscriptions
api/v1/analytic/reportData	api/v1/analytics/dataInsights/data
api/v1/analytics/webAnalyticEvent/	api/v1/analytics/web/events/
api/v1/indexResource/reindex	api/v1/search/reindex
api/v1/indexResource/reindex/status/{runMode}	api/v1/search/reindex/status/{runMode}

Sample Data Deprecation

The SampleData service has been deprecated. It is now a CustomConnector. If you have some entities in SampleData, please DELETE the service if you don’t want to keep them, or we can help you migrate them to a Custom Connector.

Note that this service type was mostly used on quickstarts and tests to add some example assets into OpenMetadata. This should be transparent for most of the users.

Location Entity

We are deprecating the Location Entity in favor of the Containers and new Storage Service:

• Dropping the location_entity table,
• Removing the Location APIs.

If you did not have any custom implementation, this was partially used in the Glue Database connector. However, the information was not being actively shown.

If you had custom implementations on top of the Location APIs, reach out to us, and we can help migrate to the new Storage Services.

AWS Connectors

The endpointURL property is now formatted as a proper URI, e.g., http://something.com. If you have added this configuration in your connectors, please update the endpointURL format with the right scheme.

Note that this property is OPTIONAL, and for the most cases it will either be left blank or already configured with the right format for it to work properly, e.g., s3://....

Python SDK Submodules name change

• metadata.test_suite.*: this submodule has been renamed metadata.data_quality.*. You can view the full change here
• metadata.orm_profiler.*: this submodule has been renamed metadata.profiler.*. You can view the full change here