Changes

From SME Server
Jump to navigationJump to search
Line 9: Line 9:     
==== Prerequisites ====
 
==== Prerequisites ====
=====Installation Centos6 minimal=====
+
{{warning box|If you plan to build for sme10, you must use an el7 version of centos minimal. It is also workable on a Fedora25}}
 +
====Installation CentOS6 / CentOS7 minimal====
 
* It is recommended that you use the latest CentOS 6 (64bit) version as a base http://mirror.centos.org/centos/6/isos/x86_64/ this has been verified to build for SME 7, 8 & 9 and for i386 &x86_64
 
* It is recommended that you use the latest CentOS 6 (64bit) version as a base http://mirror.centos.org/centos/6/isos/x86_64/ this has been verified to build for SME 7, 8 & 9 and for i386 &x86_64
 
Just install a minimal el6 installation. You can use either the DVD, the minimal CD install, a net install with PXE, it's up to you. Of course if you prefer you can use a system with a Xorg-server installed (eg: gnome, kde, xfce...)  
 
Just install a minimal el6 installation. You can use either the DVD, the minimal CD install, a net install with PXE, it's up to you. Of course if you prefer you can use a system with a Xorg-server installed (eg: gnome, kde, xfce...)  
Line 55: Line 56:  
   [root@buildcos9 ~]# reboot
 
   [root@buildcos9 ~]# reboot
   −
*Disable SELinux
+
*Disable SELinux SME9
 
It will be easier to see what's going on (and turn off selinux at kernel level, just to be sure)
 
It will be easier to see what's going on (and turn off selinux at kernel level, just to be sure)
 
  [root@buildcos9 ~]# sed -i -e 's/rhgb quiet/selinux=0/g' /boot/grub/grub.conf
 
  [root@buildcos9 ~]# sed -i -e 's/rhgb quiet/selinux=0/g' /boot/grub/grub.conf
 
  [root@buildcos9 ~]# sed -i -e 's/SELINUX=.*/SELINUX=disabled/g' /etc/selinux/config
 
  [root@buildcos9 ~]# sed -i -e 's/SELINUX=.*/SELINUX=disabled/g' /etc/selinux/config
 +
 +
*SME10
 +
in /etc/selinux/config set */SELINUX=disabled
    
* Remove selinux-policy-targeted and authconfig -they conflict with some e-smith/smeserver packages
 
* Remove selinux-policy-targeted and authconfig -they conflict with some e-smith/smeserver packages
 
  [root@buildcos9 ~]# yum remove selinux-policy-targeted authconfig
 
  [root@buildcos9 ~]# yum remove selinux-policy-targeted authconfig
      
* Apply all available updates.
 
* Apply all available updates.
Line 71: Line 74:  
* You need to have EPEL repository configured as EPELs version of mock will be used
 
* You need to have EPEL repository configured as EPELs version of mock will be used
 
<syntaxhighlight lang="Bash">
 
<syntaxhighlight lang="Bash">
 +
 
# Enable EPEL for Centos 6
 
# Enable EPEL for Centos 6
 
rpm -Uvh http://fr2.rpmfind.net/linux/epel/6/i386/epel-release-6-8.noarch.rpm
 
rpm -Uvh http://fr2.rpmfind.net/linux/epel/6/i386/epel-release-6-8.noarch.rpm
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 +
# Enable EPEL and sclo repo for Centos 7
 +
rpm -ivh <nowiki>https://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/e/epel-release-7-12.noarch.rpm</nowiki>
 +
or (works 29Dec19 - bjr)
 +
 +
yum install -y epel-release
 +
 +
rpm -ivh <nowiki>http://mirror.centos.org/altarch/7/extras/aarch64/Packages/centos-release-scl-rh-2-3.el7.centos.noarch.rpm</nowiki>
 +
 +
yum install centos-release-scl-rh
    
* You need to create a new user, for mock will not accept user root for building packages
 
