{"type":"doc","content":[{"type":"paragraph","content":[{"text":"To update any CSN implementation, download and use the CSN 8.3 bundle from the ","type":"text"},{"text":"Downloads section","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://datacore.custhelp.com/app/downloads/downloads"}}]},{"text":" on the ","type":"text"},{"text":"DataCore Support Portal","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://datacore.custhelp.com/"}}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note","type":"text"}]},{"type":"paragraph","content":[{"text":"Any components running separately from the CSN host, such as Content Gateway and Elasticsearch, are not updated by the CSN install script and must be upgraded separately, using the RPMs in the CSN bundle.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"How you upgrade depends on the versions you are starting from","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"4c516640-36b4-4133-ada0-e1e7b70b37b9"}}]},{"text":" and whether you run the Swarm UI locally on the CSN (because you have no Content Gateway available to host it):","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"drawio","parameters":{"macroParams":{"simple":{"value":"0"},"zoom":{"value":"1"},"inComment":{"value":"0"},"custContentId":{"value":"1068925107"},"pageId":{"value":"452952201"},"diagramDisplayName":{"value":"CSN-upgrades.drawio"},"lbox":{"value":"1"},"contentVer":{"value":"3"},"revision":{"value":"3"},"baseUrl":{"value":"https://caringo.atlassian.net/wiki"},"diagramName":{"value":"CSN-upgrades.drawio"},"pCenter":{"value":"0"},"aspect":{"value":"undefined"},"width":{"value":"762"},"links":{"value":""},"tbstyle":{"value":""},"height":{"value":"616"}},"macroMetadata":{"macroId":{"value":"070d2bfe-497f-41d4-bad6-83006c0cc8a0"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"https://ac.draw.io/connectImage?simple=0&zoom=1&inComment=0&custContentId=1068925107&pageId=452952201&diagramDisplayName=CSN-upgrades.drawio&lbox=1&contentVer=3&revision=3&baseUrl=https%3A%2F%2Fcaringo.atlassian.net%2Fwiki&diagramName=CSN-upgrades.drawio&pCenter=0&aspect=undefined&width=762&links=&tbstyle=&height=616"}}],"title":"draw.io Diagram"}},"localId":"28734492-4673-43a1-9ddb-39741cc3ad6e"}},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"52402762-4bb1-4010-a6ef-683a61df3c23"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"404aea2d-80f3-4fc6-956e-fc6fa231b856"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Upgrading Swarm Storage Only","type":"text"}]},{"type":"paragraph","content":[{"text":"To update the version of Swarm Storage software being used in the storage cluster, do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the latest CSN bundle from the ","type":"text"},{"text":"Downloads section","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://datacore.custhelp.com/app/downloads/downloads"}}]},{"text":" on the ","type":"text"},{"text":"DataCore Support Portal","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://datacore.custhelp.com/"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expand the bundle on your CSN server.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":40.0},"content":[{"type":"media","attrs":{"width":336,"id":"41034f4b-cc9d-42ea-8a21-ac7a8f12977a","collection":"contentId-2443812915","type":"file","height":303}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install the new Storage (castor) RPM using the following command from a standard RHEL/CentOS terminal window:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"yum install [new Swarm version RPM]\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After the install, open the CSN Console. A new Swarm software version will appear on the ","type":"text"},{"text":"Cluster Services > Netboot Management","type":"text","marks":[{"type":"strong"}]},{"text":" page.","type":"text"},{"type":"hardBreak"},{"text":"See ","type":"text"},{"text":"Console - Cluster Services","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/KB/pages/2443813025"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To switch to an alternate Swarm software version, select the desired version and click ","type":"text"},{"text":"Update","type":"text","marks":[{"type":"strong"}]},{"text":". This will change the software image used to network boot all Swarm nodes. ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"Note

