| <!doctype html> |
| <html class="docs-version-1.1.2" lang="en" dir="ltr"> |
| <head> |
| <meta charset="UTF-8"> |
| <meta name="viewport" content="width=device-width,initial-scale=1"> |
| <meta name="generator" content="Docusaurus v2.0.0-beta.14"> |
| <link rel="alternate" type="application/rss+xml" href="/blog/rss.xml" title="Apache Linkis Blog RSS Feed"> |
| <link rel="alternate" type="application/atom+xml" href="/blog/atom.xml" title="Apache Linkis Blog Atom Feed"> |
| <link rel="search" type="application/opensearchdescription+xml" title="Apache Linkis" href="/opensearch.xml"><title data-react-helmet="true">Version upgrades above 1.0.3 | Apache Linkis</title><meta data-react-helmet="true" name="twitter:card" content="summary_large_image"><meta data-react-helmet="true" property="og:url" content="https://linkis.incubator.apache.org/docs/latest/upgrade/upgrade_guide"><meta data-react-helmet="true" name="docsearch:language" content="en"><meta data-react-helmet="true" name="docsearch:version" content="1.1.2"><meta data-react-helmet="true" name="docsearch:docusaurus_tag" content="docs-default-1.1.2"><meta data-react-helmet="true" property="og:title" content="Version upgrades above 1.0.3 | Apache Linkis"><meta data-react-helmet="true" name="description" content="This article briefly introduces the general upgrade process for versions above 1.0.3"><meta data-react-helmet="true" property="og:description" content="This article briefly introduces the general upgrade process for versions above 1.0.3"><link data-react-helmet="true" rel="shortcut icon" href="/img/favicon.ico"><link data-react-helmet="true" rel="canonical" href="https://linkis.incubator.apache.org/docs/latest/upgrade/upgrade_guide"><link data-react-helmet="true" rel="alternate" href="https://linkis.incubator.apache.org/docs/latest/upgrade/upgrade_guide" hreflang="en"><link data-react-helmet="true" rel="alternate" href="https://linkis.incubator.apache.org/zh-CN/docs/latest/upgrade/upgrade_guide" hreflang="zh-CN"><link data-react-helmet="true" rel="alternate" href="https://linkis.incubator.apache.org/docs/latest/upgrade/upgrade_guide" hreflang="x-default"><link data-react-helmet="true" rel="preconnect" href="https://AE29KQB3IA-dsn.algolia.net" crossorigin="anonymous"><link rel="stylesheet" href="/assets/css/styles.92d87943.css"> |
| <link rel="preload" href="/assets/js/runtime~main.a4c60f50.js" as="script"> |
| <link rel="preload" href="/assets/js/main.42471b13.js" as="script"> |
| </head> |
| <body> |
| <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"light")}()</script><div id="__docusaurus"> |
| <div><a href="#" class="skipToContent_OuoZ">Skip to main content</a></div><nav class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Navigation bar toggle" class="navbar__toggle clean-btn" type="button" tabindex="0"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><img src="/img/logo.png" alt="Apache Linkis Logo" class="themedImage_TMUO themedImage--light_4Vu1 navbar__logo"><img src="/img/logo.png" alt="Apache Linkis Logo" class="themedImage_TMUO themedImage--dark_uzRr navbar__logo"><b class="navbar__title">Apache Linkis(Incubating)</b></a><a class="navbar__item navbar__link" href="/">Home</a><a class="navbar__item navbar__link" href="/faq/main">FAQ</a><a class="navbar__item navbar__link" href="/download/main">Download</a><a class="navbar__item navbar__link" href="/community/how-to-subscribe">Community</a><a class="navbar__item navbar__link" href="/blog">Blog</a><a class="navbar__item navbar__link" href="/team">Team</a><a class="navbar__item navbar__link" href="/user">Users</a><div class="navbar__item dropdown dropdown--hoverable"><a class="navbar__link">ASF</a><ul class="dropdown__menu"><li><a href="https://www.apache.org/" target="_blank" rel="noopener noreferrer" class="dropdown__link">Foundation</a></li><li><a href="https://www.apache.org/licenses/" target="_blank" rel="noopener noreferrer" class="dropdown__link">License</a></li><li><a href="https://www.apache.org/events/current-event" target="_blank" rel="noopener noreferrer" class="dropdown__link">Events</a></li><li><a href="https://www.apache.org/security/" target="_blank" rel="noopener noreferrer" class="dropdown__link">Security</a></li><li><a href="https://www.apache.org/foundation/sponsorship.html" target="_blank" rel="noopener noreferrer" class="dropdown__link">Sponsorship</a></li><li><a href="https://www.apache.org/foundation/policies/privacy.html" target="_blank" rel="noopener noreferrer" class="dropdown__link">Privacy</a></li><li><a href="https://www.apache.org/foundation/thanks.html" target="_blank" rel="noopener noreferrer" class="dropdown__link">Thanks</a></li></ul></div></div><div class="navbar__items navbar__items--right"><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a class="navbar__link">Doc</a><ul class="dropdown__menu"><li><a class="dropdown__link" href="/docs/1.1.3/introduction">Next(1.1.3)</a></li><li><a class="dropdown__link" href="/docs/latest/introduction">1.1.2</a></li><li><a class="dropdown__link" href="/docs/1.1.1/introduction">1.1.1</a></li><li><a class="dropdown__link" href="/docs/1.1.0/introduction">1.1.0</a></li><li><a class="dropdown__link" href="/docs/1.0.3/introduction">1.0.3</a></li><li><a class="dropdown__link" href="/docs/1.0.2/introduction">1.0.2</a></li><li><a class="dropdown__link" href="/docs/0.11.0/introduction">0.11.0</a></li><li><a class="dropdown__link" href="/versions">All Version</a></li></ul></div><a href="https://github.com/apache/incubator-linkis" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link header-github-link" aria-label="GitHub"></a><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a href="#" class="navbar__link"><span><svg t="1631348384596" class="iconLanguage_EbrZ" viewBox="0 0 1024 1024" version="1.1" p-id="557" width="20" height="20"><path d="M547.797333 638.208l-104.405333-103.168 1.237333-1.28a720.170667 720.170667 0 0 0 152.490667-268.373333h120.448V183.082667h-287.744V100.906667H347.605333v82.218666H59.818667V265.386667h459.178666a648.234667 648.234667 0 0 1-130.304 219.946666 643.242667 643.242667 0 0 1-94.976-137.728H211.541333a722.048 722.048 0 0 0 122.453334 187.434667l-209.194667 206.378667 58.368 58.368 205.525333-205.525334 127.872 127.829334 31.232-83.84m231.424-208.426667h-82.218666l-184.96 493.312h82.218666l46.037334-123.306667h195.242666l46.464 123.306667h82.218667l-185.002667-493.312m-107.690666 287.744l66.56-178.005333 66.602666 178.005333z" fill="currentColor" p-id="558"></path></svg><span>English</span></span></a><ul class="dropdown__menu"><li><a href="/docs/latest/upgrade/upgrade_guide" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" style="text-transform:capitalize">English</a></li><li><a href="/zh-CN/docs/latest/upgrade/upgrade_guide" target="_self" rel="noopener noreferrer" class="dropdown__link" style="text-transform:capitalize">简体中文</a></li></ul></div><div class="searchBox_Bc3W"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 20 20"><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke="currentColor" fill="none" fill-rule="evenodd" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"></span></button></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div class="main-wrapper docs-wrapper docs-doc-page"><div class="docPage_lDyR"><button class="clean-btn backToTopButton_i9tI" type="button"><svg viewBox="0 0 24 24" width="28"><path d="M7.41 15.41L12 10.83l4.59 4.58L18 14l-6-6-6 6z" fill="currentColor"></path></svg></button><aside class="docSidebarContainer_0YBq"><div class="sidebar_a3j0"><nav class="menu thin-scrollbar menu_cyFh menuWithAnnouncementBar_+O1J"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link menu__list-item"><a class="menu__link" href="/docs/latest/introduction">Introduction</a></li><li class="theme-doc-sidebar-item-link menu__list-item"><a class="menu__link" href="/docs/latest/release">Version Overview</a></li><li class="theme-doc-sidebar-item-category menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#">Deployment</a></li><li class="theme-doc-sidebar-item-category menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#">User Guide</a></li><li class="theme-doc-sidebar-item-category menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#">Engine Usage</a></li><li class="theme-doc-sidebar-item-category menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#">API Docs</a></li><li class="theme-doc-sidebar-item-category menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#">Table Structure</a></li><li class="theme-doc-sidebar-item-category menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#">Architecture</a></li><li class="theme-doc-sidebar-item-category menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#">Development Doc</a></li><li class="theme-doc-sidebar-item-category menu__list-item"><a class="menu__link menu__link--sublist menu__link--active" href="#">Upgrade Guide</a><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link menu__list-item"><a class="menu__link" tabindex="0" href="/docs/latest/upgrade/upgrade_from_0.X_to_1.0_guide">Upgrade From 0.X To 1.0 Guide</a></li><li class="theme-doc-sidebar-item-link menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/docs/latest/upgrade/upgrade_guide">Version upgrades above 1.0.3</a></li></ul></li><li class="theme-doc-sidebar-item-category menu__list-item menu__list-item--collapsed"><a class="menu__link menu__link--sublist" href="#">Tuning And Troubleshooting</a></li></ul></nav></div></aside><main class="docMainContainer_r8cw"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_zHA2"><div class="docItemContainer_oiyr"><article><span class="theme-doc-version-badge badge badge--secondary">Version: <!-- -->1.1.2</span><div class="tocCollapsible_aw-L theme-doc-toc-mobile tocMobile_Tx6Y"><button type="button" class="clean-btn tocCollapsibleButton_zr6a">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Version upgrades above 1.0.3</h1></header><blockquote><p>This article briefly introduces the general upgrade process for versions above 1.0.3</p></blockquote><h2><a aria-hidden="true" tabindex="-1" class="anchor anchor__h2 anchorWithStickyNavbar_y2LR" id="1-upgrade-instructions"></a>1 Upgrade Instructions<a class="hash-link" href="#1-upgrade-instructions" title="Direct link to heading">#</a></h2><ul><li>If you are installing and using Linkis for the first time, or reinstalling Linkis, you don't need to pay attention to the Linkis upgrade guide.</li><li>If components of other platforms (DataSphereStudio/Qualitis/Visualis, etc.) are involved, please confirm the compatibility between versions before upgrading, and it is best to use the recommended version.</li><li>It is recommended to control the version through the soft chain. You can switch the version by modifying the target address of the soft chain. For example: <code>linkis -> /appcom/Install/LinkisInstall/linkis-1.1.3.20220615210213</code></li><li>The upgrade process mainly requires attention to the adjustment of the database table structure and the adjustment of some configuration parameters</li><li>In addition to the upgrade of the back-end services, the management console resources of linkis also need to be upgraded together</li><li>The main changes of each version can be found in the overview information of the version <code>https://linkis.apache.org/zh-CN/docs/x.x.x/release</code> and the version <!-- -->[release-note]<!-- -->(<a href="https://linkis.apache" target="_blank" rel="noopener noreferrer">https://linkis.apache</a> .org/zh-CN/download/main): <a href="https://linkis.apache.org/zh-CN/download/main" target="_blank" rel="noopener noreferrer">https://linkis.apache.org/zh-CN/download/main</a></li><li>The database changes/configuration parameter changes of each version are based on the previous version</li></ul><h2><a aria-hidden="true" tabindex="-1" class="anchor anchor__h2 anchorWithStickyNavbar_y2LR" id="2-service-upgrade-installation"></a>2 Service upgrade installation<a class="hash-link" href="#2-service-upgrade-installation" title="Direct link to heading">#</a></h2><p>Press <a href="/docs/latest/deployment/quick_deploy">Deployment guide document</a> (the installation of the management console in the document can be skipped) to install the new version.</p><p>When installing the service, if the historical data is retained, please retain the historical data, if you do not need to retain the data, just reinstall it directly</p><div class="codeBlockContainer_J+bg"><div class="codeBlockContent_csEI shell"><pre tabindex="0" class="prism-code language-shell codeBlock_rtdJ thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_1zSZ"><span class="token-line" style="color:#F8F8F2"><span class="token plain">Do you want to </span><span class="token function" style="color:rgb(80, 250, 123)">clear</span><span class="token plain"> Linkis table information </span><span class="token keyword" style="color:rgb(189, 147, 249);font-style:italic">in</span><span class="token plain"> the database?</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> </span><span class="token number">1</span><span class="token plain">: Do not execute table-building statements</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> </span><span class="token number">2</span><span class="token plain">: Dangerous</span><span class="token operator">!</span><span class="token plain"> Clear all data and rebuild the tables</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> other: </span><span class="token builtin class-name" style="color:rgb(189, 147, 249)">exit</span><span class="token plain"></span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"> |
| </span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain">Please input the choice: </span><span class="token comment" style="color:rgb(98, 114, 164)">## choice 1</span></span></code></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_M3SB clean-btn">Copy</button></div></div><h2><a aria-hidden="true" tabindex="-1" class="anchor anchor__h2 anchorWithStickyNavbar_y2LR" id="3-database-table-upgrade"></a>3. Database table upgrade<a class="hash-link" href="#3-database-table-upgrade" title="Direct link to heading">#</a></h2><blockquote><p>After the service installation is completed, the database structure needs to be modified, including table structure changes and table data changes</p></blockquote><p>Find the corresponding version <code>db/upgrade/x.x.x-schema/</code> sql change file</p><p>If it is executed across multiple versions, please execute them in the order of versions, |
| If some versions do not have x.x.x_schema (after the linkis>=1.1.0 version, as long as the adjustment of the database table is involved, there will be a corresponding version of the schema file), it means that there is no change in the data table in this version</p><div class="admonition admonition-caution alert alert--warning"><div class="admonition-heading"><h5><span class="admonition-icon"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16"><path fill-rule="evenodd" d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>notice</h5></div><div class="admonition-content"><p>Execute upgrade<em>1.1.1 under DDL upgrade script in schema, such as if it is executed to linkis</em> cg<em> rm</em> resource<em> action</em> Record related error, please check whether the statement creating the table is missing engine=innodb default charset=utf8; If it is missing, please add it before execution</p></div></div><div class="codeBlockContainer_J+bg"><div class="codeBlockContent_csEI shell"><pre tabindex="0" class="prism-code language-shell codeBlock_rtdJ thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_1zSZ"><span class="token-line" style="color:#F8F8F2"><span class="token plain">├── linkis_ddl.sql </span><span class="token comment" style="color:rgb(98, 114, 164)"># The current version of the full ddl database definition language table building statement</span><span class="token plain"></span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain">├── linkis_dml.sql </span><span class="token comment" style="color:rgb(98, 114, 164)"># The current version of the full dml data manipulation language data additions and changes</span><span class="token plain"></span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain">└── upgrade</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> ├── </span><span class="token number">1.1</span><span class="token plain">.0_schema </span><span class="token comment" style="color:rgb(98, 114, 164)"># The corresponding version of sql</span><span class="token plain"></span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> │ └── mysql</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> │ ├── linkis_ddl.sql</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> │ └── linkis_dml.sql</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> ├── </span><span class="token number">1.1</span><span class="token plain">.1_schema</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> │ └── mysql</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> │ ├── linkis_ddl.sql</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> │ └── linkis_dml.sql</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> └── </span><span class="token number">1.1</span><span class="token plain">.3_schema</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> └── mysql</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> └── linkis_ddl.sql</span></span></code></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_M3SB clean-btn">Copy</button></div></div><div class="codeBlockContainer_J+bg"><div class="codeBlockContent_csEI mysql-sql"><pre tabindex="0" class="prism-code language-mysql-sql codeBlock_rtdJ thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_1zSZ"><span class="token-line" style="color:#F8F8F2"><span class="token plain"> #If it is executed across multiple versions, please execute in order of versions, execute ddl first and then execute ddl</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> #For example, currently upgrade from linkis-1.0.3 to linkis-1.1.2</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> source upgrade/1.1.0_schema/mysql/linkis_ddl.sql</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> source upgrade/1.1.0_schema/mysql/linkis_dml.sql</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"> |
| </span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> source upgrade/1.1.1_schema/mysql/linkis_ddl.sql</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> source upgrade/1.1.1_schema/mysql/linkis_dml.sql</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"> |
| </span></span></code></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_M3SB clean-btn">Copy</button></div></div><h2><a aria-hidden="true" tabindex="-1" class="anchor anchor__h2 anchorWithStickyNavbar_y2LR" id="4-adjustment-of-data-optional"></a>4 Adjustment of data (optional)<a class="hash-link" href="#4-adjustment-of-data-optional" title="Direct link to heading">#</a></h2><blockquote><p>According to the actual situation, decide whether to make the following adjustments</p></blockquote><h3><a aria-hidden="true" tabindex="-1" class="anchor anchor__h3 anchorWithStickyNavbar_y2LR" id="41-token-configuration"></a>4.1 TOKEN configuration<a class="hash-link" href="#41-token-configuration" title="Direct link to heading">#</a></h3><p>Authentication for interface calls yes |
| 1.1.1 Version adjustment Migrate the original TOKEN configuration from <code>${LINKIS_HOME}/conf/token.properties</code> to the database table <code>linkis_mg_gateway_auth_token</code>, |
| For the TOKEN originally configured in <code>token.properties</code>, you need to manually migrate the table</p><h3><a aria-hidden="true" tabindex="-1" class="anchor anchor__h3 anchorWithStickyNavbar_y2LR" id="42-udf-adjustment"></a>4.2 UDF Adjustment<a class="hash-link" href="#42-udf-adjustment" title="Direct link to heading">#</a></h3><p>1.1.1 supports the functions of UDF multi-version control and UDF storage to BML, the table structure stored by UDF functions has been adjusted, and the historical data of UDF needs to be migrated separately</p><h3><a aria-hidden="true" tabindex="-1" class="anchor anchor__h3 anchorWithStickyNavbar_y2LR" id="43-session-field-key-configuration"></a>4.3 Session field key configuration<a class="hash-link" href="#43-session-field-key-configuration" title="Direct link to heading">#</a></h3><p>In version 1.1.1, the key of the session field was adjusted from <code>bdp-user-ticket-id</code>-> to <code>linkis_user_session_ticket_id_v1</code>, |
| If it is an upgrade to Linkis. At the same time, DSS or other projects are deployed, but in their service lib package, the linkis-module-x.x.x.jar package of Linkis that they depend on is <1.1.1, you need to modify the file located in <code>${LINKIS_HOME}/conf/linkis.properties</code></p><div class="codeBlockContainer_J+bg"><div class="codeBlockContent_csEI shell"><pre tabindex="0" class="prism-code language-shell codeBlock_rtdJ thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_1zSZ"><span class="token-line" style="color:#F8F8F2"><span class="token builtin class-name" style="color:rgb(189, 147, 249)">echo</span><span class="token plain"> </span><span class="token string" style="color:rgb(255, 121, 198)">"wds.linkis.session.ticket.key=bdp-user-ticket-id"</span><span class="token plain"> </span><span class="token operator">>></span><span class="token plain"> linkis.properties</span></span></code></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_M3SB clean-btn">Copy</button></div></div><h3><a aria-hidden="true" tabindex="-1" class="anchor anchor__h3 anchorWithStickyNavbar_y2LR" id="44-adjustment-of-default-queue"></a>4.4 Adjustment of default queue<a class="hash-link" href="#44-adjustment-of-default-queue" title="Direct link to heading">#</a></h3><p>1.1.1 Begin to adjust the default cluster name of yarn queue <code>wds.linkis.rm.cluster</code> sit is adjusted to default, if you have been using sit, please modify the table data |
| Cluster name in <code>linkis_cg_rm_external_resource_provider</code></p><h3><a aria-hidden="true" tabindex="-1" class="anchor anchor__h3 anchorWithStickyNavbar_y2LR" id="45-copies-of-other-related-packages"></a>4.5 Copies of other related packages<a class="hash-link" href="#45-copies-of-other-related-packages" title="Direct link to heading">#</a></h3><p>If there is a third-party appconn plugin installed in <code>${LINKIS_HOME_OLD}/lib/linkis-engineconn-plugins</code> in the previous version of Linkis, you need to copy it to the new version, |
| It is best to link to the appconn path through a soft chain |
| like:</p><div class="codeBlockContainer_J+bg"><div class="codeBlockContent_csEI"><pre tabindex="0" class="prism-code language-undefined codeBlock_rtdJ thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_1zSZ"><span class="token-line" style="color:#F8F8F2"><span class="token plain">#Check if the old version has a third-party appconn installed</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain">cd ${LINKIS_HOME_OLD}/lib/linkis-engineconn-plugins/</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain">ll</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> appconn -> /appcom/Install/LinkisInstall/appconn</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"> |
| </span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"> |
| </span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain">#The new version is consistent</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain">cd ${LINKIS_HOME}/lib/linkis-engineconn-plugins/</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain">#soft chain</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain">ln -snf /appcom/Install/LinkisInstall/appconn appconn</span></span></code></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_M3SB clean-btn">Copy</button></div></div><p>If dss is installed in the original version, you need to copy the <code>dss-gateway-support-x.x.x.jar</code> in the original package to the <code>./lib/linkis-spring-cloud-services/linkis-mg-gateway/</code> directory of linkis |
| like:</p><div class="codeBlockContainer_J+bg"><div class="codeBlockContent_csEI shell"><pre tabindex="0" class="prism-code language-shell codeBlock_rtdJ thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_1zSZ"><span class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">cp</span><span class="token plain"> </span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">${LINKIS_HOME_OLD}</span><span class="token plain">/lib/linkis-spring-cloud-services/linkis-mg-gateway/dss-gateway-support-1.1.3.jar </span><span class="token variable" style="color:rgb(189, 147, 249);font-style:italic">${LINKIS_HOME}</span><span class="token plain">/lib/linkis-spring-cloud-services/linkis- mg-gateway/dss-gateway-support-1.1.3.jar</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain" style="display:inline-block"> |
| </span></span></code></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_M3SB clean-btn">Copy</button></div></div><h2><a aria-hidden="true" tabindex="-1" class="anchor anchor__h2 anchorWithStickyNavbar_y2LR" id="5-updates-to-the-console"></a>5 Updates to the console<a class="hash-link" href="#5-updates-to-the-console" title="Direct link to heading">#</a></h2><blockquote><p>To upgrade the backend, you also need to upgrade the corresponding management console resources. You don't need to install the management console, just replace the static resources directly.</p></blockquote><h3><a aria-hidden="true" tabindex="-1" class="anchor anchor__h3 anchorWithStickyNavbar_y2LR" id="51-download-the-front-end-installation-package-and-unzip-it"></a>5.1 Download the front-end installation package and unzip it<a class="hash-link" href="#51-download-the-front-end-installation-package-and-unzip-it" title="Direct link to heading">#</a></h3><p>Upload it to the server where the management console is located, and decompress it</p><div class="codeBlockContainer_J+bg"><div class="codeBlockContent_csEI shell"><pre tabindex="0" class="prism-code language-shell codeBlock_rtdJ thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_1zSZ"><span class="token-line" style="color:#F8F8F2"><span class="token function" style="color:rgb(80, 250, 123)">tar</span><span class="token plain"> -xvf apache-linkis-x.x.x-incubating-web-bin.tar.gz</span></span></code></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_M3SB clean-btn">Copy</button></div></div><h3><a aria-hidden="true" tabindex="-1" class="anchor anchor__h3 anchorWithStickyNavbar_y2LR" id="52-upgrade"></a>5.2 Upgrade<a class="hash-link" href="#52-upgrade" title="Direct link to heading">#</a></h3><blockquote><p>There are many ways to upgrade the management console, because it is only the update of resources, which can be done through the installation script of the management console, or it can directly overwrite the original resources. |
| It is recommended to use the soft chain method, just modify the target address of the soft chain. The following takes the new version resource path method as an example</p></blockquote><p>The nginx configuration file is by default in <code>/etc/nginx/conf.d/*</code> |
| nginx log files are in <code>/var/log/nginx/access.log</code> and <code>/var/log/nginx/error.log</code></p><p>Scenario 1: If it is integrated into the DSS project, modify the address of the linkis management console resource in the DSS project to point to |
| The nginx configuration file for dss is by default in <code>/etc/nginx/conf.d/dss.conf</code></p><div class="codeBlockContainer_J+bg"><div class="codeBlockContent_csEI nginx"><pre tabindex="0" class="prism-code language-nginx codeBlock_rtdJ thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_1zSZ"><span class="token-line" style="color:#F8F8F2"><span class="token plain">#Example</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> server {</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> ......</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> location dss/linkis {</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> alias /appcom/Install/linkis-web-newversion/dist; # static file directory</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> index index.html index.html;</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> }</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> .....</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> }</span></span></code></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_M3SB clean-btn">Copy</button></div></div><p>Scenario 2: If linkis is deployed independently |
| Modify the configuration of Nginx, the static resource address points to the new version of the linkis console |
| Linkis' nginx configuration file is by default in <code>/etc/nginx/conf.d/dss.conf</code></p><div class="codeBlockContainer_J+bg"><div class="codeBlockContent_csEI nginx"><pre tabindex="0" class="prism-code language-nginx codeBlock_rtdJ thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_1zSZ"><span class="token-line" style="color:#F8F8F2"><span class="token plain">#Example</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> server {</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> ......</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> location dss/linkis {</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> alias /appcom/Install/linkis-web-newversion/dist; # static file directory</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> index index.html index.html;</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> }</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> ......</span></span><span class="token-line" style="color:#F8F8F2"><span class="token plain"> }</span></span></code></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_M3SB clean-btn">Copy</button></div></div><p>Reload nginx configuration</p><div class="codeBlockContainer_J+bg"><div class="codeBlockContent_csEI"><pre tabindex="0" class="prism-code language-undefined codeBlock_rtdJ thin-scrollbar" style="color:#F8F8F2;background-color:#282A36"><code class="codeBlockLines_1zSZ"><span class="token-line" style="color:#F8F8F2"><span class="token plain">sudo nginx -s reload</span></span></code></pre><button type="button" aria-label="Copy code to clipboard" class="copyButton_M3SB clean-btn">Copy</button></div></div><h3><a aria-hidden="true" tabindex="-1" class="anchor anchor__h3 anchorWithStickyNavbar_y2LR" id="53-notes"></a>5.3 Notes<a class="hash-link" href="#53-notes" title="Direct link to heading">#</a></h3><ul><li>After the management console is upgraded, because the browser may have a cache, if you want to verify the effect, it is best to clear the browser cache</li></ul></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/apache/incubator-linkis-website/edit/dev/versioned_docs/version-1.1.2/upgrade/upgrade_guide.md" target="_blank" rel="noreferrer noopener" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_mS5F" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_mt2f"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages navigation"><div class="pagination-nav__item"><a class="pagination-nav__link" href="/docs/latest/upgrade/upgrade_from_0.X_to_1.0_guide"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">« <!-- -->Upgrade From 0.X To 1.0 Guide</div></a></div><div class="pagination-nav__item pagination-nav__item--next"><a class="pagination-nav__link" href="/docs/latest/tuning_and_troubleshooting/overview"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Overview<!-- --> »</div></a></div></nav></div></div><div class="col col--3"><div class="tableOfContents_vrFS thin-scrollbar"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#1-upgrade-instructions" class="table-of-contents__link">1 Upgrade Instructions</a></li><li><a href="#2-service-upgrade-installation" class="table-of-contents__link">2 Service upgrade installation</a></li><li><a href="#3-database-table-upgrade" class="table-of-contents__link">3. Database table upgrade</a></li><li><a href="#4-adjustment-of-data-optional" class="table-of-contents__link">4 Adjustment of data (optional)</a><ul><li><a href="#41-token-configuration" class="table-of-contents__link">4.1 TOKEN configuration</a></li><li><a href="#42-udf-adjustment" class="table-of-contents__link">4.2 UDF Adjustment</a></li><li><a href="#43-session-field-key-configuration" class="table-of-contents__link">4.3 Session field key configuration</a></li><li><a href="#44-adjustment-of-default-queue" class="table-of-contents__link">4.4 Adjustment of default queue</a></li><li><a href="#45-copies-of-other-related-packages" class="table-of-contents__link">4.5 Copies of other related packages</a></li></ul></li><li><a href="#5-updates-to-the-console" class="table-of-contents__link">5 Updates to the console</a><ul><li><a href="#51-download-the-front-end-installation-package-and-unzip-it" class="table-of-contents__link">5.1 Download the front-end installation package and unzip it</a></li><li><a href="#52-upgrade" class="table-of-contents__link">5.2 Upgrade</a></li><li><a href="#53-notes" class="table-of-contents__link">5.3 Notes</a></li></ul></li></ul></div></div></div></div></main></div></div><footer class="footer"><div class="container"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Linkis</div><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/docs/latest/introduction">Document</a></li><li class="footer__item"><a class="footer__link-item" href="/faq/main">FAQ</a></li><li class="footer__item"><a href="https://github.com/apache/incubator-linkis/releases" target="_blank" rel="noopener noreferrer" class="footer__link-item"><span>Releases<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_wgqa"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></span></a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items"><li class="footer__item"><a href="https://github.com/apache/incubator-linkis" target="_blank" rel="noopener noreferrer" class="footer__link-item"><span>GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_wgqa"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></span></a></li><li class="footer__item"><a href="https://github.com/apache/incubator-linkis/issues" target="_blank" rel="noopener noreferrer" class="footer__link-item"><span>Issue Tracker<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_wgqa"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></span></a></li><li class="footer__item"><a href="https://github.com/apache/incubator-linkis/pulls" target="_blank" rel="noopener noreferrer" class="footer__link-item"><span>Pull Requests<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_wgqa"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></span></a></li></ul></div><div class="col footer__col"><div class="footer__title">Subscribe Mailing List</div><ul class="footer__items"><li class="footer__item"><a class="footer__link-item" href="/community/how-to-subscribe">How to Subscribe</a></li><li class="footer__item"><a href="mailto:dev-subscribe@linkis.apache.org" target="_blank" rel="noopener noreferrer" class="footer__link-item"><span>Subscribe Mail<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_wgqa"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></span></a></li><li class="footer__item"><a href="https://lists.apache.org/list.html?dev@linkis.apache.org" target="_blank" rel="noopener noreferrer" class="footer__link-item"><span>Mail Archive<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_wgqa"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></span></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright"><div><img style="height:50px" alt="Apache Software Foundation" src="/img/incubator-logo.svg"><p style="color: #999999; padding: 0 20px 30px;font-weight:400;text-align:left">Apache Linkis is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.</p><p></p> |
| <p style="padding: 0 20px 30px;color: #999999;font-weight: 400;"> Copyright © 2022 The Apache Software Foundation. Licensed under the Apache License, Version 2.0. Apache Linkis, Apache Incubator, Apache, the Apache feather logo, the Apache Linkis logo and the Apache Incubator project logo are trademarks of The Apache Software Foundation.</p> |
| <div></div></div></div></div></div></footer></div> |
| <script src="/assets/js/runtime~main.a4c60f50.js"></script> |
| <script src="/assets/js/main.42471b13.js"></script> |
| </body> |
| </html> |