* You need to create a new user, for mock will not accept user root for building packages
<div class="mw-collapsible mw-collapsed" data-collapsetext="Collapse" data-expandtext="More on creating a sudo user">
+
<div class="mw-collapsible mw-collapsed" data-expandtext="More on creating a sudo user" data-collapsetext="Collapse">
    
<syntaxhighlight lang="Bash">
 
<syntaxhighlight lang="Bash">
Line 117: Line 131:  
<syntaxhighlight lang="Bash">
 
<syntaxhighlight lang="Bash">
 
sudo yum --enablerepo=epel install mock python-ctypes glances
 
sudo yum --enablerepo=epel install mock python-ctypes glances
sudo yum install make rpm-build wget
+
sudo yum install make rpm-build rpm-sign wget
 
</syntaxhighlight>
 
</syntaxhighlight>
 
Add yourself to the 'mock' group that will have now been created
 
Add yourself to the 'mock' group that will have now been created
Line 124: Line 138:  
</syntaxhighlight>
 
</syntaxhighlight>
   −
The mock package creates an /etc/mock directory with configs for various OS versions (mostly Fedoras). dani has provided working configurations for SME Server here http://mirror.canada.pialasse.com/contribs/dani/mock/  
+
The mock package creates an /etc/mock directory with configs for various OS versions (mostly Fedoras). dani has provided working configurations for SME Server here http://mirror.contribs.org/contribs/dani/mock/  
    
Copy all the .cfg files into /etc/mock including overwriting the site-defaults.cfg
 
Copy all the .cfg files into /etc/mock including overwriting the site-defaults.cfg
Line 132: Line 146:  
  [root@buildcos9 mock]# rm site-defaults.cfg
 
  [root@buildcos9 mock]# rm site-defaults.cfg
   −
  wget http://mirror.canada.pialasse.com/contribs/dani/mock/site-defaults.cfg
+
  wget http://mirror.contribs.org/contribs/dani/mock/site-defaults.cfg
 
+
  wget http://mirror.contribs.org/contribs/dani/mock/smeserver-8-i386-base.cfg
  wget http://mirror.canada.pialasse.com/contribs/dani/mock/smeserver-8-i386-base.cfg
+
  wget http://mirror.contribs.org/contribs/dani/mock/smeserver-8-i386-iso.cfg
  wget http://mirror.canada.pialasse.com/contribs/dani/mock/smeserver-8-i386-iso.cfg
+
  wget http://mirror.contribs.org/contribs/dani/mock/smeserver-8-x86_64-base.cfg
  wget http://mirror.canada.pialasse.com/contribs/dani/mock/smeserver-8-x86_64-base.cfg
+
  wget http://mirror.contribs.org/contribs/dani/mock/smeserver-8-x86_64-iso.cfg
  wget http://mirror.canada.pialasse.com/contribs/dani/mock/smeserver-8-x86_64-iso.cfg
+
  wget http://mirror.contribs.org/contribs/dani/mock/smeserver-9-i386-base.cfg
  wget http://mirror.canada.pialasse.com/contribs/dani/mock/smeserver-9-i386-base.cfg
+
  wget http://mirror.contribs.org/contribs/dani/mock/smeserver-9-i386-iso.cfg
  wget http://mirror.canada.pialasse.com/contribs/dani/mock/smeserver-9-i386-iso.cfg
+
  wget http://mirror.contribs.org/contribs/dani/mock/smeserver-9-x86_64-base.cfg
  wget http://mirror.canada.pialasse.com/contribs/dani/mock/smeserver-9-x86_64-base.cfg
+
  wget http://mirror.contribs.org/contribs/dani/mock/smeserver-9-x86_64-iso.cfg
  wget http://mirror.canada.pialasse.com/contribs/dani/mock/smeserver-9-x86_64-iso.cfg
+
wget http://mirror.contribs.org/contribs/dani/mock/smeserver-10-x86_64-base.cfg
    
* Change group ownership to mock:
 
* Change group ownership to mock:
 
  [root@buildcos9 mock]# chown root:mock /etc/mock/*
 
  [root@buildcos9 mock]# chown root:mock /etc/mock/*
   −
