Configuração do Ambiente de Desenvolvimento do CITSmart no Linux
A configuração do produto CITSmart com o OS Linux é possível. Nesse documento será mostrado detalhadamente o passo-a-passo deste processo, desde a instalação do Ubuntu e todos os aplicativos necessários até o processo de integração propriamente dito.
Para começar o procedimento, é necessário fazer o download dos arquivos disponíveis no Google Drive https://drive.google.com/drive/folders/1k6f6NtvoAiTwDzQ6trNYHHWo3PSBh0zD
É necessário usar suas credenciais do Office 365 da CITSmart para ter acesso aos arquivos. Ao longo do procedimento, também será necessário ter acesso ao GIT com as credenciais da Central IT. Caso não possua, solicite ao seu gestor.
- Acesse a página web https://ubuntu.com/#download para fazer o download do Ubuntu. Clique no primeiro botão para baixar a versão Ubuntu Desktop. Lembre-se de sempre usar a versão mais recente.
- Após baixar o arquivo .iso, é necessário fazer o download do Rufus através do link https://rufus.ie/pt_BR/ para configurar um drive USB bootável.
- Além do Rufus e do arquivo .iso do Ubuntu, para criar um drive USB bootável também é necessário ter um flashdrive com no mínimo 4gb de armazenamento.
Para configurar o drive, siga o procedimento abaixo:
- Execute o Rufus.
- Insira o drive na máquina.
- O Rufus irá atualizar para se definir o dispositivo dentro do campo Dispositivo ou Device.
- Selecione o drive desejado entre as opções.
Dica: Para evitar a escolha de um dispositivo incorreto, tenha certeza que há apenas um dispositivo inserido na máquina
- Após selecionar o dispositivo, escolha a opção de inicialização. As opções serão Não inicializável e FreeDOS. Já que você está criando um dispositivo Ubuntu inicializável, selecione FreeDOS.
- Deixe as opções para Esquema de partição (MBR) e Sistema de destino (BIOS (ou UEFI-CSM)) como padrão.
- Clique no botão SELECT ao lado da opção Boot Selection, procure o arquivo .iso do Ubuntu e clique em Abrir.
- O campo VOLUME LABEL será atualizado para refletir o ISO selecionado.
- Os outros parâmetros devem ser deixados em seus valores padrão.
- Clique START para iniciar o processo de gravação.
- Durante o processo, uma mensagem pode aparecer alertando de que a Rufus requer arquivos adicionais para concluir a gravação do ISO. Selecione Sim para continuar.
- Durante o processo, você será alertado de que Rufus detectou que o ISO do Ubuntu é uma imagem ISOHybrid. Mantenha a gravação no modo de imagem ISO selecionado e clique em OK para continuar.
- Rufus também irá avisá-lo de que todos os dados do dispositivo USB selecionado estão prestes a ser destruídos. Verifique se você selecionou o dispositivo correto antes de clicar em OK.
- Aguarde a conclusão do processo, que pode levar alguns minutos dependendo da sua máquina. Após a conclusão, clique em CLOSE para fechar o Rufus.
- Insira o drive com o ISO em seu computador e reinicie a máquina. A maioria dos computadores reconhecerá o drive bootável automaticamente e mostrará uma mensagem de boas vindas com opções para selecionar o idioma, instalar ou experimentar o Ubuntu Desktop.
Nota: Se o computador não inicializar automaticamente a partir da unidade USB, tente segurar F12 ou Delete quando o computador iniciar pela primeira vez. Na maioria das máquinas, isso permitirá que você selecione o dispositivo USB em um menu de inicialização específico do sistema. Caso não aconteça, verifique a opção de Boot no computador, selecionando o Boot através da unidade USB. Se você não tiver certeza, procure por uma breve mensagem quando o sistema for inicializado, isso geralmente o informará sobre qual tecla deve ser pressionada para abrir o menu de inicialização.
- Logo após a escolha do Idioma, você será solicitado a selecionar o layout do teclado. Se o instalador não adivinhar o layout padrão corretamente, use o botão 'Detectar layout do teclado' para executar um breve procedimento de configuração.
- Depois de selecionar Continuar, você será perguntado por quais aplicativos deseja instalar para começar. As duas opções são 'Instalação normal' e 'Instalação mínima', selecione a opção 'Instalação normal'.
- Abaixo da questão do tipo de instalação, há duas caixas de seleção; um para habilitar atualizações durante a instalação e outro para habilitar software de terceiros.
- Habilite a opção Download updates e Install third-party software.
- Para a próxima etapa, é necessário estar conectado à internet. Se você não estiver conectado à Internet, será solicitado a seleção de uma rede sem fio, se disponível. Aconselhamos você a se conectar durante a instalação para garantir que sua máquina esteja atualizada.
- As demais opções de instalação serão de Localização e detalhes de Login.
- Depois que tudo estiver instalado e configurado, uma pequena janela aparecerá solicitando que você reinicie sua máquina. Clique Restart Now e remova a unidade flash USB quando solicitado.
Dica: Caso necessite, é possível encontrar uma lista de atalhos do teclado para o Ubuntu no link https://pt.wikibooks.org/wiki/Manual_do_Ubuntu/Teclas_de_atalho
- Acesse o terminal do Ubuntu pressionando Ctrl+Alt+T e digite a sequência a seguir:
sudo apt-get update
sudo apt-get install openjdk-8-jdk
- Localize o arquivo .bashrc na pasta Home, após pressionar Ctrl+H, e acrescente, no fim dele, as duas linhas abaixo para as variáveis de ambiente JAVA_HOME e PATH:
export PATH=$PATH:$JAVA_HOME/bin
- Execute os seguintes comandos no terminal:
echo $JAVA_HOME
echo $PATH
- Deverá aparecer uma tela de resultados com os diretórios do JAVA_HOME e PATH:
- Acesse o Terminal no Ubuntu e digite conforme abaixo para confirmar a instalação:
javac -version
Dica: Você pode limpar a tela do terminal pressionando Ctrl+L
- Acesse o link abaixo para a autenticação dos seus dados de acesso à rede (Active Directory):
- Insira seus dados, e após a autenticação, vá no canto superior direito da tela e clique sobre seu nome de usuário.
- Digite a sua senha de rede e clique em "Unlock".
- Copie o trecho que contém o nome de usuário e senha e substitua no settings.xml exatamente nas mesmas posições informadas anteriormente.
Dica: O arquivo settings.xml está localizado dentro da pasta config, na pasta do Maven.
- Acesse o link abaixo para a autenticação dos seus dados de acesso no SCMManager:
- No campo Search digite:
citsmart-itsm-enterprise
- Copie o Link no campo Checkout na parte inferior da página para o Git Clone.
- Abra a pasta onde deseja clonar o repositório CITSmart e execute o Terminal.
- Digite git clone + o link copiado no campo Checkout e dê Enter. Será solicitada a senha de Rede. Esse processo pode levar alguns minutos.
- Pode ser necessário criar uma nova conta caso não tenha cadastro.
- Após o acesso, clique com o botão direito em cima de Servers/Create/Server
- Na Aba General e no campo Name, digite dbcitsmart.
- Na Aba Connection digite:
- No Servidor criado, no menu esquerdo da tela, clique com o botão Direito e crie um Database com o nome dbcitsmart
- Em Login/Group Roles, no menu esquerdo da tela, clique com o botão direito em cima e selecione Create/Login/Group Roles
- Na Aba General e no campo Name, digite root
- Repita a operação e crie um Login/Group Roles com o nome rtsadmin
- Acesse o terminal do Ubuntu e digite:
sudo apt install docker-compose
- Após a instalação, acesse a pasta contendo os Banco de Dados SQL, Postgres e Oracle e execute o Terminal digitando respectivamente:
sudo docker exec -it postgres bash
su postgres
cd /home
ls
psql -l
- Ainda com o Terminal aberto, vamos executar o Restore do Banco, digite conforme abaixo:
pg_restore -d dbcitsmart dbcitsmart.sql
- Logo após, retorne ao PgAdmin, clique com o botão Direito do mouse e dê o Refresh, acesse o dbcitsmart/Schemas/Tables e verifique as tabelas migradas pelo Docker.
- Acesse o link a seguir para baixar o Eclipse IDE:
https://www.eclipse.org/downloads/packages/release/2020-06/r/eclipse-ide-enterprise-java-developers
- Na opção Download Links, escolha a versão para Linux.
- Extraia o arquivo baixado para a pasta de Desenvolvimento.
- Na pasta onde foi extraído o Eclipse, abra o arquivo eclipse.ini e edite as opções conforme abaixo:
- Execute o arquivo Eclipse e selecione um diretório para ser o seu workspace. Você pode marcar a opção “Use this as the default and do not ask again” para que a seleção do diretório do workspace não seja solicitada novamente.
- Selecione em File a opção Import:
- Na opção Maven, selecione Existing Maven Projects.
- Insira o caminho do diretório que está o repositório do Citsmart-itsm:
- O Projeto aparecerá conforme abaixo:
- Na tela inicial do eclipse, abra a janela Window/Preferences e preencha as opções das próximas telas conforme abaixo:
- Localize a opção Validation, procurando na barra de pesquisa, e habilite a opção Suspend all validators, conforme abaixo:
- O próximo passo será definir um novo Servers conforme abaixo:
- Clique no link em azul “No servers are available. Click this link to create a new server...”
- Escolha a opção conforme abaixo:
Nota: Clique na barra de progresso e arraste para ao lado da Aba Servers.
- Na Aba Markers, clique com o botão direito do mouse nas Description que estiverem com o ícone vermelho e escolha Remove:
- Na opção do New Server, selecione WildFly 12:
- Na opção Configuration file, selecione o arquivo xml standalone-postgres-full.xml, baixado no OneDrive:
- Na tela inicial do eclipse, abra a janela Window/Preferences, localize a opção Maven, selecione a opção User Settings e preencha conforme abaixo:
- Após a instalação do WildFly no Servers, aparecerá no Eclipse conforme abaixo:
- Clique duas vezes em cima do WildFly 12 e preencha conforme abaixo:
- Na opção Program arguments preencha conforme abaixo:
- Na opção VM arguments preencha conforme abaixo:
- Confira as informações do Diretório conforme o seu Diretório.
- Ainda nas configurações do WildFly 12, preencha o Time Limit, conforme abaixo:
- Logo após, clique em Salvar.
- Clique com o botão direito do mouse em cima do WildFly, escolha a opção Add and Remove, selecione o Citsmart9 e adicione:
- Confira o arquivo clean.sh, baixado no OneDrive:
!!! note "Nota"
rm -rf /home/run2biz/Documents/Desenvolvimento/workspace/citsmart-itsm-enterprise/target/*
rm -rf /home/run2biz/Documents/Desenvolvimento/WILDFLY-12.0.0/standalone/deployments/*
rm -rf /home/run2biz/Documents/Desenvolvimento/WILDFLY-12.0.0/standalone/data/
rm -rf /home/run2biz/Documents/Desenvolvimento/WILDFLY-12.0.0/standalone/log/
rm -rf /home/run2biz/Documents/Desenvolvimento/WILDFLY-12.0.0/standalone/tmp/
- Siga os próximos passos para que o Projeto rode corretamente.
- Execute o clean.sh
- Remova o Projeto no WildFly clicando com o botão direito do mouse e escolhendo Remove.
- Vá no Projeto, clique com o botão direito do mouse e escolha Refresh.
- Ainda no Projeto, clique com o botão direito do mouse e escolha Run as/Run Configuration/Run.
- Vá no Projeto, clique com o botão direito do mouse e escolha Refresh.
- Clique com o botão direito do mouse em cima do WildFly e escolha a opção Add and Remove, selecione o Citsmart9 e adicione:
- Com o Projeto adicionado no Wildfly, clique com o botão direito do mouse em cima do WildFly e escolha Clean.
- Aparecerá a tela abaixo, marque a opção Remember my decision e clique no botão No:
- O Projeto Citsmart9 aparecerá no WildFly.
!!! note "Nota"
- Acesse o link abaixo para o CITSmart:
- Clique em Advance/Proceed
- Pronto, o ambiente está configurado!