add shares av system
This commit is contained in:
Warp Agent
300
docs/on-progress/SYSTEMD-SERVICES.md
Normal file
300
docs/on-progress/SYSTEMD-SERVICES.md
Normal file
@@ -0,0 +1,300 @@
|
||||
# Calypso Systemd Services
|
||||
|
||||
## Overview
|
||||
Calypso menggunakan systemd untuk mengelola kedua service (backend API dan frontend dev server) secara otomatis.
|
||||
|
||||
## Services
|
||||
|
||||
### 1. Backend API Service
|
||||
**File**: `/etc/systemd/system/calypso-api.service`
|
||||
|
||||
**Description**: Calypso Backend API Server (Go)
|
||||
- Port: 8080
|
||||
- Binary: `/development/calypso/backend/bin/calypso-api`
|
||||
- User: root
|
||||
- Auto-restart: Yes
|
||||
|
||||
### 2. Frontend Service
|
||||
**File**: `/etc/systemd/system/calypso-frontend.service`
|
||||
|
||||
**Description**: Calypso Frontend Development Server (Vite + React)
|
||||
- Port: 3000
|
||||
- Working Directory: `/development/calypso/frontend`
|
||||
- Command: `npm run dev`
|
||||
- User: root
|
||||
- Auto-restart: Yes
|
||||
- Depends on: calypso-api.service (optional)
|
||||
|
||||
## Service Management
|
||||
|
||||
### Start Services
|
||||
```bash
|
||||
# Backend
|
||||
sudo systemctl start calypso-api
|
||||
|
||||
# Frontend
|
||||
sudo systemctl start calypso-frontend
|
||||
|
||||
# Both
|
||||
sudo systemctl start calypso-api calypso-frontend
|
||||
```
|
||||
|
||||
### Stop Services
|
||||
```bash
|
||||
# Backend
|
||||
sudo systemctl stop calypso-api
|
||||
|
||||
# Frontend
|
||||
sudo systemctl stop calypso-frontend
|
||||
|
||||
# Both
|
||||
sudo systemctl stop calypso-api calypso-frontend
|
||||
```
|
||||
|
||||
### Restart Services
|
||||
```bash
|
||||
# Backend
|
||||
sudo systemctl restart calypso-api
|
||||
|
||||
# Frontend
|
||||
sudo systemctl restart calypso-frontend
|
||||
|
||||
# Both
|
||||
sudo systemctl restart calypso-api calypso-frontend
|
||||
```
|
||||
|
||||
### Check Status
|
||||
```bash
|
||||
# Backend
|
||||
sudo systemctl status calypso-api
|
||||
|
||||
# Frontend
|
||||
sudo systemctl status calypso-frontend
|
||||
|
||||
# Quick check both
|
||||
sudo systemctl is-active calypso-api calypso-frontend
|
||||
```
|
||||
|
||||
### Enable/Disable Auto-start on Boot
|
||||
```bash
|
||||
# Enable (already enabled by default)
|
||||
sudo systemctl enable calypso-api
|
||||
sudo systemctl enable calypso-frontend
|
||||
|
||||
# Disable
|
||||
sudo systemctl disable calypso-api
|
||||
sudo systemctl disable calypso-frontend
|
||||
|
||||
# Check if enabled
|
||||
sudo systemctl is-enabled calypso-api calypso-frontend
|
||||
```
|
||||
|
||||
## Viewing Logs
|
||||
|
||||
### Real-time Logs
|
||||
```bash
|
||||
# Backend logs (follow mode)
|
||||
sudo journalctl -u calypso-api -f
|
||||
|
||||
# Frontend logs (follow mode)
|
||||
sudo journalctl -u calypso-frontend -f
|
||||
|
||||
# Both services
|
||||
sudo journalctl -u calypso-api -u calypso-frontend -f
|
||||
```
|
||||
|
||||
### Recent Logs
|
||||
```bash
|
||||
# Last 50 lines
|
||||
sudo journalctl -u calypso-api -n 50
|
||||
|
||||
# Last 100 lines
|
||||
sudo journalctl -u calypso-frontend -n 100
|
||||
|
||||
# Today's logs
|
||||
sudo journalctl -u calypso-api --since today
|
||||
|
||||
# Last hour
|
||||
sudo journalctl -u calypso-frontend --since "1 hour ago"
|
||||
```
|
||||
|
||||
### Search Logs
|
||||
```bash
|
||||
# Search for errors
|
||||
sudo journalctl -u calypso-api | grep -i error
|
||||
|
||||
# Search for specific text
|
||||
sudo journalctl -u calypso-frontend | grep "dataset"
|
||||
```
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Service Won't Start
|
||||
|
||||
1. **Check service status**:
|
||||
```bash
|
||||
sudo systemctl status calypso-frontend --no-pager
|
||||
```
|
||||
|
||||
2. **Check logs**:
|
||||
```bash
|
||||
sudo journalctl -u calypso-frontend -n 50
|
||||
```
|
||||
|
||||
3. **Verify binary/command exists**:
|
||||
```bash
|
||||
# Backend
|
||||
ls -lh /development/calypso/backend/bin/calypso-api
|
||||
|
||||
# Frontend
|
||||
which npm
|
||||
cd /development/calypso/frontend && npm --version
|
||||
```
|
||||
|
||||
4. **Check permissions**:
|
||||
```bash
|
||||
sudo systemctl cat calypso-frontend
|
||||
```
|
||||
|
||||
### Service Keeps Restarting
|
||||
|
||||
1. **Check restart limit**:
|
||||
```bash
|
||||
sudo systemctl status calypso-frontend
|
||||
```
|
||||
|
||||
2. **View detailed logs**:
|
||||
```bash
|
||||
sudo journalctl -u calypso-frontend --since "5 minutes ago"
|
||||
```
|
||||
|
||||
3. **Test manual start**:
|
||||
```bash
|
||||
# Frontend
|
||||
cd /development/calypso/frontend
|
||||
npm run dev
|
||||
|
||||
# Backend
|
||||
cd /development/calypso/backend
|
||||
./bin/calypso-api -config config.yaml.example
|
||||
```
|
||||
|
||||
### Port Already in Use
|
||||
|
||||
```bash
|
||||
# Check what's using port 3000
|
||||
sudo ss -tlnp | grep 3000
|
||||
|
||||
# Check what's using port 8080
|
||||
sudo ss -tlnp | grep 8080
|
||||
|
||||
# Kill process if needed
|
||||
sudo kill <PID>
|
||||
```
|
||||
|
||||
## Service Configuration
|
||||
|
||||
### Backend Environment Variables
|
||||
Backend menggunakan environment variables yang didefinisikan di service file.
|
||||
|
||||
Edit `/etc/systemd/system/calypso-api.service`:
|
||||
```ini
|
||||
[Service]
|
||||
Environment="CALYPSO_DB_PASSWORD=your_password"
|
||||
Environment="CALYPSO_JWT_SECRET=your_secret"
|
||||
```
|
||||
|
||||
Setelah edit:
|
||||
```bash
|
||||
sudo systemctl daemon-reload
|
||||
sudo systemctl restart calypso-api
|
||||
```
|
||||
|
||||
### Frontend Environment Variables
|
||||
Frontend menggunakan NODE_ENV=development.
|
||||
|
||||
Edit `/etc/systemd/system/calypso-frontend.service`:
|
||||
```ini
|
||||
[Service]
|
||||
Environment="NODE_ENV=development"
|
||||
Environment="VITE_API_URL=http://localhost:8080"
|
||||
```
|
||||
|
||||
Setelah edit:
|
||||
```bash
|
||||
sudo systemctl daemon-reload
|
||||
sudo systemctl restart calypso-frontend
|
||||
```
|
||||
|
||||
## Monitoring
|
||||
|
||||
### Check if Services are Running
|
||||
```bash
|
||||
# Quick check
|
||||
sudo systemctl is-active calypso-api calypso-frontend
|
||||
|
||||
# Detailed status
|
||||
sudo systemctl status calypso-api calypso-frontend --no-pager
|
||||
```
|
||||
|
||||
### Monitor Resource Usage
|
||||
```bash
|
||||
# Using systemd-cgtop
|
||||
sudo systemd-cgtop
|
||||
|
||||
# Using journalctl metrics
|
||||
sudo journalctl -u calypso-api | grep -i "memory\|cpu"
|
||||
```
|
||||
|
||||
### Service Uptime
|
||||
```bash
|
||||
# Backend uptime
|
||||
systemctl show calypso-api --property=ActiveEnterTimestamp
|
||||
|
||||
# Frontend uptime
|
||||
systemctl show calypso-frontend --property=ActiveEnterTimestamp
|
||||
```
|
||||
|
||||
## Access URLs
|
||||
|
||||
- **Frontend Portal**: http://10.10.14.16:3000 or http://localhost:3000
|
||||
- **Backend API**: http://10.10.14.16:8080 or http://localhost:8080
|
||||
- **API Health Check**: http://localhost:8080/api/v1/health
|
||||
|
||||
## Systemd Service Files
|
||||
|
||||
### Backend Service File Location
|
||||
`/etc/systemd/system/calypso-api.service`
|
||||
|
||||
### Frontend Service File Location
|
||||
`/etc/systemd/system/calypso-frontend.service`
|
||||
|
||||
### View Service Configuration
|
||||
```bash
|
||||
# Backend
|
||||
sudo systemctl cat calypso-api
|
||||
|
||||
# Frontend
|
||||
sudo systemctl cat calypso-frontend
|
||||
```
|
||||
|
||||
## Boot Sequence
|
||||
|
||||
On system boot:
|
||||
1. Network is up
|
||||
2. calypso-api service starts
|
||||
3. calypso-frontend service starts (waits for API if configured)
|
||||
4. Both services are ready
|
||||
|
||||
## Notes
|
||||
|
||||
- **Backend**: Production-grade service using compiled Go binary
|
||||
- **Frontend**: Development server (Vite) - for production, build static files and serve with nginx
|
||||
- **Auto-restart**: Both services akan restart otomatis jika crash
|
||||
- **Logs**: Semua logs tersimpan di systemd journal
|
||||
- **Dependencies**: Frontend wants backend (optional dependency)
|
||||
|
||||
---
|
||||
**Date**: 2025-12-25
|
||||
**Status**: ✅ Both Services Active and Enabled
|
||||
**Boot**: ✅ Auto-start enabled
|
||||
Reference in New Issue
Block a user