System Console

System Console (syco) is a collection of installation and management scripts that helps a sysop to administrate his linux servers.

Installation

Clone the repo from github. It's preferred to install it in the /opt folder.

    cd /opt
    git clone https://github.com/systemconsole/syco.git

Setup a proper configuration file, for example

    ln -s  /opt/syco/usr/mod-template/etc/install.cfg /opt/syco/etc/install.cfg

Add private/customized scripts, for example

    cd /opt/syco/usr
    git clone https://github.com/systemconsole/syco-private.git

Let syco install it self.

    /opt/syco/bin/syco.py install-syco

Now you can run the syco script from anywhere, for example.

    cd /root
    syco hardening

If you are member of the syco team, use this to push things back to github.

    ssh-keygen -t rsa
    cat ~/.ssh/id_rsa.pub
    # Insert the output into www.github.com.
    git clone [email protected]:arlukin/syco.git

Contributing to syco

    # Prepare repos
    https://github.com/<username>/syco.git
    git remote add devloper https://github.com/developer/syco.git
    git remote add upstream https://github.com/systemconsole/syco.git
    git fetch
    git branch -r

    # Create local copy of upstream/version-0.2.6
    git checkout upstream/version-0.2.6
    git checkout -b installRsyslog

    # Working on my feature
    git commit -am"Commit 1"
    git commit -am"Commit 2"
    git commit -am"Commit 3"
    git commit -am"Commit 4"
    git push developer -- instalRsyslog

    # Get all the latest branches and their code.
    git fetch upstream

    # Merge your feature
    git merge upstream/version-0.2.7

    # Squash all your commits into one commit.
    git reset upstream/version-0.2.7
    git add .
    git add -u .
    git commit

    # Push back to your own github repo.
    git push developer

    # Login to github and create a pull request.

The flow of the "syco remote-install"

• Download syco from git
• On VirtualHost "syco install-local", this should be the only command that needs to be executed by hand. The following commands will be executed automatically.
  • "syco hardening"
  • "syco install-kvmhost"
  • "syco install-fo-tp-install", will install InstallGuest
    • On InstallGuest "syco hardening"
    • On InstallGuest "syco install-cobbler"
    • On InstallGuest "syco remote-install"
      • Look for alive hosts defined in install.cfg
      • Run "syco remote-install xx" on the host alive.
      • Continue until "remote-install" has been executed on all servers.
  • "syco install-guests"
    • Install 2 guests on VirtualHost Web and Mysql

Unit test

    Download and intsall virtualbox (https://www.virtualbox.org/wiki/Downloads)
    Download and intsall vagrant (https://www.vagrantup.com/downloads.html)
    vagrant box add mattiashem/syco_prep_centos6
    vagrant up
    vagrant ssh
    sudo rpm -Uhv http://mirrors.se.eu.kernel.org/fedora-epel/6/x86_64/epel-release-6-8.noarch.rpm
    sudo yum install python-pip
    sudo yum install python-devel
    sudo pip install pytest coverage
    /opt/syco/bin/test-all