* workaround
+
* workaround (as of 11Oct2016 - this does not seem necessary - the required line is already in the cfg files - bjr)
 
if the tag 'sme' is not added  to the built package see [[bugzilla:8636]] and add <br />
 
if the tag 'sme' is not added  to the built package see [[bugzilla:8636]] and add <br />
   Line 175: Line 189:     
=====Perform a Build for sme9 64 bits from an SRPM=====
 
=====Perform a Build for sme9 64 bits from an SRPM=====
You will need an SRPM, for instance from http://mirror.canada.pialasse.com/releases/testing/9/smeupdates-testing/SRPMS/
+
You will need an SRPM, for instance from http://mirror.contribs.org/releases/testing/9/smeupdates-testing/SRPMS/
 
you can use '''wget''' to download it in your terminal
 
you can use '''wget''' to download it in your terminal
 
  # Rebuild the given source RPM within the chroot environment
 
  # Rebuild the given source RPM within the chroot environment
Line 198: Line 212:     
=====Perform a Build for sme8 64 bits from an SRPM=====
 
=====Perform a Build for sme8 64 bits from an SRPM=====
  [chris@build-system SRPMS]$ wget http://mirror.canada.pialasse.com/releases/8.0/smeupdates-testing/SRPMS/perl-CGI-FormMagick-0.92-23.el5.sme.src.rpm  
+
  [chris@build-system SRPMS]$ wget http://mirror.contribs.org/releases/8.0/smeupdates-testing/SRPMS/perl-CGI-FormMagick-0.92-23.el5.sme.src.rpm  
 
  [chris@build-system SRPMS]$ CONFIG=smeserver-8-x86_64-base
 
  [chris@build-system SRPMS]$ CONFIG=smeserver-8-x86_64-base
 
  [chris@build-system SRPMS] $ mock -r $CONFIG --rebuild ~/smeupdates-testing/SRPMS/perl-CGI-FormMagick-0.92-23.el5.sme.src.rpm
 
  [chris@build-system SRPMS] $ mock -r $CONFIG --rebuild ~/smeupdates-testing/SRPMS/perl-CGI-FormMagick-0.92-23.el5.sme.src.rpm
Line 217: Line 231:  
     SME Contribs - holding the source code for contribs (add-ons) for SME Server  
 
     SME Contribs - holding the source code for contribs (add-ons) for SME Server  
   −
Both repositories are organized by the package name under which they appear in the software installer in the server-manager (or yum).  please see [[CVS|CVS page]] for more specific informations}}
+
Both repositories are organized by the package name under which they appear in the software installer in the server-manager (or yum).  please see [[CVS|CVS page]] for more specific information}}
    
If this works, it is worth grabbing either CVS for one module, or the whole CVS tree using this : http://wiki.contribs.org/Simple_Package_Modification
 
If this works, it is worth grabbing either CVS for one module, or the whole CVS tree using this : http://wiki.contribs.org/Simple_Package_Modification
 
* Setup CVS to use ssh by creating /etc/profile.d/smebuild.sh with the following content
 
* Setup CVS to use ssh by creating /etc/profile.d/smebuild.sh with the following content
[chris@buildcos9 profile.d]$ sudo touch smebuild.sh
+
 
[chris@buildcos9 profile.d]$ nano smebuild.sh
   
  [chris@buildcos9 profile.d]$ sudo nano smebuild.sh
 
  [chris@buildcos9 profile.d]$ sudo nano smebuild.sh
[chris@buildcos9 profile.d]$ cat smebuild.sh
+
 
 +
Paste this:
    
  # Developer environment
 
  # Developer environment
Line 240: Line 254:     
* Check CVS account
 
* Check CVS account
You need top create an account on sourceforge, then get Shad to includ you in sme group + give access to Buildsys. Can be done later...Of course it is not an issue if you have not a cvs access like we will see below, you can retrieve package in mode anonymous.
+
You need top create an account on shell.koozali.org, then get an admin to include you in sme group + give access to Buildsys. Can be done later...Of course it is not an issue if you have not a cvs access like we will see below, you can retrieve package in mode anonymous.
   −
