|
Size: 2438
Comment:
|
Size: 2393
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 5: | Line 5: |
| 1) create local user SERVICE in /etc/passwd: | 1. create local user SERVICE in /etc/passwd: |
| Line 7: | Line 7: |
| (usually already done by Debian postinst scripts in form of "adduser --system SERVICE". (--system ensures that the assigned ID is in range 100 < ID < 1000 .)) |
* (usually already done by Debian postinst scripts in form of "adduser --system SERVICE". (--system ensures that the assigned ID is in range 100 < ID < 1000 .)) |
| Line 11: | Line 9: |
| 2) create Kerberos principal: | 2. create Kerberos principal: {{{ kadmin.local -q "addprinc -policy service -randkey SERVICE/HOST" }}} |
| Line 13: | Line 14: |
| kadmin.local -q "addprinc -policy service -randkey SERVICE/HOST" | 3. export user's keys to /etc/keytabs/SERVICE.HOST and chmod the file properly: {{{ kadmin.local -q "ktadd -k /etc/keytabs/SERVICE.HOST SERVICE/HOST" chown SERVICE:wheel /etc/keytabs/SERVICE.HOST chmod 440 /etc/keytabs/SERVICE.HOST }}} |
| Line 15: | Line 21: |
| 3) export user's keys to /etc/keytabs/SERVICE.HOST: | 4. create OpenAFS user SERVICE.HOST |
| Line 17: | Line 23: |
| kadmin.local -q "ktadd -k /etc/keytabs/SERVICE.HOST SERVICE/HOST" | * (You must make sure that the UID chosen in AFS is above 1000. You can't use UIDs <1000 because those are reserved for local system's IDs, and so such uids in AFS would mess up reported Unix ownership of files). {{{ pts cu SERVICE.HOST.hcoop.net }}} |
| Line 19: | Line 28: |
| 4) create OpenAFS user SERVICE.HOST | 5. create OpenAFS group "SERVICE" if it doesn't exist, and add SERVICE.HOST to it: {{{ pts cg SERVICE pts ad SERVICE.HOST SERVICE }}} |
| Line 21: | Line 35: |
| (You must make sure that the UID chosen in AFS is above 1000. You can't use UIDs <1000 because those are reserved for local system's IDs, and so such uids in AFS would mess up reported Unix ownership of files). |
6. modify service's init script in /etc/init.d/ in the following way: |
| Line 26: | Line 37: |
| pts cu SERVICE.HOST.hcoop.net | * Change shell at the top of script to "#!/usr/bin/pagsh.openafs" |
| Line 28: | Line 39: |
| (P.S. Can you tell pts the minimum ID to assign?) | * Change start-stop-daemon invocation in action 'start': {{{ start-stop-daemon --start --pidfile $PIDFILE \ -c SERVICE:SERVICE \ --exec /usr/bin/k5start -- -U -b -f /etc/keytabs/SERVICE.`hostname` \ -K 300 -t -p $PIDFILE \ <The original start command> }}} |
| Line 30: | Line 48: |
| 5) create OpenAFS group "SERVICE" if it doesn't exist, and add SERVICE.HOST to it: pts cg SERVICE pts ad SERVICE.HOST SERVICE 6) modify service's init script in /etc/init.d/ in the following way: Change shell at the top of script to "#!/usr/bin/pagsh.openafs" Change start-stop-daemon invocation in action 'start': start-stop-daemon --start --pidfile $PIDFILE \ -c SERVICE:SERVICE \ --exec /usr/bin/k5start -- -U -b -f /etc/keytabs/SERVICE.`hostname` \ -K 300 -t -p $PIDFILE \ <The original start command> **Or if the service does not use start-stop-daemon itself, you still use it in |
* Or if the service does not use start-stop-daemon itself, you still use it in |
| Line 53: | Line 52: |
| (start): start-stop-daemon --start --pidfile /var/run/SERVICE/k5start-SERVICE.pid \ -c SERVICE:SERVICE \ --exec /usr/bin/k5start -- -U -b -K 300 -t -p /var/run/SERVICE/k5start-SERVICE.pid \ -f /etc/keytabs/SERVICE.`hostname` sleep 2 |
* (start): {{{ start-stop-daemon --start --pidfile /var/run/SERVICE/k5start-SERVICE.pid \ -c SERVICE:SERVICE \ --exec /usr/bin/k5start -- -U -b -K 300 -t -p /var/run/SERVICE/k5start-SERVICE.pid \ -f /etc/keytabs/SERVICE.`hostname` sleep 2 }}} * (stop): {{{ start-stop-daemon --stop --pidfile /var/run/SERVICE/k5start-SERVICE.pid rm -f /var/run/SERVICE/k5start-SERVICE.pid }}} |
| Line 60: | Line 66: |
| (stop): start-stop-daemon --stop --pidfile /var/run/SERVICE/k5start-SERVICE.pid rm -f /var/run/SERVICE/k5start-SERVICE.pid 7) You give permissions in AFS space to group "SERVICE", or to user "SERVICE.HOST" if specific instance is important. (Mostly, you just add permissions to "SERVICE"). |
7. You give permissions in AFS space to group "SERVICE", or to user "SERVICE.HOST" if specific instance is important. (Mostly, you just add permissions to "SERVICE"). |
here's the final procedure you should follow (for installing service "SERVICE" (mysql) on host "HOST" (deleuze)):
1. create local user SERVICE in /etc/passwd:
(usually already done by Debian postinst scripts in form of "adduser --system SERVICE". (--system ensures that the assigned ID is in range 100 < ID < 1000 .))
2. create Kerberos principal:
kadmin.local -q "addprinc -policy service -randkey SERVICE/HOST"
3. export user's keys to /etc/keytabs/SERVICE.HOST and chmod the file properly:
kadmin.local -q "ktadd -k /etc/keytabs/SERVICE.HOST SERVICE/HOST" chown SERVICE:wheel /etc/keytabs/SERVICE.HOST chmod 440 /etc/keytabs/SERVICE.HOST
4. create OpenAFS user SERVICE.HOST
(You must make sure that the UID chosen in AFS is above 1000. You can't use UIDs <1000 because those are reserved for local system's IDs, and so such uids in AFS would mess up reported Unix ownership of files).
pts cu SERVICE.HOST.hcoop.net
5. create OpenAFS group "SERVICE" if it doesn't exist, and add
- SERVICE.HOST to it:
pts cg SERVICE pts ad SERVICE.HOST SERVICE
6. modify service's init script in /etc/init.d/ in the following way:
- Change shell at the top of script to "#!/usr/bin/pagsh.openafs"
- Change start-stop-daemon invocation in action 'start':
start-stop-daemon --start --pidfile $PIDFILE \ -c SERVICE:SERVICE \ --exec /usr/bin/k5start -- -U -b -f /etc/keytabs/SERVICE.`hostname` \ -K 300 -t -p $PIDFILE \ <The original start command>
- Or if the service does not use start-stop-daemon itself, you still use it in
action 'start' to run k5start on a line before <The original start command> and later in 'stop' to close it:
- (start):
start-stop-daemon --start --pidfile /var/run/SERVICE/k5start-SERVICE.pid \ -c SERVICE:SERVICE \ --exec /usr/bin/k5start -- -U -b -K 300 -t -p /var/run/SERVICE/k5start-SERVICE.pid \ -f /etc/keytabs/SERVICE.`hostname` sleep 2
- (stop):
start-stop-daemon --stop --pidfile /var/run/SERVICE/k5start-SERVICE.pid rm -f /var/run/SERVICE/k5start-SERVICE.pid
7. You give permissions in AFS space to group "SERVICE", or to user "SERVICE.HOST" if specific instance is important. (Mostly, you just add permissions to "SERVICE").