Changes

From SME Server
Jump to navigationJump to search
10,292 bytes removed ,  07:45, 15 February 2013
redirect to Alpha ISO instructions
Line 1: Line 1: −
{{Tip box|Please only use a virtual machine to test this.Try to follow what others have done and repeat it. Make any notes yourself and post your findings.}}
  −
   
Back to [[SME_Server_9.0_Development|SME Server 9.0 Development]]
 
Back to [[SME_Server_9.0_Development|SME Server 9.0 Development]]
   −
__TOC__
+
These instructions are now out of date.  Please see [[SME9Alpha | SME9Alpha]] instead.
== SME 9, based on CentOS 6 ==
  −
An overview of related SME9 development pages can be found [[:Category:SME9-Development|here]].
  −
 
  −
 
  −
=== Prerequisites ===
  −
* VIrtual machine (Vmware, Parallels or Virtualbox)
  −
* Centos Minimal 64-bit architecture. 32-bit may follow later
  −
* [[Setting_up_RPM_Building_for_SME_Server|Setting up a RPM Building environment]]
  −
 
  −
=== User Feedback ===
  −
Unstructured user feedback can be noted here: [[SME9DEV_user_feedback|SME9DEV user feedback]]. Issues that require developers attention should be logged in our Bug Tracker. (See below)
  −
 
  −
 
  −
=== Bugs ===
  −
