Memilih Type= systemd: simple, forking, notify
Unit tetap aktif saat daemon mati? Pahami perbedaan Type=simple, exec, forking, oneshot, dan notify, lalu temukan PID utama yang benar.
Mengapa systemd melaporkan unit sebagai aktif ketika prosesnya sudah berhenti
Dengan ExitType=main dan RemainAfterExit=no default, unit service systemd tetap active selama satu proses yang disebut systemd sebagai proses utama masih hidup, dan Type= pada bagian [Service] menentukan proses tersebut. Jika nilainya salah, systemd akhirnya memantau wrapper shell atau proses induk berumur pendek, sementara daemon yang Anda perlukan berhenti di dalam unit yang sama. Unit tersebut memberikan status yang benar tentang proses yang diperintahkan untuk dipantaunya.
Mengubah kebijakan restart tidak akan membantu dalam kasus ini. Restart= merespons proses yang berhenti dan kegagalan seperti timeout, tetapi tidak mendeteksi berhentinya daemon yang berjalan di latar belakang ketika PID utama (process identifier) masih dimiliki proses yang tetap berjalan. Perbaiki Type= terlebih dahulu. Tindakan systemd setelah proses utama benar-benar berhenti merupakan keputusan terpisah, yang dibahas dalam panduan tentang Restart= dan RestartSec=.
Apa yang sebenarnya ditentukan oleh Type=
Setiap nilai Type= menjawab dua pertanyaan sekaligus. Kapan systemd boleh menganggap unit ini telah dimulai, dan proses mana yang menjadi proses utama.
Jawaban pertama mengatur urutan. Unit yang mencantumkan unit Anda dalam After= akan menunggu hingga systemd menyatakan unit Anda telah dimulai. Type= yang melaporkan “started” terlalu cepat memungkinkan unit dependen berjalan sebelum service Anda dapat meresponsnya.
Jawaban kedua mengatur pemantauan. systemd menempatkan setiap proses yang dibuat oleh suatu unit ke dalam cgroup (control group), yaitu fitur kernel yang mengelompokkan proses agar dapat dibatasi dan dihentikan bersama-sama. cgroup digunakan oleh systemctl stop untuk melakukan pembersihan: KillMode= secara default adalah control-group, sehingga saat sebuah unit dihentikan, semua proses di dalamnya menerima sinyal. PID utama memiliki cakupan yang lebih sempit. Dengan ExitType=main dan RemainAfterExit=no sebagai nilai default, PID utama adalah satu-satunya proses yang jika berhenti akan mengakhiri unit, dan status keluarnya akan memengaruhi hasil unit. Kebingungan muncul ketika cgroup dianggap sebagai PID utama.
Type=simple melaporkan status started sebelum binary dijalankan
Type=simple adalah nilai default ketika ExecStart= ditetapkan, baik Type= maupun BusName= tidak ada, dan unit tidak menggunakan kredensial. Unit yang memuat kredensial, misalnya dengan LoadCredential=, secara implisit menggunakan Type=exec. Dengan simple, systemd membuat proses, langsung menganggap unit telah dimulai, dan memperlakukan proses tersebut sebagai PID utama. Unit lanjutan segera dimulai, bahkan sebelum binary service dijalankan.
Detail terakhir ini menjelaskan kejadian yang sering mengejutkan. Kesalahan ketik pada path ExecStart= tetap menghasilkan start job yang berhasil, lalu kegagalan terjadi sesaat kemudian ketika eksekusi gagal. systemd mencatat kasus ini dengan exit code 203. Dalam tabelnya, systemd menamainya EXIT_EXEC dan mendefinisikannya sebagai kegagalan eksekusi proses yang sebenarnya. Jadi, systemctl start yang selesai tanpa error tidak membuktikan bahwa binary Anda ada.
Gunakan simple untuk program yang tetap berjalan di foreground dan tidak pernah berpindah sendiri ke background. Ini mencakup sebagian besar daemon modern dan hampir semua program yang Anda tulis sendiri.
Type=exec menunggu program benar-benar dimulai
Type=exec adalah simple dengan satu langkah tambahan. systemd menganggap unit telah dimulai hanya setelah fork dan eksekusi binary berhasil. Binary yang tidak ditemukan atau User= yang tidak dapat di-resolve kini langsung menyebabkan start job gagal, bukan melaporkan keberhasilan lalu gagal tanpa pesan beberapa saat kemudian.
Type=exec diperkenalkan upstream dalam systemd 240, tetapi backport dari distribusi mendukungnya pada versi yang lebih lama: RHEL 8 menambahkannya dalam systemd-239-15.el8. Rilis lama yang didukung tetap dapat tidak memilikinya: Ubuntu 18.04 masih berada dalam ESM hingga April 2028, dan manual systemd 237 miliknya tidak mencantumkan exec sebagai type yang didukung. Ubuntu 24.04 menggunakan systemd 255 dan Debian 13 menggunakan systemd 257, per Oktober 2026. Periksa versi Anda dengan systemctl --version dan manual systemd.service dari distribusi tersebut.
Biayanya adalah satu langkah sinkronisasi tambahan saat start. Keuntungannya adalah exit status yang akurat dari systemctl start. Untuk program foreground, pilih exec daripada simple.
Type=forking dan bagaimana main PID dapat hilang
Type=forking memberi tahu systemd bahwa proses dalam ExecStart= akan melakukan fork terhadap child process, lalu keluar dengan sengaja. systemd menunggu proses pertama tersebut keluar, lalu menganggap unit telah dimulai. Child process yang tersisa adalah daemon. Kebiasaan ini berasal dari era SysV, ketika tidak ada komponen yang memantau daemon setelah init script selesai, dan PID file menjadi satu-satunya catatan tentang proses yang sedang berjalan. Keterbatasan ini merupakan salah satu alasan utama mengapa systemd menggantikan init script.
Masalahnya adalah identitas proses. Proses yang diluncurkan systemd sudah tidak ada, sehingga systemd harus menentukan proses mana yang masih berjalan dan menjadi proses utama. Atur PIDFile= ke file yang ditulis daemon, biasanya berupa path di bawah /run, lalu systemd membaca PID dari file tersebut. Jika file itu dimiliki oleh pengguna tanpa hak istimewa, systemd juga memeriksa bahwa PID di dalamnya merujuk ke proses yang sudah menjadi bagian dari service ini. Dengan demikian, file usang atau file yang sengaja dibuat untuk menunjuk ke proses yang tidak terkait akan ditolak dan tidak dipercaya.
Tanpa PIDFile=, GuessMainPID= berlaku dan nilai default-nya adalah yes. Penentuan ini hanya dapat diandalkan jika service berakhir sebagai satu proses. Manual menjelaskan batasannya dengan jelas: penentuan tersebut dapat menghasilkan kesimpulan yang salah jika daemon terdiri dari lebih dari satu proses. Jika main PID tidak dapat ditentukan, deteksi kegagalan dan restart otomatis tidak akan bekerja secara andal. Unit juga dapat memiliki main PID 0. Artinya, systemd tidak melacak proses utama apa pun, meskipun proses daemon masih berjalan dalam cgroup unit.
Sebagian besar daemon yang melakukan fork juga memiliki opsi untuk tetap berjalan di foreground. Gunakan opsi tersebut bersama Type=exec, lalu hapus baris PIDFile=. Semakin sedikit komponen yang terlibat, semakin sedikit kemungkinan PID hilang.
Type=oneshot untuk pekerjaan yang selesai
Type=oneshot mengharapkan proses berjalan lalu keluar. systemd baru menganggap unit telah dimulai setelah proses tersebut keluar. Karena itu, oneshot merupakan bentuk yang tepat untuk pekerjaan yang harus ditunggu oleh unit lain. Ini juga menjadi default implisit ketika unit tidak menetapkan Type= maupun ExecStart=.
Dua perilaku khusus berlaku untuk oneshot. Hanya tipe ini yang menerima lebih dari satu baris ExecStart=, dan baris-baris tersebut dijalankan secara berurutan. Batas waktu start-nya juga dinonaktifkan secara default. Jadi, oneshot yang macet akan menunggu selamanya kecuali Anda menetapkan TimeoutStartSec= sendiri.
Setelah proses keluar, unit kembali ke status inactive. RemainAfterExit=yes mempertahankannya dalam status active tanpa proses yang berjalan. Ini merupakan bentuk yang disengaja dari gejala di bagian atas halaman ini, dan benar jika tugas unit adalah meninggalkan state, bukan mempertahankan sesuatu agar tetap berjalan: memuat ruleset firewall atau menjalankan stack container. Pola ini digunakan oleh stack Docker Compose yang kembali berjalan setelah reboot, ketika unit menjalankan perintah compose, keluar, lalu tetap berstatus active karena container yang dimulainya tetap berjalan setelah unit selesai. Unit oneshot juga sesuai untuk pekerjaan yang dipicu oleh jadwal, yang merupakan bagian lain dari menjalankan job dengan systemd timer sebagai pengganti cron.
Type=notify menunjukkan bahwa service dapat memberi tahu saat sudah siap
Type=notify memindahkan keputusan tersebut ke service. systemd menahan job start hingga proses mengirim READY=1 melalui Unix socket yang path-nya diterima dari variabel lingkungan NOTIFY_SOCKET. Interface C-nya adalah sd_notify(3), dan banyak server sudah mendukungnya.
Ini adalah jawaban yang akurat untuk pertanyaan “apakah service sudah dimulai”. simple dan exec melaporkan bahwa service sudah dimulai sebelum service membaca konfigurasinya atau membuka listening socket. Akibatnya, unit dependen dapat dimulai terlalu awal dan gagal pada koneksi pertamanya. notify melaporkan bahwa service sudah dimulai tepat ketika service tersebut menyatakan dirinya siap.
systemd hanya menerima pesan itu dari proses utama. Inilah yang dimaksud dengan NotifyAccess=main, dan hal ini tersirat dalam Type=notify. Jika pesan dikirim dari child atau helper, tetapkan NotifyAccess=all. Shell script dapat memanggil systemd-notify --ready. Jika memiliki hak akses yang diperlukan, systemd-notify mengirim pesan menggunakan PID milik parent-nya. Dengan demikian, script yang menjadi proses utama itu sendiri akan meneruskan NotifyAccess=main. Jika tidak, systemd-notify menggunakan PID-nya sendiri dan unit memerlukan NotifyAccess=all. Secara default, systemd-notify menunggu hingga systemd selesai memproses pesan sebelum keluar. Karena itu, jangan gunakan --no-block, yang menonaktifkan penantian tersebut. Service yang menjalankan protokol ini secara langsung lebih andal.
Ada dua pengaturan terkait yang perlu diketahui. Type=notify-reload, yang tersedia sejak systemd 253, memperluas handshake yang sama ke proses reload. Dengan demikian, systemctl reload mengembalikan hasil setelah service melaporkan bahwa reload selesai, bukan setelah signal dikirim. Sejak systemd 262, yang dirilis pada September 2026, service notify-reload yang mengirim READY=1 tanpa menangkap atau memblokir signal reload-nya (SIGHUP, kecuali ReloadSignal= menentukan sebaliknya) akan gagal start dengan protocol error, bukan dihentikan oleh signal tersebut saat reload pertamanya. WatchdogSec= meminta service yang mendukung notifikasi untuk mengirim pesan keep-alive pada interval tertentu. systemd menganggap tenggat waktu yang terlewat sebagai kegagalan.
Type=dbus dan Type=idle
Type=dbus menunggu hingga service mendaftarkan nama pada D-Bus, yaitu bus pesan yang digunakan oleh service sistem dan desktop untuk saling berkomunikasi. Opsi ini memerlukan BusName= dan menjadi default segera setelah BusName= ditetapkan. Gunakan opsi ini hanya untuk service yang benar-benar mendaftarkan nama bus.
Type=idle berperilaku seperti simple, tetapi menunda eksekusi program hingga job yang berada dalam antrean selesai dikirim, dengan batas waktu lima detik. Opsi ini digunakan agar output konsol saat boot tidak bercampur dengan pesan status. Opsi ini bukan alat pengaturan urutan dan tidak sesuai untuk service biasa.
Mengapa skrip wrapper membuat systemd mengawasi PID yang salah
Berikut pola yang menghasilkan gejala awal.
[Service]
Type=simple
ExecStart=/opt/app/run.sh#!/bin/bash
export APP_ENV=production
/opt/app/bin/server --config /etc/app.yaml &
/opt/app/bin/exporter --port 9101systemd mencatat shell sebagai PID utama. Shell tetap berjalan selama exporter berjalan di foreground. Jika server berhenti, shell tidak menyadarinya. Akibatnya, PID utama masih berjalan, unit masih active, dan Restart= tidak memiliki apa pun untuk ditindaklanjuti. Kedua proses tetap berada dalam cgroup unit sepanjang waktu, sehingga systemctl stop tetap melakukan pembersihan dengan benar. Pengawasanlah yang rusak, bukan pembersihan.
Perbaikan bergantung pada jumlah proses long-running yang sebenarnya dimiliki unit.
Jika hanya ada satu, ganti shell dengan proses tersebut.
#!/bin/bash
export APP_ENV=production
exec /opt/app/bin/server --config /etc/app.yamlexec mengganti shell dengan program yang disebutkan dan mempertahankan PID yang sama, sehingga PID yang dicatat systemd sekarang menjadi milik daemon. Lebih baik lagi, hapus wrapper tersebut. Environment= dan EnvironmentFile= membawa variabel, sedangkan ExecStartPre= menjalankan langkah penyiapan. Dengan demikian, systemd dapat menjalankan daemon secara langsung dan mengetahui PID-nya sejak awal.
Jika ada dua, tidak ada satu PID yang mewakili unit tersebut. Pisahkan keduanya menjadi dua unit, lalu atur urutannya dengan After= dan Wants=. Satu unit untuk setiap proses adalah susunan yang diawasi systemd dengan baik. Hanya dengan cara ini setiap proses memperoleh perilaku restart sendiri.
Perubahan yang dibuat oleh ExitType=cgroup
ExitType= ditambahkan di systemd 250. Nilai defaultnya adalah main: unit dianggap berhenti ketika proses utama keluar. Dengan ExitType=cgroup, unit dianggap tetap berjalan selama masih ada proses apa pun dalam cgroup-nya.
[Service]
Type=simple
ExitType=cgroup
ExecStart=/opt/app/launcherIni mengatasi satu masalah tertentu. Launcher yang memulai pekerjaan sebenarnya lalu keluar akan membuat systemd menganggap unit berhenti dan menghentikan proses yang masih berjalan jika menggunakan ExitType=main. Dengan ExitType=cgroup, unit mengikuti seluruh grup proses.
Pahami hal yang tidak diatasi oleh opsi ini. ExitType=cgroup membuat unit tetap aktif selama setidaknya ada satu proses yang masih berjalan. Jadi, unit yang menampung dua daemon tetap aktif setelah salah satunya berhenti. Opsi ini memperbaiki kasus launcher. Opsi ini tidak mengubah satu unit menjadi supervisor untuk beberapa proses independen. ExitType=cgroup juga tidak dapat digabungkan dengan Type=oneshot.
cgroup juga menjadi tempat pencatatan penggunaan resource. Karena itu, batas seperti MemoryMax= dan CPUQuota= berlaku untuk setiap proses yang dibuat oleh unit, terlepas dari apa yang dinyatakan Type= tentang PID utama. Bagian tersebut dibahas dalam membatasi penggunaan memori dan CPU service dengan systemd.
Cara menemukan proses yang sebenarnya dipantau systemd
Kerjakan langkah-langkah ini pada unit yang sedang Anda debug, secara berurutan. Baca file unit, lalu baca proses yang dilacak systemd, kemudian bandingkan hasilnya dengan process table.
systemctl cat app.service
systemctl show -p Type,ExitType,GuessMainPID,PIDFile,MainPID,RemainAfterExit app.servicesystemctl cat menampilkan file unit beserta setiap drop-in yang berlaku untuk unit tersebut dari disk. Hasil ini dapat berbeda dari konfigurasi yang dimuat systemd jika file berubah tanpa daemon-reload. systemctl show menampilkan nilai efektif, termasuk nilai default yang tidak pernah Anda tulis. Catat nilai MainPID sebelum melanjutkan.
systemd-cgls --unit=app.service
ps -o pid,ppid,stat,etime,args -p "$(systemctl show -p MainPID --value app.service)"systemd-cgls menampilkan setiap proses dalam cgroup unit. Baris ps menjelaskan satu proses yang diawasi systemd. Baca keduanya secara bersamaan. Nilai MainPID 0 berarti systemd tidak melacak proses utama apa pun, meskipun systemd-cgls masih menampilkan proses dalam cgroup unit. Nilai MainPID yang mengarah ke shell, sementara cgroup juga berisi daemon Anda, menunjukkan kasus wrapper yang dijelaskan di atas. Jika cgroup berisi lebih banyak proses daripada yang Anda perkirakan, berarti ada launcher atau daemon yang melakukan forking.
systemctl status app.service
journalctl -u app.service -bsystemctl status menampilkan baris status dan pohon cgroup secara bersamaan, sehingga sering kali dapat menjawab kedua pertanyaan sekaligus. journalctl -u yang dibatasi pada boot ini dengan -b menampilkan peristiwa start dan stop yang dicatat systemd untuk unit tersebut, beserta exit code yang diterimanya. Jika daemon menulis ke file log sendiri, bukan ke journal, baca file tersebut juga karena systemd hanya dapat mencatat informasi yang diterimanya.
Jika Anda mengubah Type=, lakukan reload lalu restart.
systemd-analyze verify /etc/systemd/system/app.service
sudo systemctl daemon-reload
sudo systemctl restart app.servicesystemd-analyze verify mengurai file dan melaporkan pengaturan yang tidak dapat diterimanya. daemon-reload membuat systemd membaca ulang file unit dari disk. Perubahan pada Type= tidak diterapkan ke unit yang sedang berjalan, sehingga restart wajib dilakukan.
Selanjutnya, uji perubahan tersebut. Ambil PID proses yang benar-benar Anda perlukan dari systemd-cgls, lalu hentikan proses itu. Jalankan systemctl is-active app.service segera setelahnya. Dengan ExitType=main dan RemainAfterExit=no, menghentikan proses utama mengakhiri instance yang sedang berjalan, meskipun kebijakan restart dapat menjalankannya kembali sebelum Anda memeriksanya. Jika unit tetap aktif tanpa restart, periksa apakah systemd memantau proses lain atau unit tersebut menggunakan ExitType=cgroup atau RemainAfterExit=yes.
Jenis Type= systemd yang harus digunakan
- Program yang tetap berjalan di foreground:
Type=exec. - Program yang mendukung notifikasi kesiapan:
Type=notify, dannotify-reloadjika program juga mengonfirmasi reload. - Daemon yang mengharuskan dirinya berpindah ke background:
Type=forkingdenganPIDFile=, atau gunakan opsi untuk tetap berjalan di foreground bersamaType=exec. - Skrip yang menjalankan tugas lalu keluar:
Type=oneshot, sertaRemainAfterExit=yesjika tujuannya adalah meninggalkan state. - Launcher yang keluar sementara proses turunannya tetap berjalan:
Type=simpledenganExitType=cgroup.
Jika Anda tidak yakin Type= yang diperlukan daemon pihak ketiga, baca unit file yang disertakan dalam paketnya terlebih dahulu. Menjalankan systemctl cat pada unit yang disediakan oleh distribusi akan menampilkan pilihan Type= dari paket beserta override lokal.
FAQ
Mengapa unit systemd saya tetap berstatus active setelah prosesnya berhenti?
Dengan ExitType=main dan RemainAfterExit=no default, hal ini terjadi karena proses yang dianggap systemd sebagai proses utama masih berjalan. Dengan default tersebut, systemd memantau satu PID utama untuk setiap service, yang dipilih berdasarkan Type=. Penyebab yang umum adalah skrip wrapper yang dijalankan dengan Type=simple: shell menjadi PID utama, sehingga unit tetap berstatus active ketika daemon yang dijalankan shell di latar belakang berhenti. Jalankan systemctl show -p MainPID app.service, lalu tampilkan cgroup unit dengan systemd-cgls --unit=app.service, dan bandingkan keduanya.
Apa perbedaan antara Type=simple dan Type=exec?
Type=simple menganggap unit sudah dimulai segera setelah systemd membuat proses, sebelum binary dijalankan. Karena itu, path yang salah dalam ExecStart= tetap menghasilkan start job yang berhasil, kemudian diikuti kegagalan. Type=exec menunggu hingga eksekusi berhasil, sehingga kegagalan tersebut dilaporkan langsung oleh start job. Keduanya memperlakukan proses yang sama sebagai PID utama. Type=exec diperkenalkan di upstream pada systemd 240, tetapi distribusi dapat melakukan backport ke versi yang lebih lama, seperti yang dilakukan RHEL 8 pada systemd-239-15.el8.
Apakah saya masih memerlukan PIDFile= dengan Type=forking?
Ya, jika daemon menulis file tersebut. Tanpa file itu, systemd menggunakan GuessMainPID= sebagai fallback. Metode ini hanya berupa perkiraan dan hanya andal untuk service yang menetap sebagai satu proses. Jika perkiraannya salah atau tidak dapat dibuat, deteksi kegagalan dan restart otomatis tidak akan bekerja secara andal untuk unit tersebut. Arahkan PIDFile= ke path persis yang ditulis daemon, biasanya di bawah /run.
Kapan saya harus menggunakan RemainAfterExit=yes?
Gunakan saat tujuan unit adalah mengubah status sistem, bukan mempertahankan proses agar tetap berjalan. Unit Type=oneshot yang memuat aturan firewall atau memulai container stack akan berhenti segera setelah pekerjaannya selesai. Tanpa RemainAfterExit=yes, unit langsung berpindah dari starting ke stopping. Akibatnya, pembersihan ExecStop= dijalankan segera setelah pekerjaan selesai, bukan saat Anda memilih untuk menghentikan unit, dan systemctl stop tidak memiliki apa pun yang tersisa untuk dihentikan. Dengan opsi tersebut, unit tetap berstatus active tanpa proses apa pun. Perilaku itu memang dimaksudkan dalam kasus ini.
Apakah perubahan Type= memerlukan daemon-reload?
Ya, dan unit juga harus di-restart. systemctl daemon-reload membuat systemd membaca ulang unit file dari disk, tetapi instance yang sedang berjalan tetap menggunakan Type= yang digunakan saat instance tersebut dimulai. Jalankan sudo systemctl daemon-reload, lalu sudo systemctl restart app.service sebelum melakukan pengujian. Jika tidak, Anda masih mengamati perilaku supervision yang lama.