O Replikanto atualiza automaticamente ou o usuário precisa fazer algo para atualizá-lo?

A partir do Replikanto 1.7.0.0, o Replikanto pode se atualizar com um clique: quando uma nova versão estiver disponível para a sua licença, a notificação de atualização mostra o botão Atualizar agora (Update now), que baixa, confere e instala a nova versão para você. Ele nunca se atualiza sem o seu clique, e você ainda precisa reiniciar o NinjaTrader para começar a usar a versão nova. Se você usa o Replikanto 1.6.1.7 ou anterior, instale o 1.7.0.0 manualmente uma única vez; depois disso, o Atualizar agora passa a estar disponível. Este artigo explica como o Atualizar agora funciona, o que fazer se o botão não aparecer ou se a atualização automática falhar, e como atualizar manualmente.

O Replikanto atualiza automaticamente?

A partir do Replikanto 1.7.0.0, sim, com um clique, mas só quando você decidir. Quando uma nova versão estiver disponível para a sua licença, a janela Notificação de Atualização de Produto da FlowBots (FlowBots Product Update Notification) aparece no NinjaTrader com a mensagem Uma nova versão "X" do seu produto "Replikanto" está disponível. Ao clicar em Atualizar agora, o Replikanto baixa a versão, confere se ela foi assinada pela FlowBots e a instala. Não há download pelo navegador, nem passo de Ferramentas > Importar, nem recompilação de NinjaScript. Em seguida você reinicia o NinjaTrader para concluir a atualização; o NinjaTrader não abre de novo sozinho.

Replikanto 1.6.1.7 ou anterior: a notificação dessas versões só tem o botão Baixar (Download). Instale o Replikanto 1.7.0.0 manualmente uma vez (veja Atualizar manualmente abaixo). Do 1.7.0.0 em diante, as próximas versões podem ser instaladas com o Atualizar agora.
Outros produtos FlowBots (ScalperTicket, AveragePrice, AveragePriceIndicator) não têm o botão Atualizar agora. Eles continuam sendo atualizados pelos passos manuais.
Os clientes também recebem um e-mail com os detalhes de cada nova versão do Replikanto.

Por que atualizar

Rodar uma versão antiga pode causar problemas, entre eles:

Erros de conexão com os servidores de licença
Bugs que já foram corrigidos em uma versão mais nova
Ausência de funcionalidades e melhorias
No Replikanto 1.6.1.7 ou anterior, o complemento deixar de carregar depois que você atualiza o próprio NinjaTrader. A partir do Replikanto 1.7.0.0, um único build do Replikanto roda em todas as versões do NinjaTrader 8, então uma atualização do NinjaTrader não causa mais isso.

Verifique qual versão você está usando

Abra o NinjaTrader 8 e selecione NEW > FlowBots > Replikanto. O número da versão do Replikanto aparece no título da janela.
Como alternativa, clique com o botão direito na janela do Replikanto, selecione Propriedades... (Properties...) e leia o número da versão na parte inferior da janela.

