Add major version - Revision history

Kyle: /* Adding new DOCK Versions to licensing.docking.org */

2025-07-15T20:04:35Z

Adding new DOCK Versions to licensing.docking.org

← Older revision		Revision as of 20:04, 15 July 2025
Line 3:		Line 3:
	* All the dock versions are in <code>/nfs/soft/dock/packages</code> on <code>nfs-soft</code>		* All the dock versions are in <code>/nfs/soft/dock/packages</code> on <code>nfs-soft</code>
	* Add the new DOCK file and then replace the relevant <code>dockx-latest.tgz</code> with the new DOCK release		* Add the new DOCK file and then replace the relevant <code>dockx-latest.tgz</code> with the new DOCK release
	** For example, if there is a new minor version of DOCK 6 like DOCK 6.15 (<code>dock.6.15.tgz</code>), copy the .tgz into the <code>/nfs/soft/dock/packages</code> folder. Remove <code>dock6-latest.tgz</code> and then <code>ln -s dock.6.15.tgz dock6-latest.tgz</code>.		** For example, if there is a new minor version of DOCK 6 like DOCK 6.15 (<code>dock.6.15.tgz</code>), copy the .tgz into the <code>/nfs/soft/dock/packages</code> folder. Remove <code>dock6-latest.tgz</code> and then <code>ln -s dock.6.15.tgz dock6-latest.tgz</code>. You should now have dock6-latest.tgz as a symlink pointing to dock.6.15.tgz.
	** If you are getting permission errors change to the <code>www</code> user: <code>sudo su</code> and then <code>su - www</code>		** If you are getting permission errors change to the <code>www</code> user: <code>sudo su</code> and then <code>su - www</code>

Kyle: /* Adding new DOCK Versions to DOCK-Admin */

2025-07-15T20:02:20Z

Adding new DOCK Versions to DOCK-Admin

← Older revision		Revision as of 20:02, 15 July 2025
Line 1:		Line 1:
	= Adding new DOCK Versions to ~~DOCK-Admin~~ =		= Adding new DOCK Versions to licensing.docking.org =
	* DOCK-License code is on https://gitlab.docking.org/kylep/dock-admin request access from [[sysadmin]]		* DOCK-License code is on https://gitlab.docking.org/kylep/dock-admin request access from [[sysadmin]]
	* All the dock versions are in <code>/nfs/soft/dock/packages</code> on <code>nfs-soft</code>		* All the dock versions are in <code>/nfs/soft/dock/packages</code> on <code>nfs-soft</code>

Kyle: Make DOCK update instructions more clear

2025-07-15T19:55:49Z

Make DOCK update instructions more clear

← Older revision		Revision as of 19:55, 15 July 2025
Line 3:		Line 3:
	* All the dock versions are in <code>/nfs/soft/dock/packages</code> on <code>nfs-soft</code>		* All the dock versions are in <code>/nfs/soft/dock/packages</code> on <code>nfs-soft</code>
	* Add the new DOCK file and then replace the relevant <code>dockx-latest.tgz</code> with the new DOCK release		* Add the new DOCK file and then replace the relevant <code>dockx-latest.tgz</code> with the new DOCK release
	** For example, if there is a new minor version of DOCK 6 like DOCK 6.15 (<code>dock.6.15.tgz</code>), copy the .tgz into the <code>/nfs/soft/dock/packages</code> folder. Remove <code>dock6-latest.tgz</code> and then <code>ln dock.6.15.tgz dock6-latest.tgz</code>.		** For example, if there is a new minor version of DOCK 6 like DOCK 6.15 (<code>dock.6.15.tgz</code>), copy the .tgz into the <code>/nfs/soft/dock/packages</code> folder. Remove <code>dock6-latest.tgz</code> and then <code>ln -s dock.6.15.tgz dock6-latest.tgz</code>.
			** If you are getting permission errors change to the <code>www</code> user: <code>sudo su</code> and then <code>su - www</code>

	= Adding new Major Dock version =		= Adding new Major Dock version =

