Newbie tutorial

Jump to bottom

Davide Principi edited this page Jun 16, 2022 · 3 revisions

Company accounts

Ask an administrator to create a new account on NethService
Ask an administrator to create a new DHCP reservation on NethSecurity
Ask an administrator to create a new account at https://mattermost.nethesis.it
Ask an administrator to create a new account at https://helpdesk.nethesis.it
Ask an administrator to create a new account at https://my.nethesis.it
Access Nethesis Telegram group (Italian only)

See also: Nuovo collaboratore

Prepare your workstation

Install Fedora or another Linux distribution
Access your webmail: https://nethservice.nethesis.it/webmail or https://nethservice.nethesis.it/webtop
If needed, configure a local mail client (Evolution, Thunderbird)
Install a text editor: you need to know vim basics (http://vim.wikia.com/wiki/Tutorial)
Generate SSH keys: ssh-keygen

Virtual machines

Virtual machines are used to develop and test software.

Prepare a NethServer VM inside your workstation:

Enable virtualization inside the BIOS
Install a virtual machine engine. For KVM: sudo dnf install libvirt-daemon-kvm
Download NethServer ISO from http://www.nethserver.org
Install NethServer and play with it

Git & Co.

All code must be saved under a Git repository, see Reporting bugs and tracking new features (Enterprise vs Community)

Then:

Create a GitHub account
Ask an administrator to add your account under NethServer and/or Nethesis organizations

How to create a pull request

See https://guides.github.com/introduction/flow/

Some common commands for creating pull request:

git checkout -b newbranch
git status
git add
git diff
git commit
git log
git push origin newbranch

How to modify wrong commits:

git rm
git remote (-v)
git branch (-r)
git log -p
git log --stat
git log --graph --all
git checkout -- <nomefile>
git commit --amend
git commit --fixup <commithash>
git rebase -i <master>
git push origin -f <nomebranch>

Align local branch to a the upstream one:

git remote add upstream <linkbranchupstream>
git checkout master
git pull upstream master
git checkout <branchmodifiche>
git rebase master
git checkout master
git merge <branchmodifiche>
git pull -r origin master
Fix conflicts
git push -f origin <nomebranchdestinazione>
HowTo - Update forked Repository

Essentials bash commands

CTRL+A CTRL+E CTRL+B CTRL+F
CTRL+R
mkdir
pwd
history (-a)
tail (-f)
head
ls ((-l) = ll)
find <x> - type f
find -(i)name '...'
cd
cat (-n)
rpm
cp
scp
diff (-u)
rm (-r)
ln -s
mv
cp
mkdir
chown
chmod
less
Linux Shortcuts and Commands

Other useful commands

logrotate (-f)
sed -i s/<from>/<to>/g <dir>
curl -v -x $(hostname):3128 <website>
grep
config set <servicName> service status enabled TCPPort <port1>,<port2> access green,red
signal-event runlevel-adjust; signal-event firewall-adjust

Building RPMs

Things to know