> For the complete documentation index, see [llms.txt](https://docs.linuxcontrolcenter.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.linuxcontrolcenter.com.br/criar_arquivo.md).

# Arquivos Gerenciados

## Requisitos

Linux Control Center = 2.10.X ou superior

## Overview

O Linux Control Center permite a padronização de arquivos de configuração de Hosts gerenciados a partir do Upload de um arquivo de configuração.

## Objetivo

Este documento tem como objetivo demonstrar o passo a passo de como utilizar a funcionalidade *Arquivos* do Linux Control Center.

## Criar Arquivo Gerenciado

### Configurações Essenciais

1. Acesse a tela **Files** no menu lateral esquerdo.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-5830d70fa5f978a6f442332e44740d9f16497cfb%2Ffile_dashboard.png?alt=media)
2. Clique em **Create**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-a5cad4f66c4ffc61a31828cf5736c816d46aedbe%2Fbotao_create.png?alt=media)
3. Preencha os campos obrigatórios conforme orientação abaixo;

   **Name:** Nome para identificar o arquivo apenas na Console do LCC.\
   **Upload File:** Campo para realizar o upload do arquivo desejado.\
   **Path:** Diretório, Mome e Extensão em que será armazenado no Host.\
   **Owner:** Usuário que terá permissões de acesso ao arquivo.\
   **Gruop:** Grupo que terá permissões de acesso ao arquivo.\
   **Permissions:** Nível de permissão de acesso ao arquivo.<br>

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-55552732fc9f92917d1f43888e06c2cbffc41b6e%2Fcampos_iniciais.png?alt=media)

### Configações Adicionais

* Estas configurações permitem criar Usuário, Grupo ou Diretório quando não existirem em um Host em que o arquivo será carregado. Possibilita também a criação de uma cópia do arquivo e move-lo para um diretório desejado caso já exista um antes de realizar a ação de adicionar o novo arquiv no Host

  **Create User:** Cria o usuário do campo *Owner* caso não exista no Host.\
  **Create Gruop:** Cria o grupo de acesso do campo *group* caso não exista no Host.\
  **Create Directory:** Cria o diretório para salvar o arquivo do campo *Path* caso não exista no Host.\
  **Backup:** Cria uma cópia com data e hora caso já exista um arquivo com o mesmo nome e extensão no mesmo diretório do *Path*.\
  **Move Backup:** Move a cópia criada para o diretório inserido no campo *Backup Directory* .<br>

  ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-2e55b81902e1e87bc0e5e4833542b0c209b679af%2Fcampos_adicionais.png?alt=media)

1. Clique **Save** para tornar o arquivo em um Arquivo Gerenciado pelo LCC.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-83887351af7257429f57bdd9bed80a8c2859aa6e%2Fbotao_save.png?alt=media)
2. Clique no Arquivo Gerenciado para verificar ou alterar as configurações do Arquivo.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-65bd487f2ee8a405c3070113132ca8daa7d3fae3%2Farquivo_criado.png?alt=media)
3. Será exibido todos os campos preenchidos na criação do arquivo. Também é possível baixa-lo ao clicar em **Download**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-c2502198da3f28619357f40b892d0861735d1b33%2Fbotao_download.png?alt=media)

### File Host e Content

1. Acesse o Arquivo criado e clique em *File Host*.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-b4475bceb8d2195c162ccffb65afa9b6bbc03649%2Ftela_file_host.png?alt=media)
2. O botão **ADD Host** cria uma linha vazia na tabela, e ao clicar na seta na coluna *Host*, será possível escolher um Host para criar o arquivo.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-cffb594ffec13258bf8d1628c59469a8dd8d7884%2Fbotao_add_host.png?alt=media)
3. Clique em **Save** após selecionar o Host para iniciar a Ação *File Add* que fará a inclusão do arquivo conforme as configurações.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-cd9498a6edac7e2e0a258e36295200d71c22a0b2%2Fbotao_save_tela_file_host.png?alt=media)
4. Esta tela exibe em quais *Hosts* o arquivo foi adicionado, juntamente com a data e hora em que foi criado. A Coluna *Sync* indica se o arquivo está sincronizado com a última versão existente na Console do LCC.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-3f67a3cff4e921a98b1d5406b4e7c7ed7544640d%2Farquivo_adicionado_host.png?alt=media)
5. O botão com ícone de lixeira na coluna *Actions* serve para facilitar a exclusão do arquivo do Host desejado a partir desta tela, mas também é possível deletar o arquivo a partir da tela **Hosts** ou na tela **Host Groups** para maior quantidade de Hosts.
6. Ao clicar neste botão, a ação *File Del* será iniciada imediatamente e o arquivo será removido do Host escolhido.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-8a0cc8dd8624c2e722ea8b910da15883a4ad7021%2Fbotao_lixeira.png?alt=media)
7. A tela **Content** exibe o conteúdo do Arquivo em que está salvo na Console do LCC.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-64cdc8ddd168c5c5579ac8ca1b75c33d790eda1e%2Fcontent.png?alt=media)

## Adicionar Arquivo Gerenciado em Host

1. Acesse a tela **Hosts**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-9c491171845e4402af4a9a00d4573628cae81ae9%2Fhosts_file_download.png?alt=media)
2. Clique em **Actions** da linha e um Host desejado e clique em **File Add**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-59163a0dbdc5674ffdf4639219e46e10b6615324%2Ffile_add_linha_host.png?alt=media)
3. Para executar a Ação em vários Hosts simulteaneamente, selecione os Hosts desejados e clique em **Actions** do topo da página e clique em **File Add**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-0be13ab35e61798a74ef02d7d266dbe79370fdfa%2Ffile_add_topo.png?alt=media)
4. Clique em **File Type** e escolha a opção **Managed**.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-e553ff755bd5307532da5f9400ae84f62a33108a%2Ftype_managed.png?alt=media)
5. Clique em **Insert File** e escolha o arquivo gerenciado em que deseja adicionar ao Host.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-9410edd83f1aad8c6450690eb91f041c5869e0e3%2Finsert_file.png?alt=media)
6. Clique em **Yes** para iniciar a *Ação*.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-32012e8e4a0d4691da1eb2f6bfaea6344cf3d9f2%2Fbotao_yes.png?alt=media)
7. Clique no botão **Queue Working** no topo da página para acompanhar a execução da ação.

   **Observação:** Será criada uma Action **File Add** independente para cada Host caso seja executado em mais de um Host simultaneamente.

   ![](https://3122590582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FytotrgCSM7abU2RFWBCP%2Fuploads%2Fgit-blob-6e5ebcfa80765505bb12b044a468a464500108b5%2Factions_file_add_working.png?alt=media)
