iOS Troubleshooting

Common issues and solutions for the CMDOP iOS app.

What are common connection issues?

How do I fix a “Connection Refused” error?

Symptoms:

• App shows “Connection failed”
• Terminal won’t connect

Solutions:

1. Check internet connection

   • Try opening Safari
   • Switch between WiFi and cellular

2. Verify agent is online

   • Check web dashboard
   • Run cmdop status on target machine

3. Restart the app

   • Swipe up to close
   • Reopen the app

Why does my connection drop frequently?

Symptoms:

• Terminal disconnects randomly
• Status shows “Reconnecting…”

Causes:

• Unstable network (cellular roaming)
• Low Data Mode enabled
• Background App Refresh disabled

Solutions:

1. Disable Low Data Mode

   • Settings > Cellular > Cellular Data Options
   • Turn off Low Data Mode

2. Enable Background App Refresh

   • Settings > General > Background App Refresh
   • Enable for CMDOP

3. Use WiFi when possible

Why is my session stuck in GRACE_PERIOD?

Symptoms:

• Session shows “GRACE_PERIOD” status
• Cannot reconnect

Explanation:

The 30-second grace period allows reconnection after network issues. If you see this:

1. Wait 30 seconds
2. Try reconnecting
3. If stuck, the session may have closed

Solutions:

• Check target machine is online
• Create new session

How do I fix authentication issues?

How do I fix an “Invalid Token” error?

Symptoms:

• App logs out unexpectedly
• “Authentication failed” message

Causes:

• Token expired
• Password changed on web
• Session revoked

Solutions:

1. Re-login

   • Tap “Sign Out”
   • Sign in again

2. Check account status

   • Try logging in on web dashboard
   • Verify account is active

Why is Face ID not working?

Symptoms:

• Face ID prompt doesn’t appear
• App doesn’t recognize face

Solutions:

1. Check Face ID settings

   • Settings > Face ID & Passcode
   • Ensure Face ID is set up

2. Re-enable in app

   • Settings > Security
   • Toggle “Require Face ID” off then on

3. Reset Face ID

   • Settings > Face ID & Passcode
   • Reset Face ID and set up again

Why am I getting “Workspace Access Denied”?

Symptoms:

• “Permission denied” on certain machines
• Empty machine list

Solutions:

1. Verify workspace membership

   • Check web dashboard
   • Contact workspace admin

2. Switch workspace

   • Settings > Workspace
   • Select correct workspace

How do I fix file transfer issues?

How do I fix “File Too Large” errors?

Cause: iOS app has 100MB file size limit.

Solutions:

1. Split large files

   # On server, split file into 90MB chunks
   split -b 90M largefile.tar.gz part_

2. Use compression

   # Compress a directory into a .tar.gz archive
   tar -czf archive.tar.gz directory/

3. Use CLI for large transfers

Why do I get “Access Denied” on a path?

Cause: Path contains blocked pattern.

Blocked patterns:

• .ssh, .gnupg, .aws
• .env, credentials, secrets

Solutions:

• Copy file to allowed path first
• Use CLI instead

How do I fix “Outside Sandbox” errors?

Cause: Trying to access absolute path.

Solutions:

Use relative paths from ~:

• ~/Documents/file.txt
• ~/Caches/temp.dat

Why is my transfer stuck at 0%?

Solutions:

1. Check network

   • Switch between WiFi and cellular
   • Try downloading smaller file first

2. Restart transfer

   • Cancel current transfer
   • Start again

3. Check storage space

   • Settings > General > iPhone Storage

How do I fix push notification issues?

Why am I not receiving push notifications?

Symptoms:

• No wake notifications
• No alerts

Solutions:

1. Check notification settings

   • Settings > Notifications > CMDOP
   • Enable all notification types

2. Check Focus mode

   • Disable Do Not Disturb
   • Add CMDOP to allowed apps

3. Re-register push token

   • Sign out and sign in again

Why is push wake not working?

Symptoms:

• Push received but app doesn’t wake

Causes:

• iOS restrictions on background execution
• Battery optimization

Solutions:

1. Disable Low Power Mode
2. Keep app recently used
3. Wait up to 30 seconds for wake

How do I fix performance issues?

Why is the app draining my battery?

Cause: Frequent background refresh.

Solutions:

1. Reduce refresh frequency

   • The app refreshes every 15 minutes minimum
   • This is the iOS minimum

2. Disconnect unused sessions

3. Disable Live Activities

   • Settings > Security > Live Activities

Why is the terminal response slow?

Causes:

• Network latency
• Server load

Solutions:

1. Check network quality

   • Run speed test
   • Try different network

2. Check server load

   # Check server load average and uptime
   uptime

How do I reduce high memory usage?

Solutions:

1. Close unused sessions
2. Restart the app
3. Update to latest version

What do the error codes mean?

How do I debug the app?

How do I view app logs?

For development builds:

1. Connect iPhone to Mac
2. Open Console.app
3. Select your device
4. Filter by “CMDOP”

How do I test background tasks?

For developers testing background tasks:

# In LLDB, simulate a background refresh task launch
e -l objc -- (void)[[BGTaskScheduler sharedScheduler] _simulateLaunchForTaskWithIdentifier:@"com.cmdop.mobile.refresh"]

# Simulate task expiration to test cleanup behavior
e -l objc -- (void)[[BGTaskScheduler sharedScheduler] _simulateExpirationForTaskWithIdentifier:@"com.cmdop.mobile.refresh"]

How do I debug network issues?

Enable network logging:

1. Settings > Debug (if available)
2. Enable verbose logging
3. Reproduce issue
4. Export logs

Where can I get help?

If issues persist:

1. Check status page: status.cmdop.com
2. Community: discord.gg/cmdop
3. Support: [email protected]

Include:

• App version (Settings > About)
• iOS version
• Device model
• Error message or screenshot
• Steps to reproduce