Pular para o conteúdo

Modos de execução

Modo de execução do STCP Gemini Rename

O STCP Gemini Rename é um utilitário de linha de comando (CLI) e, diferente dos demais componentes da plataforma, não é executado como serviço gerenciado pelo systemd.

Para executar o STCP Gemini Rename utilizando o arquivo de configuração criado anteriormente, utilize:

stcpren -db -config /usr/local/stcpren/configs/config.json -rules <NOME-REGRA> -scan ""

A flag -db indica que a configuração de Roteamentos e Regras deve ser obtida a partir do banco de dados da plataforma (cfgProvider do tipo stcpgeminidb), conforme definido em config.json.

Os Roteamentos e Regras processados pelo STCP Gemini Rename são criados e mantidos através do STCP Gemini Portal. O detalhamento dessas opções está fora do escopo deste guia de instalação e será abordado no guia de uso do STCP Gemini Rename.

Opções disponíveis

O comando stcpren aceita as opções abaixo, utilizadas principalmente para sobrescrever ou testar comportamentos específicos de execução:

FlagTipoDescrição
-configstringCaminho do arquivo de configuração (obrigatório). Padrão: /usr/local/stcpren/configs/config.json.
-dbbooleanaUtiliza a configuração de Roteamentos e Regras a partir do banco de dados (cfgProvider).
-inistringNome do arquivo de definição de rotas (routing), quando não utilizado o modo -db.
-rulesstringNome do arquivo de definição de regras, quando não utilizado o modo -db.
-srcstringNome de origem a ser processada.
-dststringNome de destino a ser utilizado.
-scanstringNome do diretório de varredura.
-subdirbooleanaHabilita a busca em subdiretórios.
-subdir2booleanaHabilita a busca no diretório e em subdiretórios.
-nosubdirbooleanaDesabilita a busca em subdiretórios.
-dirregexstringExpressão regular utilizada para validar diretórios durante a varredura.
-dirregexnegstringExpressão regular utilizada para excluir diretórios durante a varredura.
-fileregexstringExpressão regular utilizada para validar arquivos durante a varredura.
-fileregexnegstringExpressão regular utilizada para excluir arquivos durante a varredura.
-copydirstringDiretório de cópia.
-backupdirstringDiretório de backup.
-filekeystringChave de identificação do arquivo.
-firstruleintPrimeira regra a ser considerada na pesquisa.
-scansemnamestringNome do semáforo utilizado durante a varredura.
-scansemoptionsintOpções do semáforo de varredura.
-scansemtimeoutintTempo limite (timeout) do semáforo de varredura.
-nologeventbooleanaDesabilita o log de eventos.
-nologroutebooleanaDesabilita o log de roteamento.
-langstringIdioma utilizado. Padrão: ptb.
-langfilestringArquivo de mensagens utilizado. Padrão: /usr/local/stcpren/configs/messages.json.
-pidstringNome do arquivo de PID.
-errfilestringRedireciona a saída de erro (stderr) para um arquivo.
-exportstringExporta a configuração armazenada no banco de dados.
-testbooleanaTesta a existência de uma definição de regra, sem executar o processamento.
-var0 a -var9stringValores de variáveis customizadas, utilizados conforme definido nos Roteamentos e Regras.
-vbooleanaExibe a versão do STCP Gemini Rename.

Para consultar a versão instalada, execute:

stcpren -v
O STCP Gemini Rename (STCPRen) é executado sob demanda. Sua execução pode ser acionada por eventos configurados no STCP Gemini Portal, como início ou fim de conexão e recepção de arquivos no STCP Gemini Server ou STCP Directlink. Também é possível executar o STCPRen em horários ou intervalos definidos por meio de agendamentos.