{"type":"doc","content":[{"type":"paragraph","content":[{"text":"This section lists the prerequisites and steps for applying and verifying this patch.","type":"text"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"3"}},"macroMetadata":{"macroId":{"value":"9ac23076-894c-4ee1-b19e-45c60b3b17dc"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Though every release of Adeptia comes with seamless upgrades and bug-free patches, for customer's complex use cases, we recommend applying the patch in a non-production environment first followed by testing. After the use cases run successfully without any errors or warnings, you can apply the patch in the production environment. ","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Prerequisites"}},"macroMetadata":{"macroId":{"value":"1d4bb5f4-9baa-4411-8748-ea9c0a74667a"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Prerequisites","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Read","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" ","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"and ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Write","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" permissions on all sub-folders and files of ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":".../AdeptiaConnect-","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":". ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Take backup of ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"apps.properties","type":"text","marks":[{"type":"strong"}]},{"text":" file from ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"…\\resources_config","type":"text","marks":[{"type":"strong"}]},{"text":" location. This backup file will help you replicate the manual changes that you may have done in this file in the past before applying this patch. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Take backup of ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"web.xml","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" file from ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"…\\conf","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" location. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"This backup file will help you replicate the manual changes that you may have done in this file in the past before applying this patch.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Take backup of ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"securityContext.xml","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" file from ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"ConnectPortal\\resources_config\\saml","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" location. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"This backup file will help you replicate the manual changes that you may have done in this file in the past before applying this patch.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connect Server services are running.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connect Portal service is stopped.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure that you have followed the ","type":"text"},{"text":"Prerequisites' instructions","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/AC36/pages/2494997#Upgrade-Prerequisites"}}]},{"text":" given on the Upgrade page.","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Applying the patch"}},"macroMetadata":{"macroId":{"value":"f5031bed-811d-427f-8d6b-e551a3de5090"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Applying the patch","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"},{"type":"hardBreak"}]},{"type":"expand","attrs":{"title":"For Windows"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Extract the Adeptia Connect zip file from the downloaded folder.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Command Prompt","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the folder where you have extracted the zip file.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the following command to apply the patch:","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"Apply-Patch.bat -portal “” ","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"For example:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"Apply-Patch.bat -portal \"C:/Program Files/AdeptiaConnect-x.x/ConnectPortal\"","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"Once the patch is applied, a confirmation message will be displayed. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"expand","attrs":{"title":"For Linux"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Terminal","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Extract the downloaded zip file in a directory.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the directory where you have extracted the zip file.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the following command to apply the patch:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"./Apply-Patch.sh -portal ","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"For example:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"./Apply-Patch.sh -portal /mnt/AdeptiaConnect-x.x/ConnectPortal","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"Once the patch is applied, a confirmation message will be displayed.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]}]},{"type":"paragraph","content":[{"text":"After applying this patch, refer to ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"post patch deployment section","type":"text","marks":[{"type":"link","attrs":{"href":"#ApplyingConnectPortalpatch-PostPatchDeploymentSteps"}},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" for manual changes.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Post Patch Deployment Steps"}},"macroMetadata":{"macroId":{"value":"2bb3be2e-f417-410c-ba93-03d2a84f670b"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Post patch deployment steps","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"In this release, some manual changes are required in Connect Portal.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Changes in apps.properties file","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"…\\resources_config","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"location.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"apps.properties ","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"fil","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"e","type":"text"},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Below the ","type":"text"},{"text":"Facebook","type":"text","marks":[{"type":"strong"}]},{"text":" section in the file, add the following code block for Microsoft Azure.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"css"},"content":[{"text":"microsoftazure.appKey=\nmicrosoftazure.appKeySecret=\nmicrosoftazure.oauthVersion=2.0\nmicrosoftazure.oauth20.refreshToken=https://login.microsoftonline.com/{domain}/oauth2/v2.0/token\nmicrosoftazure.oauth20.authorize=https://login.microsoftonline.com/{domain}/oauth2/v2.0/authorize\nmicrosoftazure.oauth20.accessToken=https://login.microsoftonline.com/{domain}/oauth2/v2.0/token\nmicrosoftazure.SecretId=\nmicrosoftazure.scope=openid offline_access https://storage.azure.com/user_impersonation\nmicrosoftazure.enableProduction=true","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save the file.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Restart the Connect Portal.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Changes in Web.xml file","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the location ","type":"text"},{"text":"…\\conf.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the web.xml file in a text editor.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"filter","type":"text","marks":[{"type":"strong"}]},{"text":" section, add the following code snippet just after the ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"tag that follows ","type":"text"},{"text":"SAMEORIGIN","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"css"},"content":[{"text":"\nhstsMaxAgeSeconds\n31536000\n\n\nhstsIncludeSubDomains\ntrue\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save the file.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Changes in securityContext.xml","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"ConnectPortal\\resources_config\\saml","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}},{"type":"strong"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"location.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"securityContext.xml","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" file.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"xsi:schemaLocation","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" attribute as shown in the following code snippet. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"codeBlock","attrs":{"language":"css"},"content":[{"text":"xsi:schemaLocation=\"http://www.springframework.org/schema/beans classpath:org/springframework/beans/factory/xml/spring-beans.xsd\nhttp://www.springframework.org/schema/security classpath:org/springframework/security/config/spring-security-5.6.xsd \nhttp://www.springframework.org/schema/context classpath:org/springframework/context/config/spring-context.xsd\">","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save the file.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"Verifying Connect Portal patch"}},"macroMetadata":{"macroId":{"value":"7367244a-3b0c-4c3e-b468-9bc6b3dda2d9"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Verifying Connect Portal patch","type":"text"}]},{"type":"paragraph","content":[{"text":"To verify if the Connect Portal has been deployed successfully, login to the portal and check the build tag of the Connect Portal.","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow the steps below to check the build tag:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Help","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"About","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the ","type":"text"},{"text":"About","type":"text","marks":[{"type":"strong"}]},{"text":" screen, check the ","type":"text"},{"text":"Connect Portal","type":"text","marks":[{"type":"strong"}]},{"text":" tag. ","type":"text"},{"type":"hardBreak"},{"text":"If the build tag matches the tag of the Connect Portal, it indicates that the Connect Portal patch is deployed successfully.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Additionally, to verify if the user interface of the Connect Server is working as expected, follow the steps below:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Configure > Developer Studio > Proceed","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"},{"text":"If you are able to interact with the Connect Server interface, it indicates that the Connect Server is updated.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported