View Software Reference Configuration Guide

System Requirements

ComponentSpecification
OSUbuntu 24.04 Server (minimal)
User AccountDedicated service user (view)
GPU DriversNVIDIA 560+ (installed separately)
NetworkSSH enabled, port 9000 accessible
DependenciesBuild tools, OpenGL libraries

Configuration Parameters

Hardware Configuration

  • Power: Verify PSU capacity meets GPU + system requirements
  • Cooling: Validate airflow across GPU heat sinks
  • Rack: Install per manufacturer specifications

Operating System Configuration

# OS Installation Options
- Ubuntu Server (minimized)
- SSH server: enabled
- Docker: DO NOT install (handled by View installer)
- User: create administrative account
# expand the default logical volume to fill available space 
# Alternatly review the Expanding Ubuntu Server Disk Space document on https://docs.view.io/
sudo lvextend -l +100%FREE -r /dev/mapper/ubuntu--vg-ubuntu--lv

User Account Setup

sudo adduser view
sudo usermod -aG sudo view

GPU Driver Configuration

# Development dependencies
sudo apt install pkg-config libglvnd-dev dkms build-essential \
  libegl-dev libegl1 libgl-dev libgl1 libgles-dev libgles1 \
  libglvnd-core-dev libglx-dev libopengl-dev gcc make

# NVIDIA driver installation
sudo add-apt-repository ppa:graphics-drivers/ppa
sudo apt update
sudo apt install nvidia-driver-560
sudo reboot

# Verification command
nvidia-smi

Installation Workflow

Pre-Installation Checklist

  • Hardware rack installed per manufacturer specs
  • GPU power and airflow verified
  • Ubuntu 24.04 minimal installation complete
  • Expand the Ubuntu disk space to use the available space.
  • SSH access configured
  • Docker NOT installed
  • View service user created
  • GPU drivers installed and verified
  • View platform account created at app.view.io
  • Expand or create the logical volume the View software will be installed on.

Installation Commands

# Switch to View user
su - view

# Execute unique installation command from app.view.io
[PASTE_INSTALLATION_COMMAND_HERE]

Post-Installation Verification

# Service status check
cd ~/View
./viewctl ps

# Expected output: All services in "running" state
# Troubleshoot: ./viewctl logs [service-name]

Access Configuration

  • Web Interface: https://[server-ip]:9000
  • Default Authentication: [email protected] / password

Configuration Variables

Environment Settings

VariableValuePurpose
Service UserviewDedicated account for View services
Installation Path~/ViewDefault installation directory
Web Port9000HTTPS interface port
Driver Versionnvidia-driver-560Minimum GPU driver version

System Paths

/home/view/View/          # Installation directory
/home/view/View/viewctl   # Service control binary

Validation Commands

System Health Checks

# GPU driver status
nvidia-smi

# Service status
./viewctl ps

# System resources
htop
df -h

# Network connectivity
curl -I https://app.view.io

Log Locations

# Service logs
./viewctl logs [service-name]

# System logs
journalctl -u view.service

# GPU driver logs
dmesg | grep nvidia

Configuration Dependencies

Package Dependencies

pkg-config libglvnd-dev dkms build-essential libegl-dev libegl1 
libgl-dev libgl1 libgles-dev libgles1 libglvnd-core-dev 
libglx-dev libopengl-dev gcc make

Repository Configuration

ppa:graphics-drivers/ppa  # NVIDIA driver repository

Troubleshooting Reference

Common Issues

IssueCauseResolution
GPU driver failureSecure Boot enabledDisable Secure Boot in BIOS
Service restart loopsResource constraintsCheck htop, df -h
Network connectivityFirewall/DNSVerify port 9000, DNS resolution
Installation timeoutNetwork bandwidthMonitor download progress
Can not login to the web console on port 9000Username and passwords are incorrectUse the default “[email protected]” and “password” values for the first login. Username and password are not synchronized with account.view.io

Diagnostic Commands

# GPU diagnostics
nvidia-smi
dmesg | grep nvidia
lsmod | grep nvidia

# Service diagnostics
./viewctl ps
./viewctl logs [service-name]
systemctl status [service-name]

# System diagnostics
htop
df -h
free -h
netstat -tlnp | grep 9000

Security Configuration

Access Controls

  • Service user with sudo privileges
  • HTTP on port 9000
  • Platform authentication via app.view.io

Firewall Considerations

# Required ports
22/tcp    # SSH
9000/tcp  # View web interface
443/tcp   # Outbound HTTPS to app.view.io

Maintenance Procedures

Regular Checks

  • GPU utilization monitoring
  • Service health validation
  • System resource monitoring
  • Platform connectivity verification

Update Procedures

  • Coordinate with View platform maintenance windows
  • Verify service status post-update

Integration Points

External Dependencies

  • app.view.io: Platform authentication and configuration
  • Ubuntu repositories: System packages

Configuration Files

  • Installation command contains organization-specific tokens
  • Service configuration managed by viewctl
  • GPU driver configuration in /etc/modprobe.d/