Changes

From SME Server
Jump to navigationJump to search
4,322 bytes added ,  06:33, 8 September 2022
Line 10: Line 10:  
|image={{#var:contribname}}.jpg
 
|image={{#var:contribname}}.jpg
 
|description_image= {{#var:contribname}} logo
 
|description_image= {{#var:contribname}} logo
|maintainer= maintainer
+
|maintainer= Unnilennium
 
|licence= GPL
 
|licence= GPL
 
|url= https://wiki.contribs.org
 
|url= https://wiki.contribs.org
 
|category= cli
 
|category= cli
 
|tags=cli, centos, SME, install
 
|tags=cli, centos, SME, install
}}
+
}}{{Warning box|Only for testing purpose, please report in bugzilla}}
    
===Maintainer===
 
===Maintainer===
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  
+
This allow you to install SME on a minimal CentOS. All you need is network enabled to install the rpm. 
    +
{{Note box|Important: ensure networking is working when installing minimal CentOS}}
   −
=== Installation ===
+
Everything is automated, all you will need is to answer to :
Download the file
  −
  −
Install
  −
yum install
      +
- 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,<u>before rebooting</u>, 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
 
Launch the script
 
  centos2sme
 
  centos2sme
    +
Run this, if dependency errors occur it will have setup Koozali repos so updates can be actioned.
   −
=== Uninstall ===
+
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 {{#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}}
Line 51: Line 136:  
Only released version in smecontrib are listed here.
 
Only released version in smecontrib are listed here.
   −
{{ #smechangelog: {{#var:smecontribname}} }}
+
{{#smechangelog: {{#var:smecontribname}} }}
       
<!-- list of category you want to see this page in -->
 
<!-- list of category you want to see this page in -->
 
[[Category: Contrib]]
 
[[Category: Contrib]]
   
<!-- Please keep there the template revision  number as is -->
 
<!-- Please keep there the template revision  number as is -->
[[contribtemplate::1| ]]
  −
[[contriblang:: {{#var:lang}} | ]]
 
Super Admin, Wiki & Docs Team, Bureaucrats, Interface administrators, Administrators
3,250

edits

Navigation menu