mirror of
https://github.com/GNS3/gns3-server.git
synced 2026-08-27 20:40:13 +03:00
292b60efaa
- Move fastmcp from core requirements.txt to mcp-requirements.txt - Add MCP_AVAILABLE feature flag in agent/__init__.py (graceful degradation) - Guard MCP imports/registration in server.py and tasks.py - Replace ai-copilot/mcp/ai-support extras with single ai-features extra - Add stub MCP routes returning 501 when MCP is not installed - Add gns3server-uninstall-ai-features CLI command - Remove old gns3server-uninstall-ai-copilot command - Update all error messages and docs to reference ai-features Closes #2794
147 lines
2.7 KiB
Markdown
147 lines
2.7 KiB
Markdown
# Ubuntu 24.04 GNS3 Development Environment Setup
|
|
|
|
## Simplified Development Environment Setup
|
|
|
|
### 1. Add PPA
|
|
|
|
```bash
|
|
sudo apt update
|
|
sudo apt install software-properties-common
|
|
sudo add-apt-repository ppa:gns3/ppa
|
|
sudo apt update
|
|
```
|
|
|
|
### 2. Install Dependencies
|
|
|
|
Binary tools (Dynamips, VPCS, uBridge, etc.) are automatically installed as gns3-server dependencies
|
|
|
|
```bash
|
|
sudo apt install gns3-server tshark
|
|
```
|
|
|
|
### 3. Remove gns3-server While Keeping Dependencies
|
|
|
|
If you only want to run the server from source:
|
|
|
|
```bash
|
|
# Remove main package only, keep dependencies
|
|
sudo apt remove gns3-server
|
|
|
|
# Mark dependencies as manual to prevent autoremove deletion
|
|
sudo apt-mark manual ubridge dynamips vpcs libvirt
|
|
```
|
|
|
|
### 4. Install and Start Docker
|
|
|
|
```bash
|
|
sudo apt install docker.io
|
|
sudo systemctl enable --now docker
|
|
```
|
|
|
|
#### Configure Docker Mirror Accelerator (China Mainland)
|
|
|
|
If Docker Hub is inaccessible, configure mirror accelerators:
|
|
|
|
```bash
|
|
sudo mkdir -p /etc/docker
|
|
sudo tee /etc/docker/daemon.json <<'EOF'
|
|
{
|
|
"registry-mirrors": [
|
|
"https://docker.1ms.run",
|
|
"https://docker.xuanyuan.me"
|
|
]
|
|
}
|
|
EOF
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl restart docker
|
|
```
|
|
|
|
Verify:
|
|
|
|
```bash
|
|
docker info | grep -i mirror
|
|
```
|
|
|
|
### 5. Add User to Groups
|
|
|
|
```bash
|
|
# If running as gns3 user (created by PPA install):
|
|
sudo usermod -aG ubridge,docker,kvm gns3
|
|
|
|
# If running as your own user, add yourself to these groups:
|
|
sudo usermod -aG ubridge,docker,kvm $USER
|
|
|
|
# Then logout and login again for group membership to take effect
|
|
```
|
|
|
|
### 6. Install Python venv
|
|
|
|
```bash
|
|
sudo apt install python3.12-venv
|
|
```
|
|
|
|
### 7. Run Development Version from Source
|
|
|
|
Clone the repository (official or your fork):
|
|
|
|
```bash
|
|
# Official repository
|
|
git clone https://github.com/GNS3/gns3-server.git
|
|
|
|
# Or your forked repository
|
|
git clone https://github.com/yourname/gns3-server.git
|
|
cd gns3-server
|
|
git checkout your-branch
|
|
```
|
|
|
|
Setup virtual environment and install dependencies:
|
|
|
|
```bash
|
|
python3 -m venv venv
|
|
source venv/bin/activate
|
|
|
|
# For China mainland users, use mirror:
|
|
# pip install -e . -i https://mirrors.aliyun.com/pypi/simple/
|
|
|
|
pip install -e . && gns3server-web-wireshark-setup
|
|
pip install -e .[ai-features]
|
|
pip install -e .[dev]
|
|
```
|
|
|
|
Run the server:
|
|
|
|
```bash
|
|
python3 -m gns3server
|
|
```
|
|
|
|
## Optional: Install AI Features Development Dependencies
|
|
|
|
```bash
|
|
python3 -m pip install .[ai-features,dev]
|
|
```
|
|
|
|
## Optional: Expand LVM Root Partition
|
|
|
|
If the root partition is low on space but the volume group has unallocated space:
|
|
|
|
Check LVM status:
|
|
|
|
```bash
|
|
sudo lvm pvdisplay
|
|
sudo lvm vgdisplay
|
|
sudo lvm lvdisplay
|
|
```
|
|
|
|
Extend the root LV using all free space:
|
|
|
|
```bash
|
|
sudo lvm lvextend -l +100%FREE /dev/mapper/ubuntu--vg-ubuntu--lv
|
|
sudo resize2fs /dev/mapper/ubuntu--vg-ubuntu--lv
|
|
```
|
|
|
|
Verify:
|
|
|
|
```bash
|
|
df -h
|
|
```
|