Suspending volume recoveries from the Swarm Admin Console is not necessary. Swarm will automatically enter into maintenance mode after an admin initiated reboot. Administrators may wish to delete older versions of Swarm software that are no longer needed to reduce the size of configuration backups.

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note","type":"text"}]},{"type":"paragraph","content":[{"text":"Suspending volume recoveries from the Swarm Admin Console is not necessary. Swarm will automatically enter into maintenance mode after an admin initiated reboot. Administrators may wish to delete older versions of Swarm software that are no longer needed to reduce the size of configuration backups.","type":"text"}]}]}],"version":1},"reason":"An info macro in a list item can't be created or edited in the new editor."}}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Reboot the Swarm cluster so that it can pick up the new version. You may reboot the Swarm cluster all at once or rebooting one node at a time from the Admin Console to pick up the new version.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Upgrading Storage and local Swarm UI (with script)","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"1ec3030d-fd24-48f9-a809-ae3dcae0db1b"}}]}]},{"type":"paragraph","content":[{"text":"Important:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"The CSN bundle install","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"8f827b04-534d-4d36-ac1b-1dc39f25fd6e"}}]},{"text":" script installs all of the RPMs involved in running the Swarm UI ","type":"text"},{"text":"on the CSN itself","type":"text","marks":[{"type":"em"}]},{"text":". Do ","type":"text"},{"text":"not","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"bf2d6bd1-63f5-464f-81f9-af66842fba48"}}]},{"text":" install it on the CSN if you have a Content Gateway elsewhere to host it. To verify whether you already have Swarm UI on your CSN, log into it using this URL:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"http://{CSN-IP}:91/_admin/storage","type":"text"}]},{"type":"paragraph","content":[{"text":"For this configuration, you can update Swarm Storage and the components needed to run Swarm UI on the CSN by doing the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To identify configuration issues for the upgrade, download and run the latest ","type":"text"},{"text":"Storage Settings Checker","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/public/pages/2443809416"}}]},{"text":", which is bundled with the Swarm Support tools. With help from Support, address any setting issues (such as deprecations and new requirements) that the report surfaces.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you have ever customized the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"/etc/caringo/netboot/netboot.cfg","type":"text","marks":[{"type":"code"}]},{"text":" file (such as for \"gateway\" or \"kernelOptions\"), make a record of your non-default parameters.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the latest CSN bundle from the ","type":"text"},{"text":"Downloads section","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://datacore.custhelp.com/app/downloads/downloads"}}]},{"text":" on the ","type":"text"},{"text":"DataCore Support Portal","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://datacore.custhelp.com/"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expand the bundle on your CSN server.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":40.0},"content":[{"type":"media","attrs":{"width":336,"id":"749bc5cb-3960-47dc-a862-6b4564560928","collection":"contentId-2443812915","type":"file","height":303}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remove the yum lock before running the script:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"yum remove yum-plugin-versionlock","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run the CSN's install script from a terminal console, or run using SSH by adding the --viassh flag:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"./caringo-csn-bundle-install.sh --viassh","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"install script ensures that the Swarm ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"cluster.cfg","type":"text","marks":[{"type":"code"}]},{"text":" is current with Swarm 9, but the script may reverse some changes required for Swarm 11. Be sure to verify the following ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"before","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}},{"type":"em"}]},{"text":" rebooting the nodes","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":":","type":"text"},{"type":"hardBreak"},{"text":"In the ","type":"text"},{"text":"cluster.cfg","type":"text","marks":[{"type":"code"}]},{"text":", modify the security and SNMP users to make them Swarm 10+ compatible. See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://perifery.atlassian.net/wiki/spaces/public/pages/2443811291"}},{"text":".","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remove the “","type":"text"},{"text":"snmp","type":"text","marks":[{"type":"code"}]},{"text":"” user from the administrators line","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remove ","type":"text"},{"text":"security.operators","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add ","type":"text"},{"text":"snmp.rwCommunity","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"snmp.roCommunity","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify that any customizations you needed for ","type":"text"},{"text":"/etc/caringo/netboot/netboot.cfg","type":"text","marks":[{"type":"code"}]},{"text":" (such as for \"gateway\" or \"kernelOptions\") are ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"present","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"8bfcc43d-d105-4067-b379-3d105e8d3e1b"}},{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The install script restores the defaults in ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"/etc/rsyslog.conf","type":"text","marks":[{"type":"code"}]},{"text":" for where log files are stored. If you had changed the log location, reapply your changes after running the script.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From the ","type":"text"},{"text":"Netboot","type":"text","marks":[{"type":"strong"}]},{"text":" page of the CSN Console, select the new Swarm version.","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"Important

This step is essential because the Swarm configuration values in the CSN may only be compatible with the newer Swarm software included in the CSN ZIP installation. Older Swarm versions may not boot with newer configuration parameters that are not recognized.

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Important","type":"text"}]},{"type":"paragraph","content":[{"text":"This step is essential because the Swarm configuration values in the CSN may only be compatible with the newer Swarm software included in the CSN ZIP installation. Older Swarm versions may not boot with newer configuration parameters that are not recognized.","type":"text"}]}]}],"version":1},"reason":"An info macro in a list item can't be created or edited in the new editor."}}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From the Swarm UI or legacy Admin Console, reboot the whole cluster at once or do a ","type":"text"},{"text":"rolling","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"5c1e8d7c-f10d-4dbe-811b-11f20a2f2510"}}]},{"text":" reboot. As directed by Support, you can use the Support Tools bundle script ","type":"text"},{"text":"swarmrestart","type":"text","marks":[{"type":"code"}]},{"text":" to perform a rolling reboot.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Upgrading","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2cc22058-7bcd-4fde-b4bb-261183208e2e"}}]},{"text":" CSN 8 (with script)","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are already running a CSN 8.3.x version, do not upgrade unless you are running Swarm UI on the CSN. The only changes to CSN 8.3 relate to the version of Swarm UI that the ","type":"text"},{"text":"/usr/bin/configure_storage_webui_with_serviceproxy.py","type":"text","marks":[{"type":"code"}]},{"text":" script sets up locally. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The CSN supports upgrade from one software version to the next via a script process similar to initial installation. The CSN will not be functional during the upgrade and will require a reboot after the software is updated. Schedule the upgrade during off peak hours to ensure Swarm activities are not disrupted.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"CSN Migrations","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are running CSN 2 or 3, contact Support for help with your migration to the current version of CSN 8.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Backups","type":"text"}]},{"type":"paragraph","content":[{"text":"During upgrade, the backup process will not be able to complete and so may log errors. After upgrade, previous backup sets may be marked on the ","type":"text"},{"text":"Backup and Restore","type":"text","marks":[{"type":"strong"}]},{"text":" page of the CSN Admin Console as being only compatible with a previous software version. These backups cannot be restored with the current version but will remain available if the software is reverted to a previous version. See ","type":"text"},{"text":"CSN Reset","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/KB/pages/2443812983"}}]},{"text":" for instructions on how to install different versions of the CSN using the csn-reset functionality.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"You may upgrade CSN version 3.x or later:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Prepare OS","type":"text","marks":[{"type":"strong"}]},{"text":" - If you previously performed an OS version lock as required by older versions of CSN, remove the OS version lock using the following command:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"applescript"},"content":[{"text":"yum -y remove yum-plugin-versionlock","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are unsure if your OS was previously version locked, run the unlock command.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upgrade OS","type":"text","marks":[{"type":"strong"}]},{"text":" - If the CSN's operating system is not running RHEL/CentOS 6 release 6.8+, you must upgrade the OS.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Similar to the initial installation, a yum repository must be configured and available for upgrade to proceed. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Either a media repository or an internet repository are acceptable. If you are installing from an internet repository, you may need to explicitly define the minor revision to which you want to upgrade. For example, from the Red Hat Network, you can select to receive Limited Updates Only and then chose the operating system version to be installed. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Depending on how long it has been since the server was last upgraded, the OS upgrade may take an hour or more. ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Upgrade CSN","type":"text","marks":[{"type":"strong"}]},{"text":" - Upgrade the CSN software using the same install script and steps referenced in \"Upgrading with the CSN bundle install script\", with these notes: ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"Important

Before the CSN upgrade, if you have ever customized the /etc/caringo/netboot/netboot.cfg file (such as for "gateway" or "kernelOptions"), make a record of your non-default parameters.

After the CSN upgrade, verify that these custom parameters were preserved; if not, update the config file and restart netboot: service netboot restart

This step is essential because the Swarm configuration values in the CSN may only be compatible with the newer Swarm software that is included in the CSN ZIP installation. Older Swarm versions may not boot with newer configuration parameters that are not recognized.

Browser not supported