Difference between revisions of "Centos2sme"

From SME Server
Jump to navigationJump to search
 
(9 intermediate revisions by 2 users not shown)
Line 21: Line 21:
 
[[User:Unnillennium|Jean-Philippe Pialasse]]  
 
[[User:Unnillennium|Jean-Philippe Pialasse]]  
  
−
=== Version ===
+
===Version===
 
<!-- keep this first element as is, you can add some if needed -->
 
<!-- keep this first element as is, you can add some if needed -->
 
{{#smeversion: {{#var:smecontribname}} }}
 
{{#smeversion: {{#var:smecontribname}} }}
  
−
=== Description ===
+
===Description===
 
This allow you to install SME on a minimal CentOS. All you need is network enabled to install the rpm.   
 
This allow you to install SME on a minimal CentOS. All you need is network enabled to install the rpm.   
  
Line 42: Line 42:
 
SSH access is open, with root login allowed, but only RSA SSH key allowed.
 
SSH access is open, with root login allowed, but only RSA SSH key allowed.
  
−
System restoration using usb disk is disable to avoid locking you out on reboot, as it is considered you might not have a KVM access, and only ssh access.
+
Be aware the first reboot might take awhile because of quota check...
  
−
The following can be performed once install/reboot is complete to initiate restore of a backup as per default behaviour on first reboot.  
+
===Installation===
 +
You may have to install wget
 +
  yum install wget
  
−
config delete PasswordSet
+
Download the file and install (you might check the last available version in https://mirror.koozali.org/releases/10/smecontribs/x86_64/RPMS/ to adapte the following line)
−
  config setprop bootstrap-console Run Yes
+
  wget https://mirror.koozali.org/releases/10/smecontribs/x86_64/RPMS/smeserver-centos2sme-6.9.1-13.el7.sme.noarch.rpm
−
signal-event reboot
 
  
−
Be aware the first reboot might take awhile because of quota check...
+
yum install smeserver-centos2sme-6.9.1-13.el7.sme.noarch.rpm
  
−
=== Installation ===
+
=== SME Server Conversion ===
−
You may have to install wget
+
We assume you were able to connect to your remote CentOS 7 server using SSH and you already have added your own public key to /root/.ssh/authorized_key. Alternatively you have a virtual or IP KVM access to your server.
−
yum install wget
 
  
−
Download the file and install (you might check the last available version in https://mirror.koozali.org/releases/9/smecontribs/x86_64/RPMS/ to adapte the following line)
+
==== Preparation ====
−
  wget https://mirror.koozali.org/releases/9/smecontribs/x86_64/RPMS/smeserver-centos2sme-6.9.1-5.el6.sme.noarch.rpm
+
get the needed tools
 +
yum install -y net-tools
 +
Get the current network information of your server
 +
# ifconfig
 +
eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
 +
        inet NY.IP.IS.HE.RE  netmask MY.MASK.IS.HE.RE  broadcast Z.Z.Z.Z
 +
Get the default gateway :
 +
# route -n
 +
Destination      Gateway          Genmask            Indic Metric Ref    Use Iface
 +
  0.0.0.0          MY.GATE.WAY.IP  0.0.0.0            UG    0      0        0 eth0
 +
MY.NET.WORK.0    0.0.0.0          MY.MASK.IS.HE.RE  U    0      0        0 eth0
  
−
yum install smeserver-centos2sme-6.9.1-5.el6.sme.noarch.rpm
+
You might also want to get the IP /network you are connecting from, to add latter to ValidFrom to access to the server-manager.
  
 +
==== Script Usage ====
 
Launch the script
 
Launch the script
 
  centos2sme
 
  centos2sme
Line 74: Line 85:
 
Rerun install script
 
Rerun install script
 
  # centos2sme
 
  # centos2sme
 +
Final Steps
 +
 +
At the end of the script, you will get to the bootstrap console to configure your server. This is where you need the information about your network.
 +
 +
Then you will be offered to  enter a valid Network you want to authorize access to your server-manager.
 +
 +
At the end you will either need to reboot to get all your services running, or use console to restore a backup.
  
−
=== Uninstall ===
+
===Uninstall===
 
  yum remove {{#var:smecontribname}}  
 
  yum remove {{#var:smecontribname}}  
  
−
=== Bugs ===
+
=== Other Information ===
 +
==== using restore on reboot ====
 +
Usual System restoration on boot using usb disk is disable to avoid locking you out on reboot, as it is considered you might not have a KVM access, and only ssh access.
 +
 
 +
IF you HAVE KVM access, then the following can be performed once install/reboot is complete to initiate restore of a backup as per default behaviour on first reboot. 
 +
 
 +
config delete PasswordSet
 +
config setprop bootstrap-console Run Yes
 +
signal-event reboot
 +
 
 +
DO this only if you have kvm access, Remember you still can use the option 9 in the console to restore from disk without rebooting.
 +
 
 +
==== unable to login in server-manager ====
 +
if you are unable to login to manager and see this log error in /var/log/httpd/admin_error_log
 +
AH01215: Can't exec "/usr/bin/pwauth": Permission denied at /etc/e-smith/web/common/cgi-bin/login line 56., referer: https://...
 +
just do
 +
yum reinstall /usr/bin/pwauth -y
 +
 
 +
==== Issue with Screen====
 +
Some installation of Centos do have declared devpts in fstab and are missing the gid=5. This will prevent non root user to use screen
 +
 
 +
change this
 +
devpts          /dev/pts        devpts  defaults  0      0
 +
to this
 +
devpts          /dev/pts        devpts  defaults,gid=5  0      0
 +
 
 +
to avoid a reboot, do
 +
mount -o remount,gid=5,rw,relatime,mode=600,ptmxmode=000 /dev/pts
 +
 
 +
Alternatively, simply remove or comment the line from fstab and it should work on reboot.
 +
 
 +
===Bugs===
 
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
 
Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla]
 
and select the {{#var:smecontribname}} component or use {{BugzillaFileBug|product=SME%20Contribs|component={{#var:smecontribname}}|title=this link}}
 
and select the {{#var:smecontribname}} component or use {{BugzillaFileBug|product=SME%20Contribs|component={{#var:smecontribname}}|title=this link}}

Latest revision as of 05:33, 8 September 2022

Geographylogo.png Languages: 

English




centos2sme
NeedImage.svg
centos2sme logo
MaintainerUnnilennium
Urlhttps://wiki.contribs.org
LicenceGPL
Category

cli

Tags cli, centos, SME, install


Warning.png Warning:
Only for testing purpose, please report in bugzilla


Maintainer

Jean-Philippe Pialasse

Version

Contrib 10:
Contrib 9:
smeserver-centos2sme
The latest version of smeserver-centos2sme is available in the SME repository, click on the version number(s) for more information.


Description

This allow you to install SME on a minimal CentOS. All you need is network enabled to install the rpm.


Important.png Note:
Important: ensure networking is working when installing minimal CentOS


Everything is automated, all you will need is to answer to :

- good old console configuration to set your server working as you want

- allowed IP and subnet to access the manager

Also, if you have setup and enabled,before rebooting, you will need to import your public RSA key to ~/.ssh/authorized_keys in order to be able to login after installation, otherwise default behaviour will apply.

The root password configured on the initial CentOS installation is copied to the admin user.

SSH access is open, with root login allowed, but only RSA SSH key allowed.

Be aware the first reboot might take awhile because of quota check...

Installation

You may have to install wget 

yum install wget

Download the file and install (you might check the last available version in https://mirror.koozali.org/releases/10/smecontribs/x86_64/RPMS/ to adapte the following line) 

wget https://mirror.koozali.org/releases/10/smecontribs/x86_64/RPMS/smeserver-centos2sme-6.9.1-13.el7.sme.noarch.rpm

yum install smeserver-centos2sme-6.9.1-13.el7.sme.noarch.rpm

SME Server Conversion

We assume you were able to connect to your remote CentOS 7 server using SSH and you already have added your own public key to /root/.ssh/authorized_key. Alternatively you have a virtual or IP KVM access to your server.

Preparation

get the needed tools 

yum install -y net-tools

Get the current network information of your server 

# ifconfig 
eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
       inet NY.IP.IS.HE.RE  netmask MY.MASK.IS.HE.RE  broadcast Z.Z.Z.Z

Get the default gateway : 

# route -n
Destination       Gateway          Genmask            Indic Metric Ref    Use Iface
0.0.0.0           MY.GATE.WAY.IP   0.0.0.0            UG    0      0        0 eth0
MY.NET.WORK.0     0.0.0.0          MY.MASK.IS.HE.RE   U     0      0        0 eth0

You might also want to get the IP /network you are connecting from, to add latter to ValidFrom to access to the server-manager.

Script Usage

Launch the script 

centos2sme

Run this, if dependency errors occur it will have setup Koozali repos so updates can be actioned.

You may get dependency errors due to updates that have recently been pushed to Koozali mirrors. Most recently following are three that required further action due to recent changes: 

# yum downgrade initscripts
# yum install yum-plugin-post-transaction-actions
# yum install dhcp-common

Rerun install script 

# centos2sme

Final Steps

At the end of the script, you will get to the bootstrap console to configure your server. This is where you need the information about your network.

Then you will be offered to enter a valid Network you want to authorize access to your server-manager.

At the end you will either need to reboot to get all your services running, or use console to restore a backup.

Uninstall

yum remove smeserver-centos2sme

Other Information

using restore on reboot

Usual System restoration on boot using usb disk is disable to avoid locking you out on reboot, as it is considered you might not have a KVM access, and only ssh access.

IF you HAVE KVM access, then the following can be performed once install/reboot is complete to initiate restore of a backup as per default behaviour on first reboot. 

config delete PasswordSet
config setprop bootstrap-console Run Yes
signal-event reboot

DO this only if you have kvm access, Remember you still can use the option 9 in the console to restore from disk without rebooting.

unable to login in server-manager

if you are unable to login to manager and see this log error in /var/log/httpd/admin_error_log 

AH01215: Can't exec "/usr/bin/pwauth": Permission denied at /etc/e-smith/web/common/cgi-bin/login line 56., referer: https://...

just do 

yum reinstall /usr/bin/pwauth -y

Issue with Screen

Some installation of Centos do have declared devpts in fstab and are missing the gid=5. This will prevent non root user to use screen

change this 

devpts          /dev/pts        devpts  defaults  0       0

to this 

devpts          /dev/pts        devpts  defaults,gid=5  0       0

to avoid a reboot, do 

mount -o remount,gid=5,rw,relatime,mode=600,ptmxmode=000 /dev/pts

Alternatively, simply remove or comment the line from fstab and it should work on reboot.

Bugs

Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-centos2sme component or use this link


Below is an overview of the current issues for this contrib:

IDProductVersionStatusSummary (3 tasks) ⇒
12166SME Contribs10.0CONFIRMEDinit-accounts
11954SME Contribs10.0CONFIRMEDnoise with /etc/e-smith/events/actions/systemd-default
11705SME ContribsFuturUNCONFIRMEDNo '/sbin/sendmail' available

Changelog

Only released version in smecontrib are listed here.

smeserver-centos2sme Changelog: SME 10 (smecontribs)
2022/06/20 Jean-Philippe Pialasse 6.9.1-13.sme
- fix failure to install due to missing remi-safe repo [SME: 12075]
2021/05/30 Jean-Philippe Pialasse 6.9.1-12.sme
- remove sendmail and postfix prior SME install [SME: 11599]
2021/03/21 Jean-Philippe Pialasse 6.9.1-11.sme
- fix typo [SME: 10850]

2021/03/20 Jean-Philippe Pialasse 6.9.1-10.sme
- create empty smeserver-centos2sme [SME: 10850]

should not be necessary as it should be installed on bare CentOS, not on SME...

2021/03/20 Jean-Philippe Pialasse 6.9.1-9.sme
- use systemctl when needed [SME: 10850]
- fix issue with sshd not reloading and locking user [SME: 10850]

- remove rpm -e dhcp-common
Retrieved from "https://wiki.koozali.org/index.php?title=Centos2sme&oldid=41659"