--- title: Configuração do Ambiente de Desenvolvimento do CITSmart no Linux slug: support-pt/configuracao-do-ambiente-de-desenvolvimento-do-citsmart-no-linux description: This document provides a detailed step-by-step guide to configuring CITSmart on the Linux operating system. It covers everything from downloading necessary files to setting up the CITSmart application. Instructions are included for installing Ubuntu, Java docTags: createdAt: 2021-10-25T18:48:46.000Z --- 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. ## Antes de começar Para começar o procedimento, é necessário fazer o download dos arquivos disponíveis no Google Drive [https://drive.google.com/drive/folders/1k6f6NtvoAiTwDzQ6trNYHHWo3PSBh0zD](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. ## Procedimento ### Instalando o OS Ubuntu na máquina - Acesse a página web [https://ubuntu.com/#download](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/](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. :::hint{type="success"} **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. :::hint{type="info"} **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. :::hint{type="success"} **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](https://pt.wikibooks.org/wiki/Manual_do_Ubuntu/Teclas_de_atalho) ::: ### Instalando o Java - 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 ` :::hint{type="success"} **Dica: **Você pode limpar a tela do terminal pressionando Ctrl+L ::: ### Autenticando o acesso no Artifactory - Acesse o link abaixo para a autenticação dos seus dados de acesso à rede *(Active Directory)*: [https://artifactory.centralit.com.br:8092/artifactory/webapp/login.html?0](https://artifactory.centralit.com.br:8092/artifactory/webapp/login.html?0) - 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. :::hint{type="success"} **Dica: **O arquivo settings.xml está localizado dentro da pasta config, na pasta do Maven. ::: ### Criando um clone do repositório CITSmart-ITESM - Acesse o link abaixo para a autenticação dos seus dados de acesso no SCMManager: [https://scm.centralit.com.br/scm/#repositoryPanel;4MRv1XSxO9](https://scm.centralit.com.br/scm/#repositoryPanel;4MRv1XSxO9) - 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. ### Criando o servidor, databases e Login Group Roles no PGADMIN - Acesse o seguinte link para a criação dos servidores: [http://localhost:8081/](http://localhost:8081/) - 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: :::BlockQuote postgres 5432 postgres postgres post ::: - 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* ### Instalando o Docker - 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. ### Instalando o Eclipse - 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](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: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/kQW3rXNIUO5RnPpr3S0Kv_image-1.jpg) - 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**: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/cu-gGFaphIjt5zfU_lEu5_image-2.png) - Na opção Maven, selecione **Existing Maven Projects.** - Insira o caminho do diretório que está o repositório do *Citsmart-itsm*: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/IRmq0j_cTYMxGu44wjsFs_image-3.png) - O Projeto aparecerá conforme abaixo: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/xlD3lJvy6HdST_7-gDeDV_image-4.png) - Na tela inicial do eclipse, abra a janela **Window/Preferences** e preencha as opções das próximas telas conforme abaixo: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/qArbNQztth7A2FMvCTf3J_image-5.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/6GYuFaAorKEw83rl9LQ_y_image-6.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/8c2e6fDsSoZyCbSLcVF_l_image-7.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/gUIrvg6hKtDDpWIl861Kd_image-8.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/U4dD2Ip5kr0ji5JcHCbWP_image-10.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/hRMH85sBOtSSh7Pr_Cq0k_image-9.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/NyfIoTnllSa4sVeTA56Q2_image-11.png) - Localize a opção **Validation**, procurando na barra de pesquisa, e habilite a opção **Suspend all validators**, conforme abaixo: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ipNjYoqQtfJ64xVBBJbd7_image-12.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/9rE8vQ7egoGVwo133vnDp_image-13.png) - O próximo passo será definir um novo Servers conforme abaixo: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/AjM_9y4CH3lPHlL3BtbrR_image-15.png) - Clique no link em azul *“No servers are available. Click this link to create a new server...”* - Escolha a opção conforme abaixo: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/gpPDqY2b8p7YkMbWsyQZx_image-16.png) ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/grEwcBYDwY20dE-rZ-PUQ_image-17.png) :::hint{type="info"} **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**: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/NmllZT9kU_VruFV__B0Sb_image-18.png) - 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: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/TqWVHEP-See_MNw_3fkER_image-19.png) - Após a instalação do WildFly no Servers, aparecerá no Eclipse conforme abaixo: ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/wnl3rOxQlORLAcBX64WCV_image-20.png) - Clique duas vezes em cima do WildFly 12 e preencha conforme abaixo: ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/R9cbCWmWMny7QZqfICack_image-21.png" size="84" width="1094" height="742" position="center" showCaption="false"} ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/TMaSSHOqLlLNSSKwtCzl5_image-22.png" size="98" width="674" height="650" position="center" showCaption="false"} ::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ePn-mGZbMQHBqHWrjqq5Q_image-23.png" size="74" width="1094" height="742" position="center" showCaption="false"} ![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/Yri9dy2VnaiwQzhTHNkEM_image-24.png) - 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: ![](/pt-br/citsmart-platform-9/get-started/installation-and-upgrade/images-linux/image25.png "imagem 1") - 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: ![](/pt-br/citsmart-platform-9/get-started/installation-and-upgrade/images-linux/image26.png "imagem 1") - Confira o arquivo *clean.sh*, baixado no OneDrive: ![](/pt-br/citsmart-platform-9/get-started/installation-and-upgrade/images-linux/image27.png "imagem 1") !!! note "Nota" ```Text As informações do Diretório destacadas em negrito devem ser substituídas conforme o seu Diretório: ``` 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**. ![](/pt-br/citsmart-platform-9/get-started/installation-and-upgrade/images-linux/image28.png "imagem 1") - Ainda no Projeto, clique com o botão direito do mouse e escolha **Run as/Run Configuration/Run**. ![](/pt-br/citsmart-platform-9/get-started/installation-and-upgrade/images-linux/image29.png "imagem 1") - 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: ![](/pt-br/citsmart-platform-9/get-started/installation-and-upgrade/images-linux/image30.png "imagem 1") ![](/pt-br/citsmart-platform-9/get-started/installation-and-upgrade/images-linux/image31.png "imagem 1") - 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**: ![](/pt-br/citsmart-platform-9/get-started/installation-and-upgrade/images-linux/image32.png "imagem 1") ![](/pt-br/citsmart-platform-9/get-started/installation-and-upgrade/images-linux/image33.png "imagem 1") - O Projeto Citsmart9 aparecerá no WildFly. !!! note "Nota" ```Text Caso mesmo após todos os passos acima o Projeto não rode, clique com o botão direito do mouse em cima do Projeto, Maven / Update Project e repita novamente o Passo a Passo. ``` ![](/pt-br/citsmart-platform-9/get-started/installation-and-upgrade/images-linux/image34.png "imagem 1") - Acesse o link abaixo para o CITSmart: [https://localhost:8443/citsmart](https://localhost:8443/citsmart) - Clique em **Advance/Proceed** - Pronto, o ambiente está configurado!