1"use strict";(self.webpackChunkspectro_cloud_docs=self.webpackChunkspectro_cloud_docs||[]).push([["12157"],{399784:function(e,t,n){n.r(t),n.d(t,{frontMatter:()=>a,toc:()=>d,default:()=>u,metadata:()=>r,assets:()=>o,contentTitle:()=>l});var r=JSON.parse('{"id":"enterprise-version/upgrade/upgrade-notes","title":"Upgrade Notes","description":"Learn how to upgrade self-hosted Palette instances.","source":"@site/docs/docs-content/enterprise-version/upgrade/upgrade-notes.md","sourceDirName":"enterprise-version/upgrade","slug":"/enterprise-version/upgrade/upgrade-notes","permalink":"/enterprise-version/upgrade/upgrade-notes","draft":false,"unlisted":false,"editUrl":"https://github.com/spectrocloud/librarium/blob/master/docs/docs-content/enterprise-version/upgrade/upgrade-notes.md","tags":[{"inline":true,"label":"palette","permalink":"/tags/palette"},{"inline":true,"label":"self-hosted","permalink":"/tags/self-hosted"},{"inline":true,"label":"airgap","permalink":"/tags/airgap"},{"inline":true,"label":"kubernetes","permalink":"/tags/kubernetes"},{"inline":true,"label":"upgrade","permalink":"/tags/upgrade"}],"version":"current","lastUpdatedAt":1777826507000,"sidebarPosition":0,"frontMatter":{"sidebar_label":"Upgrade Notes","title":"Upgrade Notes","description":"Learn how to upgrade self-hosted Palette instances.","icon":"","sidebar_position":0,"tags":["palette","self-hosted","airgap","kubernetes","upgrade"],"keywords":["self-hosted","enterprise","airgap","kubernetes"]},"sidebar":"docSidebar","previous":{"title":"Upgrade","permalink":"/enterprise-version/upgrade/"},"next":{"title":"Non-airgap","permalink":"/enterprise-version/upgrade/upgrade-vmware/non-airgap"}}'),s=n(474848),i=n(884429);let a={sidebar_label:"Upgrade Notes",title:"Upgrade Notes",description:"Learn how to upgrade self-hosted Palette instances.",icon:"",sidebar_position:0,tags:["palette","self-hosted","airgap","kubernetes","upgrade"],keywords:["self-hosted","enterprise","airgap","kubernetes"]},l,o={},d=[{value:"Palette 3.4",id:"palette-34",level:2},{value:"Upgrade Palette 3.x to 4.0",id:"upgrade-palette-3x-to-40",level:2},{value:"Upgrade with VMware",id:"upgrade-with-vmware",level:3},{value:"Upgrade Enterprise Cluster Profile",id:"upgrade-enterprise-cluster-profile",level:3}];function c(e){let t={a:"a",admonition:"admonition",code:"code",em:"em",h2:"h2",h3:"h3",img:"img",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,i.R)(),...e.components};return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(t.p,{children:"This page offers version-specific reference to help you prepare for upgrading self-hosted Palette instances."}),"\n",(0,s.jsx)(t.h2,{id:"palette-34",children:"Palette 3.4"}),"\n",(0,s.jsx)(t.p,{children:"Prior versions of Palette installed internal Palette component ingress resources in the default namespace. The new\nversion of the Helm Chart ensures all Palette required ingress resources are installed in the correct namespace.\nSelf-hosted Palette instances deployed to Kubernetes and upgrading from Palette versions 3.3.X or older must complete\nthe following action."}),"\n",(0,s.jsxs)(t.ol,{children:["\n",(0,s.jsxs)(t.li,{children:["\n",(0,s.jsx)(t.p,{children:"Connect to the cluster using the cluster's kubeconfig file."}),"\n"]}),"\n",(0,s.jsxs)(t.li,{children:["\n",(0,s.jsxs)(t.p,{children:["Identify all Ingress resources that belong to ",(0,s.jsx)(t.em,{children:"Hubble"})," - an internal Palette component."]}),"\n",(0,s.jsx)(t.pre,{children:(0,s.jsx)(t.code,{className:"language-shell",children:"kubectl get ingress --namespace default\n"})}),"\n"]}),"\n",(0,s.jsxs)(t.li,{children:["\n",(0,s.jsxs)(t.p,{children:["Remove each Ingress resource listed in the output that starts with the name Hubble. Use the following command to\ndelete an Ingress resource. Replace ",(0,s.jsx)(t.code,{children:"REPLACE_ME"})," with the name of the Ingress resource you are removing."]}),"\n",(0,s.jsx)(t.pre,{children:(0,s.jsx)(t.code,{className:"language-shell",children:"kubectl delete ingress --namespace default <REPLACE_ME>\n"})}),"\n"]}),"\n"]}),"\n",(0,s.jsx)(t.h2,{id:"upgrade-palette-3x-to-40",children:"Upgrade Palette 3.x to 4.0"}),"\n",(0,s.jsx)(t.p,{children:"Palette 4.0 includes the following major enhancements that require user intervention to facilitate the upgrade process."}),"\n",(0,s.jsxs)(t.ul,{children:["\n",(0,s.jsxs)(t.li,{children:["\n",(0,s.jsxs)(t.p,{children:[(0,s.jsx)(t.strong,{children:"Enhanced security for Palette microservices"})," - To enhance security, all microservices within Palette now use\n",(0,s.jsx)(t.code,{children:"insecure-skip-tls-verify"})," set to ",(0,s.jsx)(t.code,{children:"false"}),". When upgrading to Palette 4.0, you must provide a valid SSL certificate in\nthe system console."]}),"\n",(0,s.jsxs)(t.p,{children:["If you already have an SSL certificate, key, and Certificate Authority (CA) certificate, you can use them when\nupgrading to Palette 4.0.0. To learn how to upload SSL certificates to Palette, refer to\n",(0,s.jsx)(t.a,{href:"/enterprise-version/system-management/ssl-certificate-management",children:"SSL Certificate Management"}),"."]}),"\n"]}),"\n",(0,s.jsxs)(t.li,{children:["\n",(0,s.jsxs)(t.p,{children:[(0,s.jsx)(t.strong,{children:"Self-hosted Palette Kubernetes Upgrade"})," - If you installed Palette using the Helm Chart method, the Kubernetes\nversion used for Palette is upgraded from version 1.24 to 1.25. You will need to copy the new Kubernetes YAML to the\nKubernetes layer in the Enterprise cluster profile. If you have customized your Kubernetes configuration, you will\nneed to manually adjust custom values and include any additional configuration in the upgraded YAML that we provide.\nRefer to ",(0,s.jsx)(t.a,{href:"#upgrade-enterprise-cluster-profile",children:"Upgrade Enterprise Cluster Profile"}),"."]}),"\n"]}),"\n"]}),"\n",(0,s.jsx)(t.h3,{id:"upgrade-with-vmware",children:"Upgrade with VMware"}),"\n",(0,s.jsx)(t.admonition,{type:"warning",children:(0,s.jsxs)(t.p,{children:["A known issue impacts all self-hosted Palette instances older then 4.4.14. Before upgrading a Palette instance with\nversion older than 4.4.14, ensure that you execute a utility script to make all your cluster IDs unique in y
1our\nPersistent Volume Claim (PVC) metadata. For more information, refer to the\n",(0,s.jsx)(t.a,{href:"/troubleshooting/enterprise-install#scenario---non-unique-vsphere-cns-mapping",children:"Troubleshooting Guide"}),"."]})}),"\n",(0,s.jsxs)(t.p,{children:["From the Palette system console, click the ",(0,s.jsx)(t.strong,{children:"Update version"})," button. Palette will be temporarily unavailable while\nsystem services update."]}),"\n",(0,s.jsx)(t.p,{children:(0,s.jsx)(t.img,{alt:"Screenshot of the "Update version" button in the system consoles.",src:n(770618).A+"",width:"1586",height:"915"})}),"\n",(0,s.jsx)(t.h3,{id:"upgrade-enterprise-cluster-profile",children:"Upgrade Enterprise Cluster Profile"}),"\n",(0,s.jsx)(t.p,{children:"Follow the steps below to upgrade Kubernetes."}),"\n",(0,s.jsxs)(t.ol,{children:["\n",(0,s.jsxs)(t.li,{children:["\n",(0,s.jsx)(t.p,{children:"Log in to the Palette system console."}),"\n"]}),"\n",(0,s.jsxs)(t.li,{children:["\n",(0,s.jsxs)(t.p,{children:["From the left ",(0,s.jsx)(t.strong,{children:"Main Menu"}),", click ",(0,s.jsx)(t.strong,{children:"Enterprise Cluster Migration"}),"."]}),"\n"]}),"\n",(0,s.jsxs)(t.li,{children:["\n",(0,s.jsxs)(t.p,{children:["Click on the ",(0,s.jsx)(t.strong,{children:"Profiles"})," tab, and select the Kubernetes layer. The Kubernetes YAML is displayed in the editor at\nright."]}),"\n"]}),"\n",(0,s.jsxs)(t.li,{children:["\n",(0,s.jsx)(t.p,{children:"If the existing Kubernetes YAML has been customized or includes additional configuration, we suggest you create a\nbackup of it by copying it to another location."}),"\n"]}),"\n",(0,s.jsxs)(t.li,{children:["\n",(0,s.jsx)(t.p,{children:"Copy the Kubernetes YAML you received from our support team and paste it into the editor."}),"\n",(0,s.jsx)(t.p,{children:(0,s.jsx)(t.img,{alt:"Screenshot of the Kubernetes YAML editor.",src:n(270042).A+"",width:"1956",height:"1142"})}),"\n"]}),"\n",(0,s.jsxs)(t.li,{children:["\n",(0,s.jsx)(t.p,{children:"If you have made any additional configuration changes or additions, add your customizations to the new YAML."}),"\n"]}),"\n",(0,s.jsxs)(t.li,{children:["\n",(0,s.jsx)(t.p,{children:"Save your changes."}),"\n"]}),"\n"]}),"\n",(0,s.jsx)(t.p,{children:"The Enterprise cluster initiates the Kubernetes upgrade process and leads to the reconciliation of all three nodes."})]})}function u(e={}){let{wrapper:t}={...(0,i.R)(),...e.components};return t?(0,s.jsx)(t,{...e,children:(0,s.jsx)(c,{...e})}):c(e)}},770618:function(e,t,n){n.d(t,{A:()=>r});let r=n.p+"assets/images/enterprise-version_sys-console-update-palette-version-4035a53983f21bcc7d2ab6d968dc0814.webp"},270042:function(e,t,n){n.d(t,{A:()=>r});let r=n.p+"assets/images/enterprise-version_upgrade_ec-cluster-profile-16e6f8fd6f92f7fa6ed2ce7ca8f8bf70.webp"},884429:function(e,t,n){n.d(t,{R:()=>a,x:()=>l});var r=n(296540);let s={},i=r.createContext(s);function a(e){let t=r.useContext(i);return r.useMemo(function(){return"function"==typeof e?e(t):{...t,...e}},[t,e])}function l(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:a(e.components),r.createElement(i.Provider,{value:t},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.