# 6-DRC INSIGHT - COS Troubleshooting

#   


**Purpose:** Resolve the most common Linux COS installation, service, and Chromebook issues.

---

## Issue 1 - Installer Fails or Stops Early

**Symptoms:**

- No usable COS services
- Installer exits quickly
- Lock file or temp errors

**Fix:**

```
sudo chmod 1777 /tmp
sudo rm -rf /opt/CentralOffice
sudo rm -f /tmp/coinstaller*.lock
sudo ./silent-linux.sh
```

---

## Issue 2 - Only Proxy Runs

**Symptoms:**

- `forever list` shows only proxy
- relay and contenthosting do not stay running

**Likely Cause:**

- Registration not completed
- Configuration not generated correctly

**Fix:**

- Complete the setup URL from installation
- Restart COS services

---

## Issue 3 - Relay Heartbeat Error

**Error:**

```
CO API - Heartbeat returned undefined
```

**Likely Cause:**

- Registration incomplete
- DRC API not reachable
- Upstream filtering or SSL inspection interfering

**Fix:**

- Complete registration
- Verify internet connectivity
- Allow required DRC URLs and ports

---

## Issue 4 - Services Show "active (exited)"

This can be normal. COS uses `forever` to launch Node services in the background, so the systemd wrapper may show as exited while the Node processes continue running.

**Use this command as the truth source:**

```
sudo /opt/CentralOffice/node \
/opt/CentralOffice/setup/node_modules/forever/bin/forever -p /opt/CentralOffice list
```

---

## Issue 5 - Chromebooks Cannot Connect

**Check:**

- ORG Unit ID entered correctly
- Chromebook can reach COS network path
- Display size is 100%
- Keyboard is US English
- Portal configuration is green

---

## Issue 6 - Content Does Not Download

**Check:**

- Content Management enabled
- Content Hosting enabled
- Shared Content OFF for single server
- Correct test programs selected

---

## Useful Commands

```
# Check runtime services
sudo /opt/CentralOffice/node \
/opt/CentralOffice/setup/node_modules/forever/bin/forever -p /opt/CentralOffice list

# Check ports
sudo ss -tulnp | grep node

# Check content directory
ls -lah /opt/CentralOffice/content_fs

# Follow content hosting logs
sudo journalctl -u centralofficecontenthosting -f

# Follow relay logs
sudo journalctl -u centralofficerelay -f
```

---

## Support Contacts

- DRC PA Customer Service: (800) 451-7849
- DRC Status Page: https://status.drcedirect.com/PA

---

**End of Troubleshooting SOP**