#ica-atom

Instalar e utilizar o ICA-AtoM pode parecer difícil em um primeiro momento, mas, seguindo corretamente os passos que vou descrever abaixo, vai se tornar bem simples!

Para você conseguir ter o ICA-AtoM instalado em sua máquina, é necessário fazer a instalação de dois programas. Além disso, você precisará seguir os passos na ordem correta desta publicação. Então, vamos para o primeiro passo:

Antes de tudo: verifique se a sua máquina atende aos requisitos operacionais para utilizar o AtoM! O computador necessita ter, no mínimo, 2Gb de memória RAM e 8Gb de espaço em disco. Não faz ideia de como descobrir quanto de memória RAM tem o seu computador? Clique aqui!  Também não sabe como verificar quanto espaço sobrando tem em seu disco rígido? Clique aqui! 

1) Acessar o site do AtoM

Vamos acessar o site do AtoM para que, através dele, possamos seguir os links corretos. Você pode acessar o site clicando aqui. Note que, até o momento desta publicação, a versão mais atual do AtoM é a 2.5. Então, é sempre bom dar uma conferida no lado direito da tela onde está escrito “Documentação disponível”, pois, é lá que vai estar disponível a documentação de todas as versões do AtoM. Caso a última seja a 2.5, então você entrou no link correto por aqui no blog :)

2) Baixar e instalar o VirtualBox

No próprio site que você entrou, do AtoM, existe um link que te dá acesso ao site do VirtualBox. É só clicar lá! Caso você tenha pulado o primeiro passo (eu disse para não pular né? haha), você pode acessar clicando aqui. O VirtualBox é um software de código aberto que é capaz de criar um ambiente virtual que simula um outro ambiente. Mas, então, agora você está se perguntando por que é necessário fazer toda essa virtualização, não? Utilizando o VirtualBox, é possível criar um ambiente eficaz de utilização do AtoM, com todos os requisitos necessários para rodar no seu computador. Enfim, vamos lá instalar o VirtualBox! É só clicar no botão “Download VirtualBox”:

Em seguida, selecione qual o seu sistema operacional. No meu caso, é o Windows, então eu vou clicar em “Windows hosts”.

Depois de finalizado o download, abra o arquivo executável para começar a instalação. Clique em “Next” para continuar:

Clique em “Next” novamente para instalar todo o conteúdo no disco rígido:

Você pode desmarcar e marcar as opções desejadas nessa tela. A primeira é para criar acesso no menu iniciar, a segunda é para criar um atalho na área de trabalho, a terceira é para criar um atalho na barra de início rápido e, por fim, a última é para associar o registro dos arquivos. Particularmente, prefiro selecionar apenas a primeira e a última opções:

O instalador irá avisar que, para instalar o VirtualBox, sua rede irá ser resetada e, consequentemente, você será desconectado, então, assim que terminar sua conexão será restabelecida automaticamente. Para prosseguir, clique em “Yes”:

Enfim, esse será o último passo, caso queira alterar alguma coisa antes da instalação, clique em “Back”, senão, é só clicar em “Install” e a instalação começará!

É possível que o Windows mostre uma mensagem perguntando se você deseja que o aplicativo faça alguma alteração, clique em “Sim” e caso apareça mais uma mensagem da Segurança do Windows, permita clicando em “Instalar”:

Espere um momento e, pronto! A instalação foi concluída. Deixe selecionada a opção para já rodar o VirtualBox assim que você clicar em terminar no botão “Finish”.

3) Baixar e instalar o Vagrant

Bom, esse foi o primeiro passo! Agora vamos instalar o Vagrant para podemos utilizar o ICA-AtoM! O Vagrant é uma ferramenta  que vai possibilitar outras pessoas acessarem o ICa-AtoM através do seu computador, ou seja, ele transformará o seu computador como se fosse em uma central onde outros computadores (conectados na mesma rede) poderão trabalhar no ICA-AtoM. Imagine você chegar em uma empresa para uma assessoria e precisa que outras pessoas acessem o AtoM para trabalhar. Com o Vagrant, você compartilhando o endereço da sua máquina, qualquer computador conectado na mesma rede poderá acessar e agilizar o trabalho! 

 Volte lá no site do AtoM para pegar o link do Vagrant ou basta clicar aqui. Ao abrir o site do Vagrant, clique em “Download” que será instalada a versão mais recente. No meu caso, aqui é a 2.2.4.

Na página seguinte, você precisa instalar a versão correta do Vagrant para o seu Windows. Mas, como saber qual é o tipo do sistema do seu Windows? Basta clicar com o botão direito no menu Iniciar e, em seguida, na opção “Sistema” ou clicar aqui para ir para a página de ajuda da Microsoft. Eu fiz da seguinte forma:

