Primeiro início e licença
O UltraGX precisa de uma licença para executar o motor. Na primeira vez que você abre o aplicativo sem licença, aparece o formulário Comece sua demo de 10 dias. A partir dele você pode pedir a demo ou, se já comprou a edição completa, usar o seu código.

Pedir a demo
- Preencha o formulário. São obrigatórios Nome, Sobrenome, Empresa e E-mail da empresa; o restante (Cargo, País, Telefone, Versão do GeneXus, Objetos na Knowledge Base) nos ajuda a preparar a conversa sobre a migração.
- Use o e-mail da sua empresa. A demo é entregue a empresas que estão avaliando uma migração e o serviço recusa e-mails pessoais (Gmail, Outlook, Hotmail, Yahoo, iCloud e similares).
- Clique em Enviar o código. Em alguns minutos chega um e-mail com um código de seis dígitos.
- Digite o código e clique em Ativar a demo. O código vale por 15 minutos.

Se o e-mail não chegar, veja a pasta de spam. Se ele continuar sem aparecer, clique em Voltar e peça o código de novo (ou tente outro endereço da empresa).
Quando a demo fica ativa, o formulário se fecha e o aplicativo mostra o aviso Edição DEMO na barra superior.
O que a demo inclui
- 10 dias contados a partir da instalação naquela máquina. Reinstalar ou pedir outro código não reinicia o prazo.
- Uma demo por máquina e uma por e-mail.
- A KB completa é analisada e documentada no nível de inventário, modelo de dados, grafo, clusters, árvores de chamadas e diagramas. 25 objetos recebem o documento detalhado; o motor os escolhe entre os objetos de negócio mais conectados, distribuídos por tipo, para que a amostra seja representativa. Os mesmos 25 se mantêm mesmo que você execute a KB várias vezes.
- Cada execução precisa de internet para consultar o serviço de licenças. Se não houver conexão, a execução termina mesmo assim, mas sem objetos detalhados, e o aviso fica no README e no visualizador.
Ativar a edição completa
Quando você comprar a licença, vai receber um código no formato ULGX-XXXX….
- No primeiro início: no formulário, clique em Já tenho um código de licença, cole o código e clique em Ativar com um código.
- Com o aplicativo já em uso (por exemplo, ao passar da demo para a completa): vá em Configurações → Licença, cole o código em Código de ativação e clique em Ativar com um código. O campo URL do serviço de licenças deve ficar vazio, a menos que indiquemos outra coisa.
A ativação vincula a licença àquela máquina. Depois de ativada, a edição completa não volta a se conectar ao serviço.
Instalar um arquivo de licença
Em instalações sem acesso à internet, podemos entregar um arquivo ultragx.lic em vez de um código:
- Em Configurações → Licença, copie o Id desta máquina e envie-o para nós.
- Quando receber o arquivo, clique em Instalar arquivo de licença… e selecione-o.
O arquivo fica em %APPDATA%\UltraGX\ultragx.lic (Windows) ou ~/.config/UltraGX/ultragx.lic (Linux e macOS).

Ver o status da licença
Configurações → Licença mostra:
| Campo | O que significa |
|---|---|
| Status | válida, ou o motivo pelo qual não é |
| Edição | DEMO com a quantidade de objetos detalhados e o serviço que consulta, ou completa |
| Titular | empresa e e-mail para os quais foi emitida |
| Expira | data de vencimento, ou nunca |
| Arquivo de licença | onde está instalada |
| Id desta máquina | identificador usado para vincular a licença |
Mensagens do registro e da ativação
| Mensagem | Causa | O que fazer |
|---|---|---|
| Use o e-mail da sua empresa… | Você informou um e-mail pessoal | Registre-se com o endereço da empresa |
| Este e-mail já ativou uma demo… | Esse e-mail já foi usado | Escreva para contact@ultra-gx.com se precisar de mais tempo |
| O período de demo nesta máquina terminou… | Os 10 dias se passaram | Escreva para nós para seguir com a edição completa |
| Código incorreto… | O código não confere | Confira o último e-mail recebido e digite-o de novo |
| O código expirou… | Passaram-se mais de 15 minutos | Voltar e pedir um novo |
| Códigos incorretos demais… | Cinco tentativas com erro | Voltar e começar de novo |
| Tentativas demais nesta rede… | Muitas solicitações seguidas a partir da mesma rede | Espere um pouco e tente de novo |
| Confira os campos… | Falta um campo obrigatório ou ele não é válido | Preencha nome, sobrenome, empresa e um e-mail válido |
| Não foi possível contatar o serviço de licenças… | Sem internet, ou um proxy/firewall bloqueia licenses.ultra-gx.com | Verifique a conexão; em redes corporativas, peça que liberem HTTPS para licenses.ultra-gx.com |