View Software Reference Configuration Guide
System Requirements
Component | Specification |
---|---|
OS | Ubuntu 24.04 Server (minimal) |
User Account | Dedicated service user (view ) |
GPU Drivers | NVIDIA 560+ (installed separately) |
Network | SSH enabled, port 9000 accessible |
Dependencies | Build 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
Variable | Value | Purpose |
---|---|---|
Service User | view | Dedicated account for View services |
Installation Path | ~/View | Default installation directory |
Web Port | 9000 | HTTPS interface port |
Driver Version | nvidia-driver-560 | Minimum 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
Issue | Cause | Resolution |
---|---|---|
GPU driver failure | Secure Boot enabled | Disable Secure Boot in BIOS |
Service restart loops | Resource constraints | Check htop , df -h |
Network connectivity | Firewall/DNS | Verify port 9000, DNS resolution |
Installation timeout | Network bandwidth | Monitor download progress |
Can not login to the web console on port 9000 | Username and passwords are incorrect | Use 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/
Updated 7 days ago