Release Process

From Ham Radio Deluxe Wiki
Jump to: navigation, search

Ham Radio Deluxe Software Release Process

For HRD Software, LLC internal use only. This describes the work necessary to publish (ship) a release.

Dropbox

It is first necessary to create a direct download link for the new version of Ham Radio Deluxe.

(We'll use the file setupHRD64_777.exe as the example.)

Steps:

For example, the direct download link will look something like this example:
https://www.dropbox.com/s/hfk33ftz0pjz0bz/setupHRD64_777.exe?dl=0
  • Done

Update file for download

The download file needs to be updated in order for customers to download the latest version.

These steps require admin and root access to the Google Cloud environment.

Steps:

  • Go to https://console.cloud.google.com and login to the "HRD Web Server Project"
  • Start an SSH telnet connection
  • Type the command "su - root" and provide the password to the root account (logs in as root)
  • Type the command "sudo su -s /bin/bash apache" (this changes the login context to the Apache account; DO NOT make the rest of these changes as root)
  • Type the command "cd /www/joomla/files" (this places you in the directory where the downloadable files are kept)
  • Type the command "wget https://www.dropbox.com/s/hfk33ftz0pjz0bz/setupHRD64_777.exe" (NOTE: Remove "?dl=0" from the end of the direct download link. This downloads the file from Dropbox.)
  • Type the command "cp setupHRD64_777.exe setup.exe" (this copies and overwrites the former version with the new version and leaves the former version there for future reference)
  • Type the command "exit" (this logs out of the Apache account)
  • Type the command "exit" (this logs out of the root account and closes the telnet session)
  • Done

Add version in Mantis and assign dev objects to release version

The release version must be available in Mantis and dev objects (issues) assigned to the project in order for these items to show up in the Release Notes (Change Log).

This requires an admin account in Mantis.

Steps:

  • Log into Mantis at https://development.ham-radio-deluxe.com/login_page.php
  • Go to "Manage" on the left menu
  • Click the "Manage Projects" tab
  • Click on the "Ham Radio Deluxe" project
  • Go down to "Versions"; at the bottom of the versions list, there is a blank field. Enter the version there. For example, "6.4.0.777". Then click, "Add and Edit Version"
  • For that release, check the box that says, "Released" and click "Update Version"
  • Under "Versions", select "Current Dev List" from the dropdown and click "Copy Versions To" (this causes the new version to show up also in the "Current Dev List" and this enables developers to update "Fixed in Version" and to move the issues to "Ham Radio Deluxe")
  • For the issues included in the release (each line here can be changed in bulk):
    • Update "Fixed in Version" to the correct version
    • Update status to "Closed"
    • Move these issues to the "Ham Radio Deluxe" project
  • Done

Add version in osTicket for the release version

To enable osTicket to capture the version in the trouble ticket system, the version number needs to be added.

This requires an admin account in osTicket.

Steps:

  • Log into osTicket at https://support.ham-radio-deluxe.com/scp/index.php
  • Click on the "Admin Panel" link
  • Click on "Manage... Lists"
  • Click on "hrdver"
  • Click on "Add New Item"
  • Enter the version number (example: "6.4.0.777") in both "Value" and "Abbreviation" and click "Save"
  • Find and click the "Save Changes" button at the bottom of that page
  • Move away from the "Admin Panel"
  • Done

TrepStar

Update setup.exe and version text in TrepStar so that subsequent CD purchases will have the latest version.

We have only one admin account in TrepStar. That account must be used to perform this procedure.

Steps:

  • Login to TrepStar at http://www.trepstar.com/accounts.asp
  • Click the link for the project "Configure Project ID 211470: Ham Radio Deluxe"
  • Click on "CD Data File" and enter "http://beta.hrdsoftwarellc.com/files/setup.exe" where it says "Disc#1 Data File URL"; click "Save Changes"
  • Click on "Receipt and Notifications" and update the version number; click "Save Changes"
  • Click on "Advanced Settings" and update the version number; click "Save Changes"
  • At the top of the page, select "Dashboard... Project List"
  • To the right of the project "Configure Project ID 211470: Ham Radio Deluxe", select the "Orders and More..." dropdown, select "Fresh Project (Data/Art)", and follow the prompts to refresh the project.
  • Done

Update Website

Two text references to the software version need to be changed on UltraCart.

Steps:

  • Login to UltraCart at https://secure.ultracart.com/merchant/login.do
  • On the left menu, select "Storefronts" and "www.ham-radio-deluxe.com"
  • In the resulting menu, click "Pages"
  • Change "Home" page reference
    • Click the "edit" (pencil) icon for the "Home" page
    • Click the "Content" tab
    • Click "<>" to view content
    • Click the text where the Ham Radio Deluxe version is shown and select "Edit"
    • Only in the "Text" field, update the version text to the correct text.
    • Select "Edit" (oddly, this saves the changes)
    • Click on "Save Page"
  • Change "Download" page reference
    • Click the "edit" (pencil) icon for the "Download" page
    • Click the "Content" tab
    • Click "<>" to view content
    • Click the text where the Ham Radio Deluxe version is shown and select "Edit"
    • Only in the "Text" field, update the version text to the correct text.
    • Select "Edit" (oddly, this saves the changes)
    • Click on "Save Page"
  • Logout of UltraCart