Changes

Jump to navigation Jump to search
5,995 bytes added ,  20:41, 5 March 2021
Line 1: Line 1:  +
{{Languages}}
 +
== Helpful Wiki Pages ==
 +
 +
* [https://wiki.contribs.org/Dashboard#tab=SME_Server_10_Alpha Development Dashboard]
 +
 +
* [https://wiki.contribs.org/SME_Server:Documentation:QA:Verification QA Verifications]
 +
 +
* [https://wiki.contribs.org/SME10.0_QA Koozali SME 10 QA]
 +
 +
* [https://wiki.contribs.org/Extrarepositories Extra Repositories] that may be needed for test scenarios
 +
 +
* [https://wiki.contribs.org/Simple_Package_Modification Simple Package Modification]
 +
* [https://wiki.contribs.org/index.php?title=Setting_up_RPM_Building_for_SME_Server Setting_up_RPM_Building_for_SME_Server]
 +
 
== Hardware ==
 
== Hardware ==
 
[http://www.koozali.org/home/hardware-compatibility Hardware Compatability]
 
[http://www.koozali.org/home/hardware-compatibility Hardware Compatability]
Line 6: Line 20:     
As a general rule just about any hardware will suffice as a Standalone test machines or as a host for a virtual environment.
 
As a general rule just about any hardware will suffice as a Standalone test machines or as a host for a virtual environment.
 +
 +
For sme10 a minimum of 4gb of RAM is recommended, you can try with less but may have issues when testing under load, eg backup and restores of large file sets.
 +
 +
== Install ISO for Testing or Bug Verification==
 +
Its simple for those who do this regularly, it can be a bloody mine pit for someone who doesn't 🙂 very easy to kill a test system and no way to get out but wipe and start again, please don't be put off, if nothing else it sure educates you on the blackmagic in koozali/sme
 +
 +
{{Warning box|Be aware you should never perform a full yum update with the /smetest and/or /smedev repos enabled it will almost certainly put your server in a state that may not be recoverable from..}}
 +
 +
1. Install current iso that is available from the Koozali webssite - [[SME Server:Download|Downloads]]
 +
 +
2. Once installed, use SSH, SSH access must be enabled with the /server-manager, set remote access to allow, from the cli run a # yum update (DO NOT enable any repos) there can be many mb of updates depending on age of iso, on occasion ie very very rarely smeserver-yum may also need updating first, it may be in smeupdates-testing or updates, so a heads up a quick look under the hood can save a world of grief, [http://mirror.canada.pialasse.com/releases/testing/10/ Koozali Repository] eg
 +
# yum update smeserver-yum --enablerepo=smeupdates-testing
 +
 +
3. Make sure to reboot/reconfig
 +
# signal-event post-upgrade; signal-event reboot
 +
 +
4. Best practice is to select a Bug that need verifying, See [[Dashboard|the Dashboard]] in the wiki, update the package with the updated rpm listed in the Bug 
 +
# yum update e-smith-base --enablerepo=smeupdates-testing (ONLY this)
 +
 +
5. Now for the fly in the ointment - sometimes, rarely, there will be a package in /smetest that fixes a borked update in smeupdates-testing, that situation can arise with any update, these will appear in smeupdates-testing eventually, it is alwways a good idea to check in /smetest for a later version of a package.
 +
 +
6. If you issue the following 
 +
# yum update --enablerepo=smeupdates-testing
 +
you will update ALL the packages that have been updated or added and need testing, every new/modified rpm - a danger Will Robinson moment if there ever was one - this not recommended but can be useful to carry out overall testing of the system or Contrib updates/import testing and verification BUT beware you could also kill your test box VM 🙂
 +
 +
=== Contribs Testing ===
 +
For testing of contribs a simple install and yum update should be sufficient to prepare the test environment, however it may also be necessary to also include a yum update from /smeupdates-testing as well, this will become apparent when attempting an install of an updated contrib.
 +
 +
Contribs for testing will usually be found in the /smedev /smetest repos, all will have a Bug to track the update.
 +
 +
https://bugs.contribs.org/show_bug.cgi?id=11272
 +
 +
yum install smeserver-nfs --enablerepo=smetest,smeupdates-testing 
 +
 +
*** Warning only install an updated contrib with a specific command referencing the /smedev and /smetest repos, NEVER just do a yum update --enablerepo=smedev,smetest this will most certainly render your system akin to a dead parrot.
 +
 +
Those contribs found in the /smetest repo will generally be able to be installed and tested for functionality, report all findings in associated Bug.  Those contribs in /smedev may still have a degree of instability and may install but not run, again all results to relevant bug.
 +
 +
Any contrib that has been moved to the sme10 contribs repo should be fully functional, again there will be a Bug that may still be open to track any issues, use it.
 +
 +
Have fun..always learning
    
== VM Setups ==
 
== VM Setups ==
    
===VirtualBox===
 
===VirtualBox===
 +
Content to be done
 +
 
====Microsoft Windows====
 
====Microsoft Windows====
 +
Content to be done
 +
 
==== MacOS ====
 
==== MacOS ====
 +
Very remiss of me (Terry Fage) in not mentioning the MacOS setup was captured and written up by Chris (I wont list his username unless he wants to) I simply copied pasted, we need more Chris's
 +
 
  Create a new Virtual Machine, choose 'Linux' as the type, 'Other Linux (64-bit)' as the version and set the memory to at least 1GB, ideally 2GB+ as ClamAV on its own needs ~1GB.
 
  Create a new Virtual Machine, choose 'Linux' as the type, 'Other Linux (64-bit)' as the version and set the memory to at least 1GB, ideally 2GB+ as ClamAV on its own needs ~1GB.
   Line 52: Line 113:  
[[File:Audio.jpg]]
 
[[File:Audio.jpg]]
   −
  Choose a 'bridged' network adapter and make sure it's attached to your host's main network connection. This way your VM will becaues like a normal machine on your network and you can SSH to it
+
  Choose a 'bridged' network adapter and make sure it's attached to your host's main network connection. This way your VM will because like a normal machine on your network and you can SSH to it
    
[[File:Networking.jpg]]
 
[[File:Networking.jpg]]
Line 63: Line 124:     
====Linux====
 
====Linux====
 +
Content to be done
    
=== Proxmox ===
 
=== Proxmox ===
 
Proxmox VE is a complete open-source platform for all-inclusive enterprise virtualization that tightly integrates KVM hypervisor and LXC containers, software-defined storage and networking functionality on a single platform, and easily manages high availability clusters and disaster recovery tools with the built-in web management interface.
 
Proxmox VE is a complete open-source platform for all-inclusive enterprise virtualization that tightly integrates KVM hypervisor and LXC containers, software-defined storage and networking functionality on a single platform, and easily manages high availability clusters and disaster recovery tools with the built-in web management interface.
 +
* [https://www.proxmox.com/en/proxmox-ve/requirements Hardware Requirements]
 +
* [https://pve.proxmox.com/wiki/Installation Installation]
 +
 +
Install Proxmox #.# to suitable hardware - see proxmox wiki for details of setup
 +
 +
Start Proxmox, login as root, before creating a new VM there needs to be a relevant iso image available from pve storage to act as a install CD/DVD, this and other OS isos needs to be uploaded to pve local storage
 +
 +
[[File:Uploadiso a.jpg|850px]]
 +
 +
Select upload button
 +
 +
[[File:Uploadiso.jpg|850px]]
 +
 +
Select a suitable iso and upload
 +
 +
[[File:Uploadiso2.jpg|850px]]
 +
 +
====Install/configure Koozali SME9/10 VM on proxmox VE====
 +
 +
If not already running Start Proxmox and login as root, Select Create VM button in top right corner
 +
 +
[[File:Openproxhome.jpg|850px]]
 +
 +
[[File:Newvm-name.jpg|850px]]
 +
 +
Enter name details of new VM
 +
 +
[[File:Newvm-name1.jpg|850px]]
 +
 +
Select CD/DVD image file to use as install source
 +
 +
[[File:Vm-CD-DVD1iso.jpg|850px]]
 +
 +
[[File:Vm-CD-DVD2iso.jpg|850px]]
 +
 +
VM System, safe to accept defaults
 +
 +
  [[File:System1.jpg|850px]]
 +
 +
Hard disk details, type/size - min of 10gb will suffice for a SME10 install
 +
 +
[[File:Hardisk.jpg|850px]]
 +
 +
  CPU depending on hardware the more the better - 1 Socket 2 cores sufficent
 +
 +
[[File:Cpu-cores.jpg|850px]]
 +
 +
Memory - minimum for sme10, 1024mb will operate sluggishly, 2048mb preferred minimum, 4096mb ideal
 +
 +
[[File:mem2048.jpg|850px]]
 +
 +
Network setting defaults are safe to use
 +
 +
[[File:Proxneteth.jpg|850px]]
 +
 +
Summary of settings
 +
 +
[[File:summary.jpg|850px]]
 +
 +
Additional Hardware, Add extra hardware, change hardware settings
 +
 +
[[File:Hardware.jpg|850px]]
 +
{{Note box|Make sure you set your default keyboard - it makes life much easier!!}}
 +
 +
We will use the '''vmbr0''' that is set up, but we need to create a dummy one so we can put SME in server/gateway mode and use Daniels scripts:
 +
* Create a new network interface and call it '''vmbr1'''
 +
* Do NOT set IP address/subnet/bridge ports etc.
 +
* Create your KVM for SME. Make sure that you give it two network adaptors - one is '''vmbr0''' and one is '''vmbr1'''
 +
** vmbr0 should have the following settings :
 +
::Model: virtio
 +
::MAC: 10:10:00:00:20:20 (as per your mac that you set)
 +
*After you have created the KVM add a second adaptor:
 +
**vmbr1 should have the following settings:
 +
::Model: virtio
 +
::MAC: should be the MAC of your main IP address
 +
 +
It doesn't matter which one is 0 or 1 as long as the settings are correct.
 +
 +
 +
 +
 +
[[File:Hardware2.jpg|850px]]
 +
 +
Select console and push start button, install will begin, interact as normal
   −
=====System Requirements=====
+
[[File:sme10setup.jpg|850px]]
For production servers, high quality server equipment is needed. Proxmox VE supports clustering, this means that multiple Proxmox VE installations can be centrally managed thanks to the integrated cluster functionality. Proxmox VE can use local storage like (DAS), SAN, NAS, as well as shared, and distributed storage (Ceph).
     −
=====Recommended Hardware=====
+
A standalone terminal window can be seletced by selecting from top right menu - console- no vnc
* Intel EMT64 or AMD64 with Intel VT/AMD-V CPU flag.
  −
* Memory, minimum 2 GB for OS and Proxmox VE services. Plus designated memory for guests. For Ceph or ZFS additional memory is required, approximately 1 GB memory for every TB used storage.
  −
* Fast and redundant storage, best results with SSD disks.
  −
* OS storage: Hardware RAID with batteries protected write cache (“BBU”) or non-RAID with ZFS and SSD cache.
  −
* VM storage: For local storage use a hardware RAID with battery backed write cache (BBU) or non-RAID for ZFS. Neither ZFS nor Ceph are compatible with a hardware RAID controller. Shared and distributed storage is also possible.
  −
* Redundant Gbit NICs, additional NICs depending on the preferred storage technology and cluster setup – 10 Gbit and higher is also supported.
  −
* For PCI(e) passthrough a CPU with VT-d/AMD-d CPU flag is needed.
     −
=====Minimum Hardware=====
+
[[File:Terminal.jpg|850px]]
* CPU: 64bit (Intel EMT64 or AMD64)
+
* Intel VT/AMD-V capable CPU/Mainboard (for KVM Full Virtualization support)
+
* Minimum 1 GB RAM
+
[[Category:Developer]]
* Hard drive
+
* One NIC
+
[[Category:SME Server Development Framework]]
 +
 +
[[Category:Development Tools]]
 +
 +
[[Category:SME9-Development]]
 +
 +
[[Category:SME10-Development]]
    
=== ESXi ===
 
=== ESXi ===

Navigation menu