Kyle: How to add in major versions of DOCK to DOCK-license

2025-03-18T08:51:01Z

How to add in major versions of DOCK to DOCK-license

New page

= Adding new DOCK Versions to DOCK-Admin =
* DOCK-License code is on https://gitlab.docking.org/kylep/dock-admin request access from [[sysadmin]]
* All the dock versions are in <code>/nfs/soft/dock/packages</code> on <code>nfs-soft</code>
* Add the new DOCK file and then replace the relevant <code>dockx-latest.tgz</code> with the new DOCK release
** For example, if there is a new minor version of DOCK 6 like DOCK 6.15 (<code>dock.6.15.tgz</code>), copy the .tgz into the <code>/nfs/soft/dock/packages</code> folder. Remove <code>dock6-latest.tgz</code> and then <code>ln dock.6.15.tgz dock6-latest.tgz</code>.

= Adding new Major Dock version =
* Major dock versions are listed in <code>dock-admin/lib/constants.ts</code>
* Add the name of the new DOCK version to <code>MAIN_VERSIONS</code>, the same name to <code>MainVersions</code>, and a mapping of that name to a <code>.tgz</code> file in <code>/nfs/soft/dock/packages</code> in <code>dockVersions</code>.
* For example, if adding DOCK 7 as a new major version:

== Change constants.ts From ==
<pre>
// These DOCK versions will be shown on the application screen and highlighted when creating / editing a user
export type MainVersion = 'DOCK 3.7' | 'DOCK 3.8' | 'DOCK 4' | 'DOCK 6';

export const MAIN_VERSIONS: MainVersion[] = [
'DOCK 3.7',
'DOCK 3.8',
'DOCK 4',
'DOCK 6'
];

const dockVersions: AllowedFiles = {
'DOCK 3.7': 'dock3.7-latest.tgz',
'DOCK 3.8': 'dock3.8-latest.tgz',
'DOCK 4': 'dock4-latest.tgz',
'DOCK 6': 'dock6-latest.tgz',

// Old Versions imported from old db
...
};
</pre>

== Change constants.ts To ==
<pre>
// These DOCK versions will be shown on the application screen and highlighted when creating / editing a user
export type MainVersion = 'DOCK 3.7' | 'DOCK 3.8' | 'DOCK 4' | 'DOCK 6' | 'DOCK 7'; // <- The new major DOCK version

export const MAIN_VERSIONS: MainVersion[] = [
'DOCK 3.7',
'DOCK 3.8',
'DOCK 4',
'DOCK 6',
'DOCK 7' // <- The new major DOCK version
];

const dockVersions: AllowedFiles = {
'DOCK 3.7': 'dock3.7-latest.tgz',
'DOCK 3.8': 'dock3.8-latest.tgz',
'DOCK 4': 'dock4-latest.tgz',
'DOCK 6': 'dock6-latest.tgz',
'DOCK 7': 'dock7-latest.tgz', // <- The new major Dock versions latest.tgz in `/nfs/soft/dock/packages`

// Old Versions imported from old db
...
};
</pre>

= Testing Changes =
* <code>git clone https://gitlab.docking.org/kylep/dock-admin</code>
* <code>cd dock-admin</code>
* <code>npm install</code> to install all required packages
* <code>docker compose up -d</code> is required as it will build and create the docker container for the database and initialize a default admin account.
* While the postgress db is running you can use <code>npm run dev</code> to run the dev server without needing to rebuild the entire container every time. If ran locally it will use the downloads folder in the repo instead of <code>/nfs/soft/dock/packages</code>. If ran with docker it will use <code>/nfs/soft/dock/packages</code>. You can change <code>.env.docker</code> to modify the directory the server looks in for serving downloads.

= Committing Changes =
* <code>git add</code> the changed files, make a new commit, and push
* The CI/CD pipeline will automatically deploy the new changes. Use the admin dashboard to test the new changes!