Changes

Jump to navigation Jump to search
m
Line 18: Line 18:     
== SME Server 9.0 on top of Scientific Linux ==
 
== SME Server 9.0 on top of Scientific Linux ==
The installation instructions of SME Server functionality are based on minimal installation of Scientific Linux 6.3 64-bit and SME Server 9.0alpha1 repository. Please use a virtual environment to test your results. Virtual environments may include e.g. VirtualBox (free), VMWare, KVM or Xen.
+
The installation instructions of SME Server functionality are based on minimal installation of Scientific Linux 6.5 64-bit and SME Server 9.0 repository. Please use a virtual environment to test your results. Virtual environments may include e.g. VirtualBox (free), VMWare, KVM or Xen.
       
==== Install SL minimal ====
 
==== Install SL minimal ====
SME Server functionality is only tested with a minimal install of Scientific Linux. To be able to install 'SL minimal' one must use the DVD install ISO. Other available downloads like the LiveCD etc. do not have the option to install 'SL minimal'.
+
SME Server functionality is only tested with a minimal install of Scientific Linux. To install 'SL minimal' one can use the boot.iso. A internet connection is required. The URL required for performing a net install must point to the /pub/scientific-linux/6.5/x86_64/os/ diretory of the mirror you use.
   −
You can download the SL DVD install CD from either [http://ftp.scientificlinux.org/linux/scientific/6.3/x86_64/iso/SL-63-x86_64-2012-08-02-Install-DVD.iso here], [http://ftp1.scientificlinux.org/linux/scientific/6.3/x86_64/iso/SL-63-x86_64-2012-08-02-Install-DVD.iso here] or [ftp://ftp.scientificlinux.org/linux/scientific/6.3/x86_64/iso/SL-63-x86_64-2012-08-02-Install-DVD.iso here]. Install SL minimal in your virtual environment which should have at least:
+
You can download the SL boot.iso from one of the many scientific mirrors. Install SL minimal in your virtual environment which should have at least:
    
* 1Gb RAM memory
 
* 1Gb RAM memory
Line 32: Line 32:       −
When using the SL install DVD you have the option to select what to install. Please select 'minimal' and leave all other options as per their defaults.
+
Boot the boot.iso and follow instruction. Once the graphical installer starts, select 'minimal' and leave all other options as per their defaults.
    
Once the installation has finished, please reboot and continue with enabling networking and SSH.
 
Once the installation has finished, please reboot and continue with enabling networking and SSH.
 +
    
==== Enable networking and SSH ====
 
==== Enable networking and SSH ====
Login as root with the password what was provided at installation time. To enable networking please issue:
+
This step may not be required. Please check after login with ifconfig your networking configuration. Otherwise, login as root with the password what was provided at installation time. To enable networking please issue:
 
  ifup eth0
 
  ifup eth0
   Line 43: Line 44:  
  service sshd start
 
  service sshd start
   −
SSH will now be enabled. Please log in remotely via SSH and further instructions are based on the fact that you are remotely logged. Specifically for Cut and Paste operations.
+
SSH will now be enabled. Please log in remotely via SSH and further instructions are based on the fact that you are remotely logged in via ssh. Specifically for Cut and Paste operations.
 +
 
 +
 
 +
==== Install nano and wget ====
 +
If you are not familiar with vi or vim, you can install the nano editor. This page assumes that you have installed nano. Please install nano and wget as follows by issuing as root on the console:
 +
yum install nano wget
    
==== Disable SELinux ====
 
==== Disable SELinux ====
SELinux is enabled by default. We want to disable it for there are a few services (httpd) that get blocked by SELinux. To check the status of SELinux you can enter the command:
+
SELinux is enabled by default. We want to disable it for there are a few services (e.g. httpd) that get blocked by SELinux. To check the status of SELinux you can enter the command:
 
  getenforce
 
  getenforce
   Line 54: Line 60:  
  yum remove selinux-policy-targeted
 
  yum remove selinux-policy-targeted
   −
==== Merge repo's SME and SL ====
  −
To be able to download the required packages we need to add the SME Server repo's. The auto-selected (closest) mirror may not be the fastest, and you may want to hash out the 'mirrorlist=' line entries and replace them with 'baseURL=' with a repo location of your choice. Please see this the [http://mirror.contribs.org/mirrors/ download locations overview].
     −
  TBA
+
==== Update SL ====
 +
Now is a good time to update your SL installation with the latest (security) updates:
 +
  yum update
   −
==== Yum install ====
+
==== Add SME Server repo ====
To make sure that all dependecies required for SME Server are met, we will disable the sl repositories for now, and will do a yum upgrade after this initial upgrade.  
+
To be able to download the required packages we need to add the SME Server repo:
 +
nano -w /etc/yum.repos.d/smeos9.repo
   −
<nowiki>
+
and paste the following into it:
yum 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 --exclude=centos*,smeserver-release --disablerepo=sl* --nogpg
  −
</nowiki>
     −
This will result in the following summary. The numbers may vary depending on the changes in the repositories.
+
[smeos9]
  Transaction Summary
+
enabled=1
  Install    497 Package(s)
+
MirrorList=http://mirrorlist.contribs.org/mirrorlist/smeos-9
  Upgrade      19 Package(s)
+
  name=SME Server9 - os
  Total download size: 226 M
+
  enablegroups=1
 +
  gpgcheck=1
 +
  includepkgs = e-smith\* smeserver\* *.sme.* clamav* clamd* *dar mod_authnz* mhash tbb perl-* htop proftpd php-pear-* GeoIP mod_auth_tkt radiusclient-ng nut-client nut pyzor oidentd rssh pam_abl clamav par2cmdline DCC wv checkpassword pam pv razor-agents clam-db initscripts checkpassword-pam
   −
==== Yum upgrade ====
  −
After the initial yum install we need to upgrade to the latest versions available in the repositories.
     −
  yum upgrade --nogpg
+
Now we can install the required packages from the repo's. The ''includepkgs'' line in the SME Server repo file ensure that '''only''' the required packages for SME Server will come from the SME repo's, and all others from the sl repo's.
 +
  yum install e-smith\* smeserver\* *.sme.* initscripts --exclude=smeserver-release*,*86 --nogpg
    +
This will result in the following summary. The numbers may vary depending on the changes in the repositories.
 +
Transaction Summary
 +
Install    402 Package(s)
 +
Upgrade      1 Package(s)
 +
Total size: 232 M
   −
This will result in the below summary. The numbers may vary depending on the changes in the repositories.
+
After yum is finished and all packages are installed, we can remove the temporary /etc/yum.repos.d/smeos9.repo file:
  Transaction Summary
+
  rm -f /etc/yum.repos.d/smeos9.repo
Install      1 Package(s)
  −
Upgrade      38 Package(s)
  −
Total size: 67 M
      
==== Post-upgrade/reboot ====
 
==== Post-upgrade/reboot ====
Line 94: Line 102:  
== First use ==
 
== First use ==
 
==== Set root password ====
 
==== Set root password ====
After the first boot, an new root (admin) password will be asked. This may be the same as you used for the initial installation of SL or you can set a new one. After setting the root password, SME Server will configure additional settings and automatically reboot.
+
After the first boot, there is the opportunity to restore from a backup and a new root (admin) password will be asked. This may be the same as you used for the initial installation of SL or you can set a new one. After setting the root password, SME Server will configure additional settings and automatically reboot.
 +
 
 +
 
 +
 
 +
==== Configuration ====
 +
When the system has rebooted, it is ready for SME Server configuration of network and services settings. To start this process, please login as root and type:
 +
console
 +
 
 +
and select 'configure this server'. After configuration, the server will reboot itself, re-configure itself based on the user choices and is in full operational mode ready for full use.
    +
After the reboot, you can access the server-manager (https://your_ip/server-manager) and login as admin and the root password. In server-manager one can enable ssh and set various ssh options.
   −
==== Reset MySQL root password ====
  −
SME Server uses a secure random password for the MySQL root user. A new MySQL root password has to be generated to overwrite the SL root MySQL password. There should be no reason to change or use the MySQL password, so we '''strongly''' advise you '''never''' to change or use the MySQL root password, even though many how-to's or (web)applications will tell you they 'require' this'. You can grant permissions to a (new) MySQL user for a certain database as system root. How to do this is explained [[MySQL#Resetting_the_MySQL_root_password|here]]. As root issue the following commands:
  −
cd /var/service/mysqld
  −
sv d .
  −
expand-template /root/.my.cnf
  −
expand-template /var/service/mysqld/set.password
  −
/usr/libexec/mysqld --bootstrap --user=mysql --skip-grant-tables < ./set.password
  −
sv u .
      
==== Adjust yum repositories ====
 
==== Adjust yum repositories ====
 
By default SME Server assumes it has CentOS as base linux system, In this case we use Scientific Linux, so we have to remove the CentOS specific repo's and add the SL repo's.
 
By default SME Server assumes it has CentOS as base linux system, In this case we use Scientific Linux, so we have to remove the CentOS specific repo's and add the SL repo's.
 +
 +
NOTES:
 +
* The default SME Server repo's are part of sme-base
 +
* The default (CentOS) repo's get re-initialized on yum-update
 +
* so..... with an update of sme-base or a post-install, the repo's turn back to SME defaults
    
To remove the CentOS specific repo's issue the following commands as root:
 
To remove the CentOS specific repo's issue the following commands as root:
Line 115: Line 129:  
  db yum_repositories delete contrib
 
  db yum_repositories delete contrib
 
  db yum_repositories delete extras
 
  db yum_repositories delete extras
 +
db yum_repositories delete fasttrack
 +
db yum_repositories delete updates
 +
and update the yum repositories db
 +
signal-event yum-modify
   −
and add SL repo's the 'SME Server way'
  −
TBA
     −
and update and activate the revised yum repo's configuration with the following command:
+
Now we need to configure the SME repo's to *only* include SME Specific packages or packages that are not available in the SL repo's, and we need to configure the SL repo's the SME Server way.
signal-event yum-modify
      +
includepkgs = e-smith\* smeserver\* *.sme.* clamav* clamd* *dar mod_authnz* mhash tbb perl-* htop proftpd php-pear-* GeoIP mod_auth_tkt radiusclient-ng nut-client nut pyzor oidentd rssh pam_abl clamav par2cmdline DCC wv checkpassword pam pv razor-agents clam-db initscripts checkpassword-pam
      −
==== Configuration ====
+
Add SL repo's the 'SME Server way'
When the system has rebooted, it is ready for SME Server configuration of network and services settings. To start this process, please login as root and type:
+
  TBA
  console
     −
and select 'configure this server'. After configuration, the server will reboot itself, re-configure itself based on the user choices and is in full operational mode ready for full use.
+
and update and activate the revised yum repo's configuration with the following command:
 +
signal-event yum-modify
    
== Current status ==
 
== Current status ==
The above instructions should have brought you 'on par' with the current developments [[SME_Server_9.0_Development|here]].
+
The above instructions should have brought you 'on par' with SME Server 9.0

Navigation menu