Changes

Jump to navigation Jump to search

Migrate e-smith to smeserver (view source)

Revision as of 07:02, 12 August 2023

5,434 bytes added ,  07:02, 12 August 2023
m
no edit summary
Line 1: Line 1:  
This page is to discuss and track the migration of legacy e-smith- packages etc. to smeserver- packages and the associated changes required.
 
This page is to discuss and track the migration of legacy e-smith- packages etc. to smeserver- packages and the associated changes required.
   −
List of base e-smith packages:
+
This is now being done via a script (rename-e-smith-pkg.git, held in the smeserver-gitutils repo on [https://src.koozali.org/smedev/smeserver-gitutils https://src.koozali.org])
   −
What needs to be done:
+
It uses the smeserver-gitutils config files (~/.smegit/config)
   −
Do we need to change the e-smith directories too?
+
=== rename-e-smith-pkg.sh ===
 +
Rename an e-smith package as smeserver and change relevant files. Renamed repository will be in your user area<syntaxhighlight lang="bash">
 +
rename-emith-pkg.sh <pkg> [<organisation> <local> <force> <transfer> <debug>]
 +
</syntaxhighlight><pkg> = Module name e.g. e-smith-dnscache
 +
 
 +
optional parameters, can appear in any order
 +
 
 +
* <organisation> (any gitea organisation smeserver, smecontribs or user - defaults to smeserver)
 +
* <local> will use parameters set for local repository else it will use remote
 +
* <force> will automagically delete an existing repo, otherwise it will prompt
 +
* <transfer> will transfer the completed module from your user area to smeserver, or <organisation>, organisation - only works if you are an owner of the target organisation
 +
* <debug> run in debug mode
 +
 
 +
This works whether the repo and local files exist of not (it deletes them if necessary)
 +
{| class="wikitable"
 +
|+List of base e-smith packages
 +
!Package
 +
!Status*
 +
!Comments
 +
|-
 +
|e-smith
 +
|manual/script?
 +
|Need to check whether script works (i.e. no e-smith-)
 +
|-
 +
|e-smith-LPRng
 +
|script
 +
|
 +
|-
 +
|e-smith-apache
 +
|script
 +
|renamed event to smeserver-apache-update, but have not touched httpd-e-smith..... should we?
 +
|-
 +
|e-smith-backup
 +
|script
 +
|
 +
|-
 +
|e-smith-base
 +
|script
 +
|
 +
|-
 +
|e-smith-cvm-unix-local
 +
|script
 +
|
 +
|-
 +
|e-smith-devtools
 +
|script
 +
|
 +
|-
 +
|e-smith-dnscache
 +
|script
 +
|
 +
|-
 +
|e-smith-domains
 +
|script
 +
|
 +
|-
 +
|e-smith-dynamicdns-dyndns
 +
|script
 +
|
 +
|-
 +
|e-smith-dynamicdns-dyndns.org
 +
|script
 +
|
 +
|-
 +
|e-smith-dynamicdns-tzo
 +
|script
 +
|
 +
|-
 +
|e-smith-dynamicdns-yi
 +
|script
 +
|
 +
|-
 +
|e-smith-email
 +
|script
 +
|
 +
|-
 +
|e-smith-flexbackup
 +
|script
 +
|
 +
|-
 +
|e-smith-formmagick
 +
|script
 +
|
 +
|-
 +
|e-smith-grub
 +
|script
 +
|
 +
|-
 +
|e-smith-horde
 +
|script
 +
|
 +
|-
 +
|e-smith-hosts
 +
|script
 +
|
 +
|-
 +
|e-smith-ibays
 +
|script
 +
|
 +
|-
 +
|e-smith-imp
 +
|script
 +
|
 +
|-
 +
|e-smith-ingo
 +
|script
 +
|
 +
|-
 +
|e-smith-ldap
 +
|script
 +
|
 +
|-
 +
|e-smith-lib
 +
|script
 +
|
 +
|-
 +
|e-smith-lib-compspec
 +
|script
 +
|
 +
|-
 +
|e-smith-manager
 +
|script
 +
|
 +
|-
 +
|e-smith-mysql
 +
|script
 +
|
 +
|-
 +
|e-smith-ntp
 +
|script
 +
|
 +
|-
 +
|e-smith-nutUPS
 +
|script
 +
|
 +
|-
 +
|e-smith-oidentd
 +
|script
 +
|
 +
|-
 +
|e-smith-openssh
 +
|script
 +
|
 +
|-
 +
|e-smith-packetfilter
 +
|script
 +
|
 +
|-
 +
|e-smith-php
 +
|script
 +
|
 +
|-
 +
|e-smith-po
 +
|script
 +
|
 +
|-
 +
|e-smith-portforwarding
 +
|script
 +
|
 +
|-
 +
|e-smith-pptpd
 +
|script
 +
|
 +
|-
 +
|e-smith-proftpd
 +
|script
 +
|
 +
|-
 +
|e-smith-proxy
 +
|script
 +
|
 +
|-
 +
|e-smith-qmail
 +
|script
 +
|
 +
|-
 +
|e-smith-qmailanalog
 +
|script
 +
|
 +
|-
 +
|e-smith-quota
 +
|script
 +
|
 +
|-
 +
|e-smith-radiusd
 +
|script
 +
|
 +
|-
 +
|e-smith-runit
 +
|script
 +
|
 +
|-
 +
|e-smith-samba
 +
|script
 +
|
 +
|-
 +
|e-smith-starterwebsite
 +
|script
 +
|
 +
|-
 +
|e-smith-test
 +
|script
 +
|
 +
|-
 +
|e-smith-tinydns
 +
|script
 +
|
 +
|-
 +
|e-smith-turba
 +
|script
 +
|
 +
|-
 +
|e-smith-viewlogfiles
 +
|script
 +
|
 +
|}
 +
Status*:
 +
 
 +
*Script - works automagically with script
 +
 
 +
=== What needs to be done:===
 +
All of these changes are being done from the new https://src.koozali.org GITEA instance after the packages have been migrated there.
 +
 
 +
The following actions are being performed by the script:
 +
*Fork the e-smith-<pkg> into your own user space as <user>/smeserver-<pkg>
 +
 
 +
*README.md - change name and add link to bugzilla for both new and existing names (i.e. keep the old link there)
 +
 
 +
*Makefile - change e-smith to smeserver
 +
<syntaxhighlight lang="spec">
 +
NAME := smeserver-<pkg>
 +
</syntaxhighlight>
 +
 
 +
*rename the e-smith-<pkg>.spec file to smeserver-<pkg>.spec - change e-smith to smeserver and add in Provides of the old e-smith package
 +
<syntaxhighlight lang="spec">
 +
%define name smeserver-<pkg>
 +
.
 +
.
 +
Provides: e-smith-<pkg>
 +
</syntaxhighlight>change all Requires:& BuildRequires: e-smith- to Requires: or BuildRequires: smeserver-<br>If the Source: is not tar.gz, change it and delete the archivefilename file<syntaxhighlight lang="spec">
 +
Source: %{name}-%{version}.tar.gz
 +
</syntaxhighlight>change e-smith to smeserver for Summary: and %description
 +
 
 +
add entry to changelog and reference Bugzilla bug #12359
 +
*createlinks - you may need to change the update event to smeserver- (from e-smith)
 +
There is no API function for the 'Convert to a Regular Repository' action, so the following will need to be performed manually via the GITEA web interface.
 +
*'Convert to a Regular Repository'
 +
*'Transfer' your smeserver-<pkg> over to the smeserver Organisation (owner) when you think it's ready for review/testing/etc.
 +
 
 +
===Do we need to change the e-smith directories too?===
 +
This will be done as a later exercise, but let's capture what needs to be done as we work through the packages.
 +
 
 +
In the first few packages I 'migrated' I have also symlinked smeserver to the e-smith directories so that we can start using/testing the new directory names (e.g. /etc/smeserver instead of /etc/e-smith).
 +
{| class="wikitable"
 +
|+new smeserver directories
 +
!directory
 +
!symlinked to
 +
! where symlinked
 +
|-
 +
|/etc/smeserver
 +
|/etc/e-smith
 +
|smeserver-lib
 +
smeserver-devtools
 +
 
 +
smeserver-runit
 +
|-
 +
|/home/smeserver
 +
|/home/e-smith
 +
|smeserver-lib
 +
|-
 +
|/usr/sbin/smeserver
 +
|/usr/bin/e-smith
 +
|smeserver-lib
 +
smeserver-devtools
 +
|-
 +
|/usr/local/perl5/vendor_perl/esmith
 +
|/usr/local/perl5/vendor_perl/esmith
 +
|smeserver-lib
 +
smeserver-devtools
 +
|}
 +
In the packages I have 'migrated' I have left the directory structure unchanged. This will be a task for another day :)
 +
 
 +
{{Note box|Whilst the changes in the root directory structure are fairly obvious, this also impacts the createlinks.pm and possibly the createlinks files}}
 +
 
 +
[[Category:Developer]]
TrevorB
371

edits

Retrieved from "https://wiki.koozali.org/Special:MobileDiff/42055...42172"

Navigation menu