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. |
| + | |
| + | 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]) |
| + | |
| + | It uses the smeserver-gitutils config files (~/.smegit/config) |
| + | |
| + | === 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" | | {| class="wikitable" |
| |+List of base e-smith packages | | |+List of base e-smith packages |
| !Package | | !Package |
| !Status* | | !Status* |
− | !Who
| |
| !Comments | | !Comments |
| |- | | |- |
| |e-smith | | |e-smith |
− | |draft | + | |manual/script? |
− | |[[User:TrevorB|TrevorB]]
| + | |Need to check whether script works (i.e. no e-smith-) |
− | | | |
| |- | | |- |
| |e-smith-LPRng | | |e-smith-LPRng |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-apache | | |e-smith-apache |
− | | | + | |script |
− | | | + | |renamed event to smeserver-apache-update, but have not touched httpd-e-smith..... should we? |
− | |
| |
| |- | | |- |
| |e-smith-backup | | |e-smith-backup |
− | |draft | + | |script |
− | |[[User:TrevorB|TrevorB]]
| |
| | | | | |
| |- | | |- |
| |e-smith-base | | |e-smith-base |
− | |draft | + | |script |
− | |[[User:TrevorB|TrevorB]]
| |
| | | | | |
| |- | | |- |
| |e-smith-cvm-unix-local | | |e-smith-cvm-unix-local |
− | |draft | + | |script |
− | |[[User:TrevorB|TrevorB]]
| |
| | | | | |
| |- | | |- |
| |e-smith-devtools | | |e-smith-devtools |
− | |draft | + | |script |
− | |[[User:TrevorB|TrevorB]]
| |
| | | | | |
| |- | | |- |
| |e-smith-dnscache | | |e-smith-dnscache |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-domains | | |e-smith-domains |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-dynamicdns-dyndns | | |e-smith-dynamicdns-dyndns |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-dynamicdns-dyndns.org | | |e-smith-dynamicdns-dyndns.org |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-dynamicdns-tzo | | |e-smith-dynamicdns-tzo |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-dynamicdns-yi | | |e-smith-dynamicdns-yi |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-email | | |e-smith-email |
− | |draft | + | |script |
− | |[[User:TrevorB|TrevorB]]
| |
| | | | | |
| |- | | |- |
| |e-smith-flexbackup | | |e-smith-flexbackup |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-formmagick | | |e-smith-formmagick |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-grub | | |e-smith-grub |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-horde | | |e-smith-horde |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-hosts | | |e-smith-hosts |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-ibays | | |e-smith-ibays |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-imp | | |e-smith-imp |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-ingo | | |e-smith-ingo |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-ldap | | |e-smith-ldap |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-lib | | |e-smith-lib |
− | |draft | + | |script |
− | |[[User:TrevorB|TrevorB]]
| |
| | | | | |
| |- | | |- |
| |e-smith-lib-compspec | | |e-smith-lib-compspec |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-manager | | |e-smith-manager |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-mysql | | |e-smith-mysql |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-ntp | | |e-smith-ntp |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-nutUPS | | |e-smith-nutUPS |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-oidentd | | |e-smith-oidentd |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-openssh | | |e-smith-openssh |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-packetfilter | | |e-smith-packetfilter |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-php | | |e-smith-php |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-po | | |e-smith-po |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-portforwarding | | |e-smith-portforwarding |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-pptpd | | |e-smith-pptpd |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-proftpd | | |e-smith-proftpd |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-proxy | | |e-smith-proxy |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-qmail | | |e-smith-qmail |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-qmailanalog | | |e-smith-qmailanalog |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-quota | | |e-smith-quota |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-radiusd | | |e-smith-radiusd |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-runit | | |e-smith-runit |
− | |draft | + | |script |
− | |[[User:TrevorB|TrevorB]]
| |
| | | | | |
| |- | | |- |
| |e-smith-samba | | |e-smith-samba |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-starterwebsite | | |e-smith-starterwebsite |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-test | | |e-smith-test |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-tinydns | | |e-smith-tinydns |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-turba | | |e-smith-turba |
− | | | + | |script |
− | |
| |
| | | | | |
| |- | | |- |
| |e-smith-viewlogfiles | | |e-smith-viewlogfiles |
− | | | + | |script |
− | |
| |
| | | | | |
| |} | | |} |
| Status*: | | Status*: |
| | | |
− | *Started - developer has forked package and has started work | + | *Script - works automagically with script |
− | *Draft - developer has completed first cut of changes and transferred package into smeserver Organisation. Ready for review/testing
| |
− | *Testing - formal review and testing of package commenced
| |
− | *Ready - Review/testing completed OK and ready for inclusion in smeserver base
| |
| | | |
| === What needs to be done:=== | | === What needs to be done:=== |
− | All of these changes are being done in the new https://src.koozali.org GITEA instance after the packages have been migrated there. | + | All of these changes are being done from the new https://src.koozali.org GITEA instance after the packages have been migrated there. |
− | *Create copy of e-smith-<pkg> as smeserver-<pkg> Fork the smeserver/e-smith-<pkg> into your own user space as <user>/smeserver-<pkg> | + | |
| + | 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 | | *Makefile - change e-smith to smeserver |
Line 268: |
Line 238: |
| </syntaxhighlight> | | </syntaxhighlight> |
| | | |
− | *smeserver-<pkg>.spec - change e-smith to smeserver and add in Provides of the old e-smith package | + | *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"> | | <syntaxhighlight lang="spec"> |
| %define name smeserver-<pkg> | | %define name smeserver-<pkg> |
Line 274: |
Line 244: |
| . | | . |
| Provides: e-smith-<pkg> | | Provides: e-smith-<pkg> |
− | </syntaxhighlight>change all Requires: e-smith- to Requires: smeserver<br>If the Source: is not tar.gz, change it and delete the archivefilename file<syntaxhighlight lang="spec"> | + | </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 | | Source: %{name}-%{version}.tar.gz |
− | </syntaxhighlight> | + | </syntaxhighlight>change e-smith to smeserver for Summary: and %description |
− | *README.md - change name and add link to bugzilla for both new and existing names (i.e. keep the old link there)
| |
| | | |
− | *'Transfer' your smeserver-<pkg> over to the smeserver Organisation (owner) when you think it's ready for review/testing/etc. and 'Convert to a Regular Repository' | + | 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?=== | | ===Do we need to change the e-smith directories too?=== |