OpenADS — Documentação (Português)
OpenADS é uma implementação livre e clean-room de um motor
de banco de dados compatível com ADS. Funciona como
substituto direto do Advantage Client Engine (ace32.dll /
ace64.dll / libace.so) — aplicações Harbour / Clipper que
fazem link com contrib/rddads continuam funcionando sem
recompilar.
Release atual: v1.8.2.
Conteúdo
- Novidades — resumo das mudanças desde v1.0.0-rc29 → v1.8.2 (padding OrdScope, colação NTXPL852, e mais).
- História do projeto — como o OpenADS cresceu de um esqueleto mínimo até um motor completo compatível com ADS (868 commits).
- Migrando do ADS — mapear uma instalação Advantage para OpenADS; rollback (erro CDX 7017), porta 6262, Studio.
- Como contribuir — build, PRs, política de protocolo paralelo e checklist.
- Primeiros passos — instalação, primeiro build, smoke test.
- Arquitetura — arquitetura de cinco camadas (ABI / Sessão / SQL / Motor / Plataforma).
- Protocolo wire — spec do wire TCP / TLS nativo OpenADS (frame, opcodes, payload, erros, versionamento). Disponível em inglês.
- Dicionário de dados — formato
.addclean-room + APIengine::DataDict+ superfície REST. - Studio (console web) — administração do motor a partir de qualquer navegador (modo Remote Server ou LocalServer).
- Benchmarks — SQL local + AOF (Rushmore) + repaint xbrowse sobre o wire.
- Compat rddads / X# RDD — superfície de
compatibilidade Harbour
contrib/rddadse X#AXDBFCDX(rc19 M12.22 / M12.23). - Backend SQLite — abrir e operar um banco
de dados SQLite via ACE / rddads com uma URI
sqlite://. - Stored procedures — procedimentos AEP
personalizados (DLL/SO externa) e os procedimentos
sp_*integrados do Data Dictionary. - Cookbook — exemplos Harbour executáveis e comentados (trilhas console + ORM), de simples a avançado.
- Implantação como serviço — rodar
openads_serverdcomo serviço Windows / unit systemd / launchd plist (rc14). - Implantação TLS — terminar HTTPS na frente do Studio com Caddy / nginx / stunnel / túnel SSH.
- Compatibilidade de ordinais — resolver o erro Win “ordinal NNN não encontrado” quando a import table da app referencia ordinais SAP.
- Referência da API — 357 funções
Ads*exportadas porace64.dll/libace.so(conexões, tabelas, índices, SQL, Data Dictionary, cifra, telemetria). - Issues conhecidos — items em aberto. Disponível em inglês.