Skip to content

Naming_Stuff

Jump to bottom
Rüdiger Beck edited this page Feb 19, 2020 · 15 revisions

Naming Stuff

Samba4 AD

  • Account names can only be used once (Either for a group OR for a user, ...)
  • Accunt names must consist of: a-z0-9-_
  • sophomorix avoids reusing login names
    • Forced login names: WARN
    • Autogenerated login names: Avoid reuse for 1 Year (see sophomorix.ini)
  • The Share name for global is linuxmuster-global (global is reserved by samba)

Name prefixes

  • Name prefixes are <school->, i.e an adminclass 7a in school abc is named abc-7a
  • They are prefixed ONLY when name collisions are possible:
    • group names
      • prefixed in groupnames (same adminclass in different schools possible)
      • not prefixed in filesystem paths
    • more ...

Administrative Accounts used by sophomorix

  • root The sophomorix scripts are run by root.

  • Administrator To access the Samba4 AD and SMB-shares that contain the file structure of the schools sophomorix needs to be the Samba(windows) Administrator. You type in a password for Administrator during Samba4 provisioning and save it in /etc/linuxmuster/.secret/administrator (you are promted by sophomorix if it's not tere). If you use linuxmuster setup a random password is created/and saved for Administrator during setup. You should never need to use this account because you should do everything with the sophomorix-scripts

  • global-admin (Choose a name) To have full access to the SMB-shares as a human user you need a global administrator which you can create with the command sohomorix-admin. Each global administrator is in the groups needed for full access to all SMB-shares of all schools. If you use linuxmuster setup a global administrator is created with the name global-admin and you are prompted for a password. This is the account you use to clean up SMB-shares by hand.

  • school-admin (Choose a name). For limited acces to only one SMB-share (the school share). Create them with sohomorix-admin.

  • binduser (Choose a name) are accounts used to bind to the Samba4 AD, i.e. for a remote moodle, mailserver, ... Create them with sohomorix-admin.

Name Definitions

  • adminclass: class/group from school administration software
  • teacherclass: the class/group of teachers
  • extraclass: class/group created by command sophomorix-extraclass
  • class: umbrella term for adminclass/teacherclass/extraclass (used in loops, ... )

Configuration File Naming

Configuration file names consist of 3 parts, separated by dots:

<school>.<what-to-configure>.<fileype>

Where <school> is the name of the school. On the default-school <school> is empty and the first dot omitted. This ensures, that there is no configuration file name double on a (multi-school-)server.

Where <what-to-configure> can be:

  • sophomorix (global configuration)
  • school
  • students
  • teachers
  • devices
  • belwue (additional mailconfiguration for belwue)
  • ... more to come

Where <filetype> can be:

  • conf -> configuration file (mostly in INI format)

  • csv -> comma-separated value file (; as separator)

Clone this wiki locally