As notas de todas as versões do Replikanto ficam publicadas na página de notas de versão do Replikanto, então dá para comparar com o que está instalado na sua máquina. A própria notificação de atualização também tem o link O que há de novo nesta versão (What's new in this version).

Como atualizar com o Atualizar agora (Replikanto 1.7.0.0 e posteriores)

Quando a janela Notificação de Atualização de Produto da FlowBots aparecer, clique em Atualizar agora.
Aguarde enquanto a janela mostra Baixando a atualização... N%, depois Verificando o download... e depois Instalando.... Os outros botões ficam desabilitados nesse meio-tempo.
Quando a janela disser A versão X de "Replikanto" está pronta. Reinicie o NinjaTrader para concluir a atualização., clique em Fechar o NinjaTrader (Close NinjaTrader). O NinjaTrader fecha do mesmo jeito que pelo próprio botão de fechar: a confirmação de saída e o pedido para salvar o workspace continuam aparecendo, e você pode cancelar.
Abra o NinjaTrader novamente. Ele não abre de novo sozinho.
Abra o Replikanto e confira o número da nova versão no título da janela.

O download e a instalação não afetam a sessão em andamento: o NinjaTrader continua rodando a versão anterior até ser reiniciado. Reinicie quando não houver posições abertas nem ordens ativas.

O que a atualização altera e o que ela mantém

Só os arquivos de programa do Replikanto são substituídos (Replikanto.dll e os arquivos do idioma português, em Documents\NinjaTrader 8\bin\Custom).
O seu workspace, as contas seguidoras e as configurações do Replikanto não são tocados, e o seu arquivo personalizado de Cross Order (ReplikantoCrossOrderRelationship.json) nunca é sobrescrito.
Se você usa o build Compliance Mode, o Atualizar agora instala a versão Compliance Mode.
Se algo der errado durante a instalação, o Replikanto restaura os arquivos anteriores, e a sua instalação continua como estava.

Se você clicar em Depois

Antes de clicar em Atualizar agora: nada é instalado. O Replikanto verifica se há uma nova versão quando o NinjaTrader inicia, somente depois que a sua licença foi ativada, e consulta o servidor da FlowBots no máximo uma vez a cada 5 horas. Por isso, se você reiniciar o NinjaTrader logo depois de clicar em Depois (Later), a janela pode não aparecer de novo até passarem essas 5 horas. Você também pode atualizar manualmente a qualquer momento.
Depois que a atualização ficou pronta: a nova versão continua instalada no disco e é carregada na próxima vez que o NinjaTrader reiniciar. Feche e abra o NinjaTrader quando for conveniente.
Se você cancelar a confirmação de saída do NinjaTrader depois de clicar em Fechar o NinjaTrader, a atualização também fica pronta para o próximo reinício. Se aparecer Não foi possível fechar o NinjaTrader automaticamente. Feche e abra novamente para concluir a atualização., feche e abra o NinjaTrader você mesmo.

"Não mostrar esta mensagem novamente"

Essa opção (Do not show this message again) silencia a notificação apenas para a versão que ela anunciou, exceto quando a sua versão do Replikanto não é mais suportada (veja a próxima seção). Quando uma versão mais nova for lançada, a janela volta a aparecer. Até lá, você ainda pode atualizar manualmente.

Quando a sua versão do Replikanto não é mais suportada

A FlowBots pode deixar de dar suporte a uma versão antiga do Replikanto. A partir do Replikanto 1.7.0.0, quando a versão que você usa não é mais suportada, o Replikanto mostra esta mensagem:

Esta versão do Replikanto não é mais suportada pelos servidores do Replikanto, por isso o Replikanto foi desativado neste computador e não pode copiar operações. Atualize o Replikanto para a versão mais recente: se houver uma atualização disponível, a janela de atualização será aberta; caso contrário, baixe-a no portal da FlowBots. Em seguida, reinicie o NinjaTrader. Se o problema persistir, entre em contato com o suporte da FlowBots pelo e-mail support@flowbots.ninja.

Em inglês, a mesma mensagem começa com This version of Replikanto is no longer supported by the Replikanto servers. Depois de mostrar a mensagem, o Replikanto para de copiar operações e fecha todas as janelas dele. As posições e ordens que já estavam abertas nas contas seguidoras continuam abertas, e as saídas do líder deixam de ser copiadas para elas: confira as contas seguidoras no NinjaTrader e feche ou ajuste o que ainda estiver aberto. Para voltar a usá-lo, atualize o Replikanto:

Quando houver uma versão mais nova disponível para a sua licença, a janela Notificação de Atualização de Produto da FlowBots abre, mesmo que você tenha marcado Não mostrar esta mensagem novamente (Do not show this message again). Clique em Atualizar agora e depois reinicie o NinjaTrader, como explicado acima.
Se a janela não abrir, ou se não for possível atualizar pelo Atualizar agora, atualize manualmente (veja Atualizar manualmente abaixo) e depois reinicie o NinjaTrader.
Enquanto o Replikanto não for atualizado, abri-lo de novo (Novo > FlowBots > Replikanto, em inglês New > FlowBots > Replikanto) mostra a mesma mensagem e a janela de atualização outra vez.

Não aparece o botão Atualizar agora?

Você usa o Replikanto 1.6.1.7 ou anterior. O botão só existe a partir do 1.7.0.0. Instale o 1.7.0.0 manualmente uma vez.
Nenhuma notificação aparece. A notificação só aparece quando uma nova versão está disponível para a sua licença, somente depois que a licença foi ativada nesta máquina, e no máximo uma vez a cada 5 horas. Você pode conferir a versão mais recente na página de notas de versão e atualizar manualmente.
A notificação mostra só o botão Baixar. A atualização automática não está disponível para essa versão na sua instalação. Use Baixar e siga os passos manuais.
Você está atualizando outro produto FlowBots. Só o Replikanto tem o Atualizar agora.
Várias máquinas. Cada computador se atualiza separadamente: o líder e cada seguidor remoto (rede local ou internet) recebem a sua própria notificação. Mantenha o líder e os seguidores remotos na mesma versão do Replikanto.

Se a atualização automática falhar

A janela mostra A atualização automática falhou: <motivo> Use o botão de download para atualizar manualmente. O motivo aparece sempre em inglês, mesmo com o NinjaTrader em português. Em todos os casos a sua instalação atual continua como estava, e você pode clicar em Baixar e seguir os passos manuais abaixo.

Motivo exibido (em inglês)	O que fazer
The update could not be downloaded. ... / The update download timed out after 5 minutes.	Confira a sua conexão com a internet. Um firewall, proxy ou antivírus pode estar bloqueando `flowbots.ninja`. Tente de novo mais tarde ou atualize manualmente.
The downloaded update is incomplete.	O download foi interrompido. Tente de novo.
The downloaded update failed its integrity check.	O arquivo chegou danificado. Tente de novo; se acontecer outra vez, atualize manualmente e avise o suporte da FlowBots.
The downloaded update is not signed by FlowBots.	O Replikanto recusou o arquivo para a sua segurança. Não tente contornar: baixe o Replikanto na página de downloads da sua conta FlowBots e avise o suporte da FlowBots.
The update package contains version X but the server announced Y. / The update package's version could not be read. / The update package is missing ... / The update package contains an invalid entry. / The update package could not be opened.	Atualize manualmente e avise o suporte da FlowBots.
The update package is the regular build but this installation is the 'cm' build. (ou o inverso)	Baixe o .zip do build que você usa (regular ou Compliance Mode), instale manualmente e avise o suporte da FlowBots.
A previous update of Replikanto.dll is still in use. Restart NinjaTrader and try again.	Feche todas as janelas ou instâncias abertas do NinjaTrader, abra o NinjaTrader de novo e tente outra vez.
Replikanto.dll could not be written. / ... could not be copied correctly.	O arquivo está bloqueado, normalmente por um antivírus ou pelo OneDrive sincronizando a pasta `Documents\NinjaTrader 8`. Exclua essa pasta e tente de novo, ou atualize manualmente.
An update is already in progress.	A atualização foi iniciada duas vezes. Aguarde a primeira terminar.

Ao falar com o suporte, inclua as linhas da aba Log da Central de Controle do NinjaTrader que começam com Replikanto: Automatic update to version. Se o log disser The installation could not be fully restored. Please reinstall the add-on manually., reinstale o Replikanto pelos passos manuais abaixo.

Atualizar manualmente (1.6.1.7 ou anterior, ou como alternativa)

Use estes passos para ir do Replikanto 1.6.1.7 ou anterior para o 1.7.0.0 (uma única vez), quando o botão Atualizar agora não aparecer, ou quando a atualização automática falhar.

Acesse a página de downloads da sua conta FlowBots e faça login.
Baixe o arquivo .zip mais recente do Replikanto. A partir do Replikanto 1.7.0.0 existe um único arquivo para todas as versões do NinjaTrader 8 (e um arquivo Compliance Mode separado para quem usa esse build). Não descompacte o arquivo zip.
No NinjaTrader, vá em Ferramentas > Importar > Complemento de NinjaScript... (Tools > Import > NinjaScript Add-On...) e selecione o arquivo .zip que você baixou.
Aceite todas as confirmações que aparecerem. Clique em Sim mesmo que o NinjaTrader informe que já existe uma versão mais nova instalada.
Reinicie o NinjaTrader por completo para concluir a instalação.

O NinjaTrader publicou um vídeo tutorial sobre esse processo de importação, que é o mesmo tanto para instalar quanto para atualizar.

Na primeira vez que você abrir o Replikanto 1.7.0.0 vindo de uma versão anterior, os layouts de colunas salvos das grades do Replikanto (largura, ordem, visibilidade e ordenação) voltam ao padrão uma única vez. As suas seguidoras e as demais configurações são mantidas.

Depois de atualizar o próprio NinjaTrader

A partir do Replikanto 1.7.0.0, um único build do Replikanto roda em todas as versões do NinjaTrader 8, então atualizar o NinjaTrader não exige reinstalar o Replikanto. Se você ainda usa o Replikanto 1.6.1.7 ou anterior e ele parou de carregar depois de uma atualização do NinjaTrader, instale o Replikanto mais recente uma vez pelos passos manuais acima.

Problemas depois da atualização

Erros de licença. Verifique se o seu Machine ID continua registrado corretamente na sua conta e se o firewall não está bloqueando os servidores de licença.
O Replikanto não aparece na Central de Controle, ou o NinjaTrader informa que o complemento não foi encontrado. No Replikanto 1.6.1.7 ou anterior, isso costuma acontecer depois de uma atualização do NinjaTrader: instale o Replikanto mais recente pelos passos manuais acima. O procedimento completo está em Replikanto stops loading after a NinjaTrader upgrade (version mismatch) (em inglês). Confira também se o OneDrive não está sincronizando a pasta Documents\NinjaTrader 8.
A versão antiga continua rodando. A nova versão só é carregada quando o NinjaTrader reinicia, tanto depois do Atualizar agora quanto depois de uma importação manual. Confirme que você fechou e abriu o NinjaTrader por completo e verifique novamente a versão no título da janela do Replikanto.