CdmPlatformReleaseSteps » History » Revision 32
Revision 31 (Andreas Müller, 02/16/2022 11:13 AM) → Revision 32/105 (Andreas Müller, 02/17/2022 01:38 PM)
# CDM Platform release process step by step **see also** * https://github.com/cybertaxonomy/cdm-dataportal ### 0.1) Check that the cdm-server and the data portal build fine * run the [cdm-server-INTEGRATION](http://dev.e-taxonomy.eu/jenkins/job/cdm-server-INTEGRATION/) job * run the [drupal7-cdm_dataportal-SNAPSHOT](http://dev.e-taxonomy.eu/jenkins/job/drupal7-cdm_dataportal-SNAPSHOT/) job ### 1) run the release pipeline in jenkins * run the [cdmlib-RELEASE](http://int.e-taxonomy.eu/jenkins/job/cdmlib-RELEASE/) job * run the [cdm_dataportal-RELEASE](http://int.e-taxonomy.eu/jenkins/job/cdm_dataportal-RELEASE/) job ### 2) update the Cdm Platform Roadmap update http://dev.e-taxonomy.eu/trac/wiki/CdmPlatformRoadmap and add a summary in the _What's new?_ section ### 4) edit milestones 1. create the milestones for the next release 1. close the milestones of the current release and tell track to move all open tickets to the next milestone ### 5) write an email to the _cdm_clients ~~~ Subject: EDIT Platform <NEW-VERSION> released ~~~ ~~~ Dear EDIT Platform users, the next version of the EDIT Platform with the version number <NEW-VERSION> has been released. [OPTIONAL A]The release of the Taxonomic Editor will be done in a few days, meanwhile you can of course continue working with Taxonomic Editor <OLD-VERSION>. [OPTIONAL B]This time we abstain from also releasing a new version of the Taxonomic Editor. You can of course continue working with Taxonomic Editor <OLD-VERSION>. For an overview on the changes in this release please refer to the following page: http://dev.e-taxonomy.eu/trac/wiki/CdmPlatformRoadmap For [tomorrow|this evening] we are planning to install this new version of the EDIT Platform on our servers. During the necessary server maintenance you might experience some minor downtimes of some of the platform components. Best wishes <YOUR-NAME> ~~~ ### 6) Perform the deployment of the Taxonomic Editor Deploy the taxeditor by running the Jenkins job : [taxeditor-PROVISION](http://int.e-taxonomy.eu/jenkins/view/EDIT%20Taxonomic%20Editor/job/taxeditor-PROVISION/) ### 7) deploy the release **edit production** server ([BDI-Wiki:/EDITServerSetup/edit-production](https://wiki.bgbm.org/bdinotes/index.php/EDITServerSetup/edit-production)) dataportals-drush vset -y maintenance_mode 1 => Maintenance mode /opt/server-scripts/jenkins-ci/cdm-server/cdmserver-install.sh {release-version} /tmp/ => tmp is the folder the release is downloaded to, danach warten bis Server neu gestartet ist # wait some minutes until the prompt returns .... cd /var/www/drupal-7-cdm-dataportal git checkout master git pull ./scripts/admin/fix-permissions.sh --web-user www-data => Set file rights dataportals-drush --yes updatedb => migrations script für Module (z.B. wenn sich Settings ändern) dataportals-drush cc all => clear all caches dataportals-drush vset -y maintenance_mode 0 maybe you want to install drupal updates as well: https://github.com/cybertaxonomy/cdm-dataportal#update---method-2 **edit demo servers 1 & 2 ([BDI-Wiki:/EDITServerSetup/edit-production](https://wiki.bgbm.org/bdinotes/index.php/EDITServerSetup/edit-demo))** On each of the servers: vi /opt/server-scripts/workshop-setup/conf.d/instances.conf and change the variables CDM_SERVER_VERSION and CDM_DATAPORTAL_GIT_TREEISH: # CDM Server version CDM_SERVER_VERSION=5.7.0 # reference to a branch or tag in the cdm-dataportal git repo # e.g.: tags/1.0, hotfix/1.0.1 CDM_DATAPORTAL_GIT_TREEISH=tags/5.7.0 Save the changes. The setup will be refreshed automatically over night. If you need to install the server in the newly configured release version, you can run the setup script. It is recommended to run the setup scriupts in a `screen` session: screen -R # reattach or new session No inside the session, either do a full setup (recommended), since we are using `screen` you can close the teminal even if the setup is running. Closing the terminal or dropping the ssh connection will not cause the running script to be stopped. ./full-setup or just update the cdm-server ../jenkins-ci/cdm-server/cdmserver-install.sh $CDM_SERVER_VERSION /tmp **phycobank** The phycobank server is not necessarily following every release, therefore **THIS STEP MUST ONLY BE DONE AFTER CONFIRMATION BY THE PHYCOBANK TEAM**. ~~~ cd /opt/cdmserver-docker/phycobank vi docker-compose.yml # set the release version docker-compose down docker-compose up -d ~~~ re-index if needed (see also [[CdmSearchIndexMaintenance]]): ~~~ http http://api.phycobank.org/phycobank/manage/reindex --auth '{USR}:{PWD}' ~~~ update the dataportal ~~~ cd /var/www/drupal-7-cdm-dataportal/web/sites/_dataportal-phycobank git fetch git checkout {release_version} drush -r /var/www/drupal-7-cdm-dataportal/web/ -l https://phycobank.org/ updatedb drush -r /var/www/drupal-7-cdm-dataportal/web/ -l https://phycobank.org/ cc all ~~~ **mexico** drush vset -y maintenance_mode 1 /opt/server-scripts/jenkins-ci/cdm-server/cdmserver-install.sh {release-version} /tmp/ => tmp is the folder the release is downloaded to, danach warten bis Server neu gestartet ist # wait some minutes until the prompt returns .... cd /var/www/drupal-7-cdm-dataportal git checkout master git pull ./scripts/admin/fix-permissions.sh --web-user www-data => Set file rights dataportals-drush --yes updatedb => migrations script für Module (z.B. wenn sich Settings ändern) dataportals-drush cc all => clear all caches dataportals-drush vset -y maintenance_mode 0 maybe you want to install drupal updates as well: https://github.com/cybertaxonomy/cdm-dataportal#update---method-2 ### 8) check for post-release tickets ### 9) perform the Taxonomic Editor Deployment as described at [[TaxonomicEditorDeployment]] ### 10) send mail to users to inform of successful release