====Sourceforge access====
+
====KOOZALI CVS access====
This chapter is used only by developers who aim to be granted in write access to the source code on Sourceforge, you don't need it if you want to only make patch or modify code in your build environment. You can see [[Package_Modification]] for more informations.
+
This chapter is used only by developers who aim to be granted in write access to the source code on shell.koozali.org, you don't need it if you want to only make patch or modify code in your build environment. You can see [[Package_Modification]] for more information.
* SME Server code is stored in the CVS on  http://SourceForge.net. To be able to work on your code in the SME Server CVS repository you need an account on SourceForge. With this account the development team can give you access to the CVS repository. More information can be found here:
+
* SME Server code is stored in the CVS on  shell.koozali.org. To be able to work on your code in the SME Server CVS repository you need an account on Koozali.org. With this account the development team can give you access to the CVS repository.
[http://sourceforge.net/apps/trac/sourceforge/wiki/Register%20a%20user%20account Registering a User Account]
+
* After you have had your account created you can ask the development team to give you developer access to smecontribs. Create a bug in the Bug Tracker as usual.
[http://sourceforge.net/apps/trac/sourceforge/wiki/CVS CVS (Version Control for Source Code)]
  −
[http://sourceforge.net/apps/trac/sourceforge/wiki/SSH%20keys SSH Key Generation and Usage]
     −
* After you have created your SourceForge account you can ask the development team to give you developer access to smecontribs. Create a bug in the Bug Tracker as usual.
+
* If local username is different to koozali.org username edit ~/.ssh/config:
   −
* Links to manage your SSH keys on SourceForge may be found on the [http://sourceforge.net/account/services SourceForge Account Services page].
+
  Host  shell.koozali.org
 
+
  User  koozaliusername ''(without @shell.koozali.org)''
* If local username is different to sf.net username edit ~/.ssh/config:
+
  Host  shell.koozali.org
+
  User  koozaliusername ''(without @shell.koozali.org)''
  Host  smeserver.cvs.sourceforge.net
  −
  User  sfusername ''(without @shell.sf.net)''
  −
  Host  smecontribs.cvs.sourceforge.net
  −
  User  sfusername ''(without @shell.sf.net)''
      
* Don't forget to set the proper privileges on the file
 
* Don't forget to set the proper privileges on the file
 
   
 
   
 
  chmod 600 ~/.ssh/config
 
  chmod 600 ~/.ssh/config
 +
 +
the port 222 will need to be defined in ~/.ssh/config
 +
host shell.koozali.org
 +
port 222
 +
 +
you can also define there the rsa key you want to use...
 +
 +
If you have a number of different keys ssh/cvs may try and use the wrong one.
 +
 +
You can add the following to your ~/.ssh/config file to specify the correct key:
 +
 +
Host  shell.koozali.org
 +
User  koozaliusername
 +
IdentityFile ~/.ssh/my.private.key
    
====Using CVS - Getting source Code====
 
====Using CVS - Getting source Code====
Line 276: Line 298:  
'''CVS is used for maintaining code and packages.'''<br />
 
'''CVS is used for maintaining code and packages.'''<br />
   −
We first need to download (with CVS this is called retrieving) the code for the package to be modified from the SME Server CVS repository at SourceForge (we can also retrieve the CVS for the smecontribs tree).  
+
We first need to download (with CVS this is called retrieving) the code for the package to be modified from the SME Server CVS repository at Koozali.org (we can also retrieve the CVS for the smecontribs tree).  
 
Two cases with CVS:
 
Two cases with CVS:
   −
To be able to work on your code in the SME Server CVS repository you need an account on SourceForge.  If you do not have an account at CVS, retrieving is performed as an anonymous user and changes cannot be saved.  
+
To be able to work on your code in the SME Server CVS repository you need an account on Koozali.org.  If you do not have an account at CVS, retrieving is performed as an anonymous user and changes cannot be saved.  
    
===== Case 1 - Registered Users =====
 
===== Case 1 - Registered Users =====
 
- To retrieve a package or a full tree as a registered user, cd into a work directory and issue following commands:
 
- To retrieve a package or a full tree as a registered user, cd into a work directory and issue following commands:
 
* for smeserver
 
* for smeserver
  cvs -z3 -d:ext:smeserver.cvs.sourceforge.net:/cvsroot/smeserver co -P packagename [individual package]
+
  cvs -z3 -d:ext:shell.koozali.org:/cvs/smeserver co -P packagename [individual package]
  cvs -z3 -d:ext:smeserver.cvs.sourceforge.net:/cvsroot/smeserver co -P rpms [full tree]
+
  cvs -z3 -d:ext:shell.koozali.org:/cvs/smeserver co -P rpms [full tree]
 +
env CVS_RSH=ssh cvs -d:ext:YOURUSERNAME@shell.koozali.org:/cvs/smeserver checkout CVSROOT rpms common
 +
 
 
* for smecontribs
 
* for smecontribs
  cvs -z3 -d:ext:smeserver.cvs.sourceforge.net:/cvsroot/smecontribs co -P packagename [individual package]
+
  cvs -z3 -d:ext:shell.koozali.org:/cvs/smecontribs co -P packagename [individual package]
  cvs -z3 -d:ext:smeserver.cvs.sourceforge.net:/cvsroot/smecontribs co -P rpms [full tree]
+
  cvs -z3 -d:ext:shell.koozali.org:/cvs/smecontribs co -P rpms [full tree]
 +
env CVS_RSH=ssh cvs -d:ext:YOURUSERNAME@shell.koozali.org:/cvs/smecontribs checkout CVSROOT rpms common
    
===== Case 2 - Anonymous users =====
 
===== Case 2 - Anonymous users =====
 
- To retrieve a package or a full tree as an anonymous user, cd into a work directory and issue following commands:
 
- To retrieve a package or a full tree as an anonymous user, cd into a work directory and issue following commands:
 
* for smeserver
 
* for smeserver
  cvs -z3 -d:pserver:anonymous@smeserver.cvs.sourceforge.net:/cvsroot/smeserver checkout -P packagename [individual package]
+
  cvs -z3 -d:pserver:anonymous@shell.koozali.org:/cvs/smeserver checkout -P packagename [individual package]
  cvs -z3 -d:pserver:anonymous@smeserver.cvs.sourceforge.net:/cvsroot/smeserver co -P rpms [full tree]
+
  cvs -z3 -d:pserver:anonymous@shell.koozali.org:/cvs/smeserver co -P rpms [full tree]
    
* for smecontribs
 
* for smecontribs
  cvs -z3 -d:pserver:anonymous@smeserver.cvs.sourceforge.net:/cvsroot/smecontribs checkout -P packagename [individual package]
+
  cvs -z3 -d:pserver:anonymous@shell.koozali.org:/cvs/smecontribs checkout -P packagename [individual package]
  cvs -z3 -d:pserver:anonymous@smeserver.cvs.sourceforge.net:/cvsroot/smecontribs co -P rpms [full tree]
+
  cvs -z3 -d:pserver:anonymous@shell.koozali.org:/cvs/smecontribs co -P rpms [full tree]
    
Note: If at a later stage you obtain a valid account with CVS, you will need to edit ALL packages /CVS/Root in order to save your work in CVS. As an example, for package "packagename", CVS/Root will need to be edited to be exactly as shown below:
 
Note: If at a later stage you obtain a valid account with CVS, you will need to edit ALL packages /CVS/Root in order to save your work in CVS. As an example, for package "packagename", CVS/Root will need to be edited to be exactly as shown below:
 
  [chris@buildcos9 work]$ cat packagename/CVS/Root
 
  [chris@buildcos9 work]$ cat packagename/CVS/Root
  :ext:smeserver.cvs.sourceforge.net:/cvsroot/smeserver
+
  :ext:shell.koozali.org:/cvs/smeserver
    
ok - CVS/Root uses 'ext' which should be SSH access
 
ok - CVS/Root uses 'ext' which should be SSH access
 +
the port 222 will need to be defined in ~/.ssh/config
 +
host shell.koozali.org
 +
port 222
 +
you can also define there the rsa key you want to use...
    
==== Package modification ====
 
==== Package modification ====
Line 318: Line 347:  
  [chris@buildcos9 ~]$ mkdir smeserver
 
  [chris@buildcos9 ~]$ mkdir smeserver
 
  [chris@buildcos9 ~]$ cd smeserver
 
  [chris@buildcos9 ~]$ cd smeserver
  [chris@buildcos9 work]$ cvs -z3 -d:ext:smeserver.cvs.sourceforge.net:/cvsroot/smeserver co -P packagename
+
  [chris@buildcos9 work]$ cvs -z3 -d:ext:shell.koozali.org:/cvs/smeserver co -P packagename
    
or for smecontribs
 
or for smecontribs
Line 324: Line 353:  
  [chris@buildcos9 ~]$ mkdir smecontribs
 
  [chris@buildcos9 ~]$ mkdir smecontribs
 
  [chris@buildcos9 ~]$ cd smecontribs
 
  [chris@buildcos9 ~]$ cd smecontribs
  [chris@buildcos9 work]$ cvs -z3 -d:ext:smeserver.cvs.sourceforge.net:/cvsroot/smecontribs co -P packagename
+
  [chris@buildcos9 work]$ cvs -z3 -d:ext:shell.koozali.org:/cvs/smecontribs co -P packagename
    
* To refresh run the following from the rpms directory, or any lower directory with a CVS dir.
 
* To refresh run the following from the rpms directory, or any lower directory with a CVS dir.
Line 358: Line 387:  
  Patch3: packagename-1.2.3-my_changes_description
 
  Patch3: packagename-1.2.3-my_changes_description
   −
* Add patch version to the %setup section bot forgetting to increase number by 1:
+
* Add patch version to the %setup section not forgetting to increase number by 1:
 
  %patch3 -p1
 
  %patch3 -p1
   Line 427: Line 456:  
  $ rpm -qpl package_name.noarch.rpm |grep perl
 
  $ rpm -qpl package_name.noarch.rpm |grep perl
   −
===== Finalising in CVS and builsys =====
+
===== Finalising in CVS and buildsys =====
 
* Add the patch file to cvs:
 
* Add the patch file to cvs:
  [chris@buildcos9 sme9]$ cvs add packagename-1.2.3-your_changes-description
+
  [chris@buildcos9 sme9]$ cvs add packagename-1.2.3-your_changes-description.patch
 
  cvs add: scheduling file `packagename-1.2.3-your_changes-description' for addition
 
  cvs add: scheduling file `packagename-1.2.3-your_changes-description' for addition
 
  cvs add: use 'cvs commit' to add this file permanently
 
  cvs add: use 'cvs commit' to add this file permanently
Line 618: Line 647:  
* there don't seem to be any hooks in mock to allow you to sign packages you've built, so if you do want signed packages you need to sign them afterwards via a rpm --resign $RPMS.
 
* there don't seem to be any hooks in mock to allow you to sign packages you've built, so if you do want signed packages you need to sign them afterwards via a rpm --resign $RPMS.
 
* If you get an error message 'create archive failed cpio: Bad magic' then try 'yum update' as this appears to be a known problem on COS6.
 
* If you get an error message 'create archive failed cpio: Bad magic' then try 'yum update' as this appears to be a known problem on COS6.
      
[[Category:SME Server Development Framework]]
 
[[Category:SME Server Development Framework]]
 
[[Category:Development Tools]]
 
[[Category:Development Tools]]
 
[[Category:SME9-Development]]
 
[[Category:SME9-Development]]

Navigation menu