Release Process - Revision history

Anw: Added rollback section

2022-12-23T16:03:44Z

Added rollback section

← Older revision		Revision as of 18:03, 23 December 2022
Line 112:		Line 112:

	Update the release register \\DGA1FS01OBS\Projects\Releases\EPOD\Release Logs\Release Register - Master.xls		Update the release register \\DGA1FS01OBS\Projects\Releases\EPOD\Release Logs\Release Register - Master.xls


	=== Correcting Script Issues ===		=== Correcting Script Issues ===
Line 119:		Line 120:
	* Follow the steps above in section [[#Build a Full Release\|Build a Full Release]]		* Follow the steps above in section [[#Build a Full Release\|Build a Full Release]]
	* Note that build versions need not be updated again, and tagged release should be appended with a annotation that this is a rebuild e.g. "4.05.01.19.R1" or "4.05.01.19.C1"		* Note that build versions need not be updated again, and tagged release should be appended with a annotation that this is a rebuild e.g. "4.05.01.19.R1" or "4.05.01.19.C1"


			=== Rolling back a release ===
			When following a full release procedure, a backup of the previous application and web installs is made. There is no automated process for re-installing this - simply copy the backup back over the app and web directories to roll back the release.

			{{Warning}} This does not rollback database changes - these must be completed manually.

Anw: Added instructions to stop and restart any task scheduler processes

2022-12-23T09:50:15Z

Added instructions to stop and restart any task scheduler processes

← Older revision		Revision as of 11:50, 23 December 2022
Line 68:		Line 68:
	App box release:		App box release:
	* Log on to the App server.		* Log on to the App server.
			* Stop the Auto_Import and Auto_Export scheduled processes using the Task Scheduler if they are running on this machine.
	* Copy the release zip to the app box, C:\_INSTALL_FILES		* Copy the release zip to the app box, C:\_INSTALL_FILES
	* Use File Explorer to go to C:\_INSTALL_EPOD		* Use File Explorer to go to C:\_INSTALL_EPOD
Line 87:		Line 88:
	* Finish the Release script command window prompts and close that window.		* Finish the Release script command window prompts and close that window.
	* Check and update any app or web config files with new required settings for all apps released.		* Check and update any app or web config files with new required settings for all apps released.
			* Restart the Auto_Import and Auto_Export scheduled processes using the Task Scheduler if they are running on this machine.

	From Database Server:		From Database Server:
Line 94:		Line 96:
	Web Box release:		Web Box release:
	* Log on to the Web server.		* Log on to the Web server.
			* Stop the Auto_Import and Auto_Export scheduled processes using the Task Scheduler if they are running on this machine.
	* Copy the release zip to the web box, C:\_INSTALL_FILES		* Copy the release zip to the web box, C:\_INSTALL_FILES
	* Use File Explorer to go to C:\_INSTALL_EPOD		* Use File Explorer to go to C:\_INSTALL_EPOD
Line 106:		Line 109:
	* Finish the Release script command window prompts and close that window.		* Finish the Release script command window prompts and close that window.
	* Check and update any app or web config files with new required settings for all apps released.		* Check and update any app or web config files with new required settings for all apps released.
			* Restart the Auto_Import and Auto_Export scheduled processes using the Task Scheduler if they are running on this machine.

	Update the release register \\DGA1FS01OBS\Projects\Releases\EPOD\Release Logs\Release Register - Master.xls		Update the release register \\DGA1FS01OBS\Projects\Releases\EPOD\Release Logs\Release Register - Master.xls


	=== Correcting Script Issues ===		=== Correcting Script Issues ===

Anw: Amendments

2022-12-21T12:58:21Z

Amendments

← Older revision		Revision as of 14:58, 21 December 2022
Line 29:		Line 29:
	** Right-click WebApp and choose Publish		** Right-click WebApp and choose Publish
	** Set the Target location as a local folder (re: Publish folder).		** Set the Target location as a local folder (re: Publish folder).
			** Click Publish.
			** Note: There are sometimes issues with AjaxControlToolkit.pdb. If this is the case when publishing, copy the file from a prior release into your WebApp/bin folder and try to publish again.
	** Open Publish folder in File Explorer.		** Open Publish folder in File Explorer.
	* From Publish Folder:		* From Publish Folder:

Anw: Amendments

2022-12-21T12:52:12Z

Amendments

← Older revision		Revision as of 14:52, 21 December 2022
Line 23:		Line 23:
	* Tag this commit in QA branch as tag "4.x.y.x" with appropriate description		* Tag this commit in QA branch as tag "4.x.y.x" with appropriate description

			From Visual Studio
	* From Solution Explorer:		* From Solution Explorer:
	** Rebuild Solution		** Rebuild Solution
Line 41:		Line 42:
	* Create Auto_Import and Auto_Export folder in Release/app folder		* Create Auto_Import and Auto_Export folder in Release/app folder
	* From Visual Studio, explore the Auto_Import project in File Explorer.		* From Visual Studio, explore the Auto_Import project in File Explorer.
	* From this file explorer, go to bin~~/debug~~, and copy all contents to Release/app/Auto_Import folder.		* From this file explorer, go to bin, go to Debug or Release (depending on how you published), and copy all contents to Release/app/Auto_Import folder.
	* From Release/app/Auto_Import, delete app config file.		* From Release/app/Auto_Import, delete app config file.
	* ~~Repeat these steps for~~ Auto_Export		* From Visual Studio, explore the ePOD_AutoExport project in File Explorer.
			* From this file explorer, go to bin, go to Debug or Release (depending on how you published), and copy all contents to Release/app/Auto_Export folder.
			* From Release/app/Auto_Export, delete app config file.
	* From Visual Studio, explore the Epod_Configuration project in File Explorer.		* From Visual Studio, explore the Epod_Configuration project in File Explorer.
	* From this file explorer, go to 4.x.0.0 folder and copy all contents to Release/~~EpodConfiguration~~ folder.		* From this file explorer, go to 4.x.0.0 folder and copy all contents to Release/Epod_Configuration folder.
	* From Visual Studio, explore the EPOD_DatabaseScriptsLibrary project in File Explorer.		* From Visual Studio, explore the EPOD_DatabaseScriptsLibrary project in File Explorer.
	* From this file explorer, go to bin/Debug folder and copy all contents to Release/~~ePOD_DatabaseScriptsLibrary~~ folder.		* From this file explorer, go to bin/Debug folder and copy all contents to Release/EPOD_DatabaseScriptsLibrary folder.
	* From folder above release folder, create a zip of the release folder i.e. EPOD_4.x.y.z.zip		* From folder above release folder, create a zip of the release folder i.e. EPOD_4.x.y.z.zip
	* Copy release zip to \\DGA1FS01OBS\Projects\Releases\EPOD\Server\Releases.		* Copy release zip to \\DGA1FS01OBS\Projects\Releases\EPOD\Server\Releases.
Line 110:		Line 113:
	* Stage and commit the changes		* Stage and commit the changes
	* Follow the steps above in section [[#Build a Full Release\|Build a Full Release]]		* Follow the steps above in section [[#Build a Full Release\|Build a Full Release]]
			* Note that build versions need not be updated again, and tagged release should be appended with a annotation that this is a rebuild e.g. "4.05.01.19.R1" or "4.05.01.19.C1"

Anw: Added Script Corrections section

2022-12-21T11:58:57Z

Added Script Corrections section

← Older revision		Revision as of 13:58, 21 December 2022
Line 103:		Line 103:

	Update the release register \\DGA1FS01OBS\Projects\Releases\EPOD\Release Logs\Release Register - Master.xls		Update the release register \\DGA1FS01OBS\Projects\Releases\EPOD\Release Logs\Release Register - Master.xls


			=== Correcting Script Issues ===
			* Use DEV branch
			* Find and fix the issues in script
			* Stage and commit the changes
			* Follow the steps above in section [[#Build a Full Release\|Build a Full Release]]

Anw: Corrections

2022-12-21T11:48:16Z

Corrections

← Older revision		Revision as of 13:48, 21 December 2022
Line 44:		Line 44:
	* From Release/app/Auto_Import, delete app config file.		* From Release/app/Auto_Import, delete app config file.
	* Repeat these steps for Auto_Export		* Repeat these steps for Auto_Export
	* From Visual Studio, explore the ~~EpodConfiguration~~ project in File Explorer.		* From Visual Studio, explore the Epod_Configuration project in File Explorer.
	* From this file explorer, go to 4.x.0.0 folder and copy all contents to Release/EpodConfiguration folder.		* From this file explorer, go to 4.x.0.0 folder and copy all contents to Release/EpodConfiguration folder.
	* From Visual Studio, explore the ~~ePOD_DatabaseScriptsLibrary~~ project in File Explorer.		* From Visual Studio, explore the EPOD_DatabaseScriptsLibrary project in File Explorer.
	* From this file explorer, go to bin/Debug folder and copy all contents to Release/ePOD_DatabaseScriptsLibrary folder.		* From this file explorer, go to bin/Debug folder and copy all contents to Release/ePOD_DatabaseScriptsLibrary folder.
	* From folder above release folder, create a zip of the release folder i.e. EPOD_4.x.y.z.zip		* From folder above release folder, create a zip of the release folder i.e. EPOD_4.x.y.z.zip
Line 65:		Line 65:
	* Copy the release zip to the app box, C:\_INSTALL_FILES		* Copy the release zip to the app box, C:\_INSTALL_FILES
	* Use File Explorer to go to C:\_INSTALL_EPOD		* Use File Explorer to go to C:\_INSTALL_EPOD
	* Copy the last release script for that customer or latest version of release script to new release script for that customer and version.		* Copy the last release script for that customer or latest version of release script to new release script for that customer and version. e.g. Deploy_Customer_4.5.1.19_BRC_TST.bat
	* Edit the release script		* Edit the release script
	** Change the ~~release version~~.		** Change the parameters in the script e.g.
	** Ensure customer and TST~~/PRD are set properly.~~		SET "__BuildVer=EPOD_4.5.1.19"
			SET "__CustomerCode=BRC"
			SET "__Environment=TST"
			SET "__CustomerName="BRC"
	** Save the changes		** Save the changes
	* Right-click the script and run as administrator.		* Right-click the script and run as administrator.
Line 78:		Line 81:
	* Exit database scripts library script command window		* Exit database scripts library script command window
	* Finish the Release script command window prompts and close that window.		* Finish the Release script command window prompts and close that window.
			* Check and update any app or web config files with new required settings for all apps released.

	From Database Server:		From Database Server:
Line 96:		Line 100:
	* A new command window will open with the database scripts library script - close it.		* A new command window will open with the database scripts library script - close it.
	* Finish the Release script command window prompts and close that window.		* Finish the Release script command window prompts and close that window.
			* Check and update any app or web config files with new required settings for all apps released.

	Update the release register \\DGA1FS01OBS\Projects\Releases\EPOD\Release Logs\Release Register - Master.xls		Update the release register \\DGA1FS01OBS\Projects\Releases\EPOD\Release Logs\Release Register - Master.xls

Anw: Updated EPOD server release instructions

2022-12-21T11:33:08Z

Updated EPOD server release instructions

Show changes

Anw: Update for new network folder structures.

2019-10-04T16:30:22Z

Update for new network folder structures.

Anw at 10:11, 14 August 2015

2015-08-14T10:11:15Z

← Older revision		Revision as of 12:11, 14 August 2015
Line 19:		Line 19:
	**Set the Target Location to the Admin folder within the release directory (e.g. P:\EPOD\_Development\_Releases\ePOD Admin V1.32.7\Admin).		**Set the Target Location to the Admin folder within the release directory (e.g. P:\EPOD\_Development\_Releases\ePOD Admin V1.32.7\Admin).
	*In folder used for the publish delete the web.config file (if present).		*In folder used for the publish delete the web.config file (if present).
	*In folder used for the publish go into the WebServices\Calidus_ePOD\PDAUpdates subdirectory and ~~delete~~ the UpdatesInfo.xml file (if present).		*In folder used for the publish go into the WebServices\Calidus_ePOD\PDAUpdates subdirectory and update the UpdatesInfo.xml file (if present).
	*To release copy the contents of the folder used for the publish to the application folder on the target machine, overwriting any existing files. Do not delete any files (the web.config is not released and the contents of the PDAUpdates folder created by a PDA release).		*To release copy the contents of the folder used for the publish to the application folder on the target machine, overwriting any existing files. Do not delete any files (the web.config is not released and the contents of the PDAUpdates folder created by a PDA release).

Line 31:		Line 31:
	*To release:		*To release:
	**Copy the three cab files from the release PDA directory to the PDAUpdates directory on the target machine. This direcotry is below the Admin web application directory in the WebServices\Calidus_ePOD subdirectory.		**Copy the three cab files from the release PDA directory to the PDAUpdates directory on the target machine. This direcotry is below the Admin web application directory in the WebServices\Calidus_ePOD subdirectory.
	**In the same PDAUpdates directory update the version numbers in the UpdatesInfo.xml file.		**In the same PDAUpdates directory update the version numbers in the UpdatesInfo.xml file. Example:
			<?xml version="1.0" encoding="utf-8" ?>
			<UPDATES>
			<EPOD_CLIENT version="1.30.0.0"
			url="http://my.url.com:9093/WebServices/Calidus_ePOD/PDAUpdates/EPODClientInstaller.CAB"
			required="Y" />
			<EPOD_CLIENT_ANDROID version="3.00.02.09"
			url="http://my.url.com:40462/WebServices/Calidus_ePOD/PDAUpdates/CALIDUSePODv3.apk"
			required="Y" />
			<EPOD_UPDATER version="1.26.2.0"
			url="http://my.url.com:9093/WebServices/Calidus_ePOD/PDAUpdates/ePODUpdaterInstall.CAB"
			required="Y" />
			</UPDATES>


Line 72:		Line 84:

	Update the UpdatesInfo.xml file as follows:		Update the UpdatesInfo.xml file as follows:
	<EPOD_CLIENT_ANDROID version="2.00.20" url="http://~~your~~.url.com/~~webservices~~/~~calidus_epod~~/PDAUpdates/~~your~~.apk" required="N" />		<?xml version="1.0" encoding="utf-8" ?>
			<UPDATES>
			<EPOD_CLIENT version="1.30.0.0"
			url="http://my.url.com:9093/WebServices/Calidus_ePOD/PDAUpdates/EPODClientInstaller.CAB"
			required="Y" />
			<EPOD_CLIENT_ANDROID version="3.00.02.09"
			url="http://my.url.com:40462/WebServices/Calidus_ePOD/PDAUpdates/CALIDUSePODv3.apk"
			required="Y" />
			<EPOD_UPDATER version="1.26.2.0"
			url="http://my.url.com:9093/WebServices/Calidus_ePOD/PDAUpdates/ePODUpdaterInstall.CAB"
			required="Y" />
			</UPDATES>

	Attributes:		Attributes:

Anw at 16:33, 8 December 2014

2014-12-08T16:33:56Z

← Older revision		Revision as of 18:33, 8 December 2014
Line 71:		Line 71:
	Once the app is built, drop the app file in your_app_folder\webservices\calidus_epod\PDAUpdates\		Once the app is built, drop the app file in your_app_folder\webservices\calidus_epod\PDAUpdates\

	Access to this APK is then through http://your.url.com/webservices/calidus_epod/PDAUpdates/your.apk		Update the UpdatesInfo.xml file as follows:
			<EPOD_CLIENT_ANDROID version="2.00.20" url="http://your.url.com/webservices/calidus_epod/PDAUpdates/your.apk" required="N" />

			Attributes:
			* version - your build version, without any leading or trailing characters
			* url - the url of where this installer may be accessed
			* required - if this is a critical bug fix, set this to "Y", else "N"
			{{Note}} Case is important!

			Access to this APK is then through the url: http://your.url.com/webservices/calidus_epod/PDAUpdates/your.apk


	==Documentation==		==Documentation==

← Older revision		Revision as of 18:30, 4 October 2019
Line 5:		Line 5:
	**If releasing the admin client the versions in the four projects (ePOD_AutoExport, ePOD_WebApp, ePOD_WebServices and EPODServer) need not be kept the same.		**If releasing the admin client the versions in the four projects (ePOD_AutoExport, ePOD_WebApp, ePOD_WebServices and EPODServer) need not be kept the same.
	**If releasing the pda client the versions in the two projects (ePODClient and ePODClientUpdater) can be different.		**If releasing the pda client the versions in the two projects (ePODClient and ePODClientUpdater) can be different.
	*Copy the release template folder <pre>P:\EPOD\~~_Installers~~\Releases In Progress\EPOD_UPYYMMDD_Template</pre> to create a release directory.		*Copy the release template folder <pre>P:\Releases\EPOD\Server\Releases In Progress\EPOD_UPYYMMDD_Template</pre> to create a release directory.
	*Rename the release directory replacing YYMMDD with the date the release is being performed.		*Rename the release directory replacing YYMMDD with the date the release is being performed.
	*Any SQL changes should be placed within the Release folder, in files UPYYYYMMDD MSSQL.SQL and UPYYYYMMDD MYSQL.SQL		*Any SQL changes should be placed within the Release folder, in files UPYYYYMMDD MSSQL.SQL and UPYYYYMMDD MYSQL.SQL
Line 17:		Line 17:
	*Use the publish option against the ePOD_WebApp project (right click project and select publish or select publish ePOD_WebApp option in the Build menu).		*Use the publish option against the ePOD_WebApp project (right click project and select publish or select publish ePOD_WebApp option in the Build menu).
	**Set the Publish method to File System.		**Set the Publish method to File System.
	**Set the Target Location to the Admin folder within the release directory (e.g. P:\EPOD\~~_Development\_Releases~~\ePOD Admin V1.32.7\Admin).		**Set the Target Location to the Admin folder within the release directory (e.g. P:\Releases\EPOD\Server\ePOD Admin V1.32.7\Admin).
	*In folder used for the publish delete the web.config file (if present).		*In folder used for the publish delete the web.config file (if present).
	*In folder used for the publish go into the WebServices\Calidus_ePOD\PDAUpdates subdirectory and update the UpdatesInfo.xml file (if present).		*In folder used for the publish go into the WebServices\Calidus_ePOD\PDAUpdates subdirectory and update the UpdatesInfo.xml file (if present).
Line 28:		Line 28:
	**To build right click the project and select Build.		**To build right click the project and select Build.
	**The ePODClientInstaller and ePODUpdateInstaller projects must be built before the ePODClientInstallerComplete		**The ePODClientInstaller and ePODUpdateInstaller projects must be built before the ePODClientInstallerComplete
	*Copy the three cab files from your local ePOD_AutoExport\bin\Release folder (e.g. C:\Projects\EPOD\ePOD_WebApp\ePOD_AutoExport\bin\Release) to the PDA folder within the release directory (e.g. P:\EPOD\~~_Development\_Releases~~\ePOD PDA V1.31.1.9\PDA).		*Copy the three cab files from your local ePOD_AutoExport\bin\Release folder (e.g. C:\Projects\EPOD\ePOD_WebApp\ePOD_AutoExport\bin\Release) to the PDA folder within the release directory (e.g. P:\Releases\EPOD\Server\ePOD PDA V1.31.1.9\PDA).
	*To release:		*To release:
	**Copy the three cab files from the release PDA directory to the PDAUpdates directory on the target machine. This ~~direcotry~~ is below the Admin web application directory in the WebServices\Calidus_ePOD subdirectory.		**Copy the three cab files from the release PDA directory to the PDAUpdates directory on the target machine. This directory is below the Admin web application directory in the WebServices\Calidus_ePOD subdirectory.
	**In the same PDAUpdates directory update the version numbers in the UpdatesInfo.xml file. Example:		**In the same PDAUpdates directory update the version numbers in the UpdatesInfo.xml file. Example:
	<?xml version="1.0" encoding="utf-8" ?>		<?xml version="1.0" encoding="utf-8" ?>