[http://bugs.contribs.org/bugs/buglist.cgi?product=SME%20Server%209.X&component=Cleanup&resolution=--- Bug Tracker]
  −
[http://wiki.contribs.org/SME9BuildQueue#SME_9_Error_list_and_affected_packages SME 9 error list]
  −
 
  −
=== Considerations ===
  −
* Primary and only goal for now is the transition of SME Server based on CentOS 5.8 to SME Server based on CentOS6.3
  −
* SysVinit is no longer the default with the release of RHEL6, beyond RHEL6 systemd will be used
  −
* perl has a new location of the filesystem. New: /usr/share/perl5/vendor_perl instead Old: /usr/lib/perl5/site_perl/
  −
* perl version 5.8.8 is the new default version on RHEL6. This requires a review of all the perl module rpms which are specific for perl 5.8.5
  −
 
  −
== Installing CentOS 6 minimal ==
  −
First a few notes on CentOS 6 minimal, which is a bare bones install with very little on board. You can download a copy from one of the CentOS mirrors [http://www.centos.org/modules/tinycontent/index.php?id=30 here]
  −
 
  −
* As per above note, only use Virtual Machine for testing purposes. A good free VM package can be obtained [https://www.virtualbox.org/wiki/Downloads here]
  −
* You might want to note down as much as possible so you yourself and others can reproduce the actions
  −
* Don't use yum with the '-y' flag (install/upgrade without further user interaction) when using the yum install/upgrade commands. (beware copy/paste yum commands)
  −
* you might want to note down all packages listed by yum to be installed/upgraded AND their dependencies
  −
* Make regular snapshots of your Virtual Machine and describe them specifically. At least when you've reached an important milestone for yourself
  −
 
  −
 
  −
==== Installing the ISO ====
  −
* Just install a minimal el6 installation (I just installed a few utilities like htop, screen, rsync, vim, openssh-clients mc etc…). You can use either the DVD, the minimal CD install, a net install with PXE, it's up to you
  −
* wellsi: I have used CentOS-6.3-x86_64-minimal.iso
  −
 
  −
 
  −
==== Enable networking ====
  −
Each boot you have to start the network etc etc. I decided it was better with the minimal install and touch as little as possible - if I could then get SME packages installed I could then use that to configure networking later.
  −
 
  −
To start the networking
  −
<syntaxhighlight lang="Bash">
  −
./etc/sysconfig/network-scripts/ifup-eth eth0
  −
</syntaxhighlight>
  −
 
  −
or
  −
<syntaxhighlight lang="Bash">
  −
dhclient eth0
  −
</syntaxhighlight>
  −
 
  −
<div class="mw-collapsible mw-collapsed" data-collapsetext="Collapse" data-expandtext="More on networking">
  −
or if you want to assign a specific IP address (e.g. 192.168.1.2).
  −
<syntaxhighlight lang="Bash">
  −
ifconfig eth0 192.168.1.2
  −
echo "nameserver 192.168.1.254" >> /etc/resolv.conf
  −
route add default gw 192.168.1.254 eth0
  −
</syntaxhighlight>
  −
 
  −
To make your changes permanent you will need to edit the configuration file to make it active on boot. There is only the vi text editor, you can also install nano.
  −
<syntaxhighlight lang="Bash">
  −
yum install nano
  −
nano /etc/sysconfig/network-scripts/ifcfg-eth0
  −
</syntaxhighlight>
  −
and set ONBOOT=”YES”
  −
</div>
  −
 
  −
==== Enable SSH ====
  −
SSH is present but is disabled at this stage. To enable ssh issue:
  −
<syntaxhighlight lang="Bash">
  −
service sshd start
  −
</syntaxhighlight>
  −
 
  −
 
  −
==== Disable / Remove SELinux ====
  −
It will be easier to see what's going on (and turn off selinux at kernel level, just to be sure)
  −
<syntaxhighlight lang="Bash">
  −
sed -i -e 's/rhgb quiet/selinux=0/g' /boot/grub/grub.conf
  −
 
  −
sed -i -e 's/SELINUX=.*/SELINUX=disabled/g' /etc/selinux/config
  −
 
  −
yum remove selinux-policy-targeted
  −
 
  −
setenforce 0
  −
</syntaxhighlight>
  −
 
  −
== Configure basic requirements ==
  −
==== Configure SME9 repositories ====
  −
 
  −
See the following bugs tracking issues with repositories:
  −
* [[bugzilla:7294|Bug #7294: rpms that still need to be rebuilt or sourced for the SME9 repositories]]
  −
* [[bugzilla:7298|Bug #7298: Import perl-Unix-ConfigFile from rpmforge]]
  −
* [[bugzilla:7292|Bug #7292: more rpms in the SME8 repositories that have a lower version in our SME9 repositories]]
  −
* [[bugzilla:7305|Bug #7305: smeserver-yum doesn't provide the /etc/yum.smerepos.d dir]]
  −
 
  −
<syntaxhighlight lang="Bash">
  −
yum install wget
  −
</syntaxhighlight>
  −
<syntaxhighlight lang="Bash">
  −
mkdir /tmp/repo.bak
  −
mv /etc/yum.repos.d/*.repo /tmp/repo.bak/
  −
wget -O /etc/yum.repos.d/sme9.repo http://bugs.contribs.org/attachment.cgi?id=3652
  −
</syntaxhighlight>
  −
 
  −
==== Import needed GPG Keys ====
  −
<syntaxhighlight lang="Bash">
  −
rpm --import http://sme-mirror.firewall-services.com/releases/8/smeos/x86_64/RPM-GPG-KEY-SMEServer
  −
rpm --import http://apt.sw.be/RPM-GPG-KEY.dag.txt
  −
rpm --import https://fedoraproject.org/static/217521F6.txt
  −
rpm --import http://mirror.centos.org/centos/RPM-GPG-KEY-CentOS-5
  −
rpm --import http://www.salstar.sk/pub/yum/keys/RPM-GPG-KEY-Fedora-Pre-Extras
  −
</syntaxhighlight>
  −
 
  −
==== Clean yum cache ====
  −
<syntaxhighlight lang="Bash">
  −
yum --enablerepo=* clean all
  −
</syntaxhighlight>
  −
 
  −
==== Install e-smith and smeserver packages & update all packages====
  −
Now, you should be ready to install all the e-smith and smeserver packages (and their dependencies), plus the rest of the rpms that aren't required by a smeserver- or e-smith- rpm, but were installed on SME8 [[bugzilla:7311]]. This should pull about 500 packages to install, and 14 to update, and then you can do 'yum upgrade' to upgrade the remaining CentOS packages.  Some other notes on this in [[bugzilla:7240]]
  −
 
  −
<pre style="white-space:normal;">
  −
yum --disablerepo=* --enablerepo=smeupdates9,smeupdates-testing9,smeos8,smeupdates8 install e-smith\* smeserver\* aspell aspell-en at audit-libs-python autoconf automake bc bind-libs bind-utils cronie cronie-anacron crontabs cyrus-sasl-md5 dhcp dosfstools ed eject elfutils elfutils-libs fetchmail ftp gettext glib gpm hesiod hmaccalc imake iptraf iptstate isdn4k-utils libXdmcp libgomp libselinux-python libsmbclient libsysfs libxml2-python lm_sensors lockdev lsof lvm2 m2crypto man mcstrans minicom mkbootdisk mlocate mod_ssl mtools mt-st mutt neon net-snmp net-snmp-utils openldap-servers patch pcmciautils postgresql-libs pyxf86config rpm-build rp-pppoe setserial strace sudo sysfsutils syslinux tcpdump telnet time tmpwatch traceroute unzip usbutils usermode vim-common vim-enhanced wget wodim xz zip zlib php-pear-Net-URL perl-Compress-Raw-Bzip2 perl-IO-Compress-Bzip2 rsync tnef freeradius-ldap
  −
</pre>
  −
 
  −
<pre>
  −
yum upgrade
  −
</pre>
  −
 
  −
See the following bugs:
  −
*[[bugzilla:7233|Bug #7233: e-smith-ldap should require openldap-servers]]
  −
*[[bugzilla:7252|Bug #7252: e-smith-radiusd should require freeradius-ldap]]
  −
*[[bugzilla:7234|Bug #7234: e-smith-apache should require mod_ssl]]
  −
*[[bugzilla:7297|Bug #7297: e-smith-hosts should require dhcp]]
  −
 
  −
 
  −
==== Move some perl modules ====
  −
As [[bugzilla:7223]] is now fixed this step should not be needed, check if there are any remaining perl modules with the following. If it still shows some .pm files then click on 'More on perl modules'
  −
<syntaxhighlight lang="Bash">
  −
ls -ltR /usr/lib/perl5/site_perl/esmith/*
  −
</syntaxhighlight>
  −
 
  −
<div class="mw-collapsible mw-collapsed" data-collapsetext="Collapse" data-expandtext="More on perl modules">
  −
We need to copy some perl modules to a new directory, because @INC has changed in EL6: [[bugzilla:7223]]
  −
<syntaxhighlight lang="Bash">
  −
cp -a /usr/lib/perl5/site_perl/esmith/* /usr/share/perl5/vendor_perl/esmith
  −
</syntaxhighlight>
  −
</div>
  −
 
  −
 
  −
==== Run post-upgrade ====
  −
We can now try to post-upgrade
  −
<syntaxhighlight lang="Bash">
  −
/sbin/e-smith/signal-event post-upgrade
  −
/sbin/e-smith/signal-event reboot
  −
</syntaxhighlight>
  −
 
  −
== Look for things to fix & Report bugs/problems ==
  −
 
  −
To configure the server further, log in as root at then type 'console' and select 'configure this server'.
  −
 
  −
If you have followed these steps and you are up to date with 'yum upgrade', go ahead and look for problems, and report them to the bug tracker.  Currently there are many issues, but lots have been reported and fixed already, so report issues you find right away.
  −
 
  −
* [http://bugs.contribs.org/report.cgi?x_axis_field=bug_status&y_axis_field=target_milestone&product=SME+Server+9.X&format=table&action=wrap SME 9 Bug Report Matrix]
  −
* Open a new bug report - http://bugs.contribs.org/enter_bug.cgi
  −
 
  −
Some ideas for things to look for:
  −
* Services not starting
  −
* Config files (templates) that need changes, especially if the major version of the package has changed
  −
* what el5 packages are still installed that need working on? To check do
  −
<pre>
  −
rpm -qa |grep el5
  −
</pre>
  −
*
  −
*
  −
*
  −
* add more generic ideas here....specific issues to the bugtracker please
  −
 
  −
== Discussion, help and share ==
  −
* Please consult/subscribe to the devs list for more information. [http://lists.contribs.org/mailman/listinfo/devinfo devinfo mailinglist] and in particular all threads starting with " SME on CentOS 6"
  −
* There is a IRC channel where people who are interested in this effort 'hang out'. You're most welcome to drop by and/or join. It's free! ;-)
  −
** You do not have to install anything to pay the channel a visit. All you need is a nice nickname and right click [http://webchat.freenode.net?channels=SME_server&uio=Mj10cnVlJjk9dHJ1ZSYxMT03Mg13 here] to open the channel in a new browser window or tab.
  −
 
  −
 
  −
== Resources and references ==
  −
 
  −
==== Setting up a RPM Building environment under CentOS ====
  −
* [[Simple_Package_Modification|Simplest way to develop patches to submit]]
  −
* [[Setting_up_RPM_Building_for_SME_Server|Building using Mock]]
  −
* [[Package_Modification|Simple Package Modification]]
  −
* [http://wiki.centos.org/HowTos/SetupRpmBuildEnvironment On the CentOS wiki]
  −
* [http://docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html/RPM_Guide/index.html From the Fedora project]
  −
 
      
<noinclude>[[Category:Howto]][[Category:SME9-Development]]
 
<noinclude>[[Category:Howto]][[Category:SME9-Development]]

Navigation menu