Você vai encontrar essa informação bem na área de especificações do dispositivo. No meu caso o tipo do meu sistema operacional é o de 64bits:

Então, lá no site do Vagrant eu vou clicar no link de 64bits abaixo do ícone do Windows:

Ao clicar, o download vai iniciar. Espere um pouco, dependendo da velocidade da sua conexão… quem sabe dá tempo de tomar um cafézinho? Terminando o download, é só clicar para abrir o instalador. Os passos de instalação vão ser bem parecidos com o do VirtualBox. Clique em “Next” para prosseguir a instalação:

Leia os termos da licença e clique no check para aceitá-los e, em seguida, clique em “Next”:

Nessa parte, você pode escolher um outro lugar para o Vagrant ser instalado, caso não queira, basta clicar em “Next”:

É isso! Agora prepare-se para a instalação! Clique em “Install” e irá aparecer uma mensagem do Windows perguntando se você permite realizar essa instalação em sua máquina.

Ao terminar a instalação, será necessário reiniciar o computador. Então, não esqueça de salvar e fechar tudo que estava aberto e clique em “Yes”. Caso não queira reiniciar agora, é só clicar em “No”, mas o Vagrant só irá funcionar depois que o computador for reiniciado, hein…

4) Rodando o ICA-AtoM

Pronto! Depois de reiniciar o computador, estamos quase terminando! Agora falta pouquinho e vamos dar uma de “hacker” acessando o prompt de comando do Windows! Brincadeira… Para acessar o prompt de comando, você pode fazer dessas formas:

1) Segurar a tecla “Windows” + a tecla R - irá abrir o Executar do sistema. Quando abrir, é só digitar “cmd” (sem as aspas) e clicar em “OK”.

2) Botão direito em cima do menu Iniciar - escolha a opção “Prompt de Comando”

Também tem a opção de clicar no menu Iniciar e pesquisar por “Prompt de Comando”.

Nele, nós vamos criar um diretório para o ICA-AtoM e, em seguida, vamos finalmente colocá-lo para rodar. Então, com ele aberto, digite o seguinte comando (é preciso fazer nessa ordem, é muito importante!):

mkdir atom-vagrant && cd atom-vagrant

Mas, então, agora você me pergunta o que significa isso, né? “mkdir” é um comando para criar um diretório (uma pasta) chamado atom-vagrant, o “&&” quer dizer, que logo após criar o diretório, será realizado mais um comando, que no caso é “cd” (trocar/abrir o diretório desejado). O nome do diretório será “atom-vagrant”, mas você pode alterar o nome para o que você quiser, sendo assim, é só você substituir nos próximos passos o que estiver escrito “atom-vagrant” para o nome do diretório que você escolheu criar. Vale lembrar que, para o sistema realizar o comando, basta você apertar a tecla “enter” do seu teclado.

Agora, vamos fazer com que esse diretório que nós criamos “atom-vagrant” seja inicializado como o ambiente Vagrant para rodar o ICA-AtoM utilizando a seguinte linha de comando:

vagrant init artefactual/atom

Antes de dar “enter” na linha de comando, certifique-se que você realmente está dentro do diretório que você criou, como estou mostrando na figura a seguir:

Quando você mandar o sistema realizar esse comando, espere um pouco, pois ele vai fazer a inicialização e mostrará a seguinte mensagem dizendo que o arquivo foi colocado na pasta e que estamos prontos para rodar.

Agora que colocamos o Vagrant nesse diretório, vamos rodar para, finalmente, abrir o ICA-AtoM. Insira a seguinte linha de comando:

vagrant up

Ao dar o comando, vai demorar mais um pouquinho para tudo finalizar, quando estiver pronto, você vai ver essa mensagem:

Pronto! Agora é só acessar o ICA-AtoM através do endereço a seguir e você está pronto para usar:

http://10.10.10.10/

Como é a sua primeira vez, o seu acesso é

Username: [email protected]

Password: demo

Não se esqueça de criar um usuário para você com as permissões máximas de administrador e excluir esse usuário de acesso padrão, pois, como vimos, todo o primeiro acesso ao ICA-AtoM é através desse login e dessa senha. Então, qualquer pessoa pode tentar acessar!

Enfim, é isso! Conseguimos terminar e espero que você também tenha conseguido seguindo todos esses passos. Toda vez, antes de você utilizar o ICA-AtoM e compartilhá-lo para que outros computadores possam acessar através da sua máquina, abra o Prompt de Comando e rode o vagrant através da última linha de comando que nós colocamos anteriormente:

vagrant up