LDAPWeb/Ollama/docs/guide/migration.md

Migration Guide — Ollama VM

Owner: prosedur pindah Ollama ke host/IP baru. Inventori: ../server.md. Env: ../../.env.example.

Prinsip: ubah OLLAMA_BASE_URL di consumer — bukan hardcode di kode.

---

Inventori sebelum migrasi

Item	Nilai saat ini	File yang diupdate
Ollama host	10.100.1.26 (aiopr)	Ollama/docs/server.md, .env.example
API URL	http://10.100.1.26:11434	geonet-console .env di .24
Model path	/data/ollama/models	systemd override
UFW	11434 dari 10.100.1.0/24	server UFW rules

---

Variabel env terpengaruh

Variabel	Old	New	Lokasi
OLLAMA_BASE_URL	http://10.100.1.26:11434	{new}	geonet-console .env
OLLAMA_HOST	0.0.0.0:11434	(sama)	systemd .26

---

Langkah migrasi VM

1. Persiapan VM baru

   • Ubuntu 22.04 Server, vCPU ≥ 16, RAM ≥ 32 GiB
   • Install Ollama + buat /data/ollama/models
   • UFW: 22 + 11434 dari VLAN saja

2. Salin model (pilih salah satu)

   • rsync -av /data/ollama/models/ ke VM baru, atau
   • ollama pull ulang di VM baru

3. Parallel test

   • curl /api/version dari .24
   • Chat + embed smoke test

4. Cutover consumer

   • Update OLLAMA_BASE_URL di geonet-console .env
   • Restart container geonet-console

5. Dokumentasi

   • Update Ollama/docs/server.md, Workspace-Context.md
   • Append version.md + changelog.md

---

Rollback

1. Kembalikan OLLAMA_BASE_URL ke IP lama
2. Restart consumer
3. Catat di issues.md

---

Riwayat migrasi

Tanggal	Dari	Ke	Catatan
—	—	—	Belum ada migrasi