Documentation
Table of Contents
7 Scripts
Vis?o geral
O m¨®dulo Administra??o ¡ú Scripts permite a manuten??o do cadastro de scripts externos.
Estes scripts, dependendo das permiss?es do usu¨¢rio, estar?o dispon¨ªveis para execu??o a partir do menu flutuante em v¨¢rias partes da interface web (Dashboard, Dados recentes, Status das triggers, Eventos, Mapas) e tamb¨¦m poder?o ser chamados a partir de opera??es de execu??o de comando nas A??es. Os scripts podem ser executados no Áú»¢¶Ä²© Server ou Áú»¢¶Ä²© Agent.
Ao acessar o m¨®dulo ¨¦ apresentada uma lista detalhada dos scripts.
| Coluna | Descri??o |
|---|---|
| Nome | Nome do script. Clicar no nome do script abre seu formul¨¢rio de configura??o. |
| Tipo | Tipo do script - Script ou IPMI. |
| Executar em | Local onde o script ser¨¢ executado - Servidor ou Agente. |
| Comandos | Todos os comandos executados pelo script. |
| Grupo de usu¨¢rios | Grupos de usu¨¢rios para os quais o script estar¨¢ dispon¨ªvel (ou Todos para todos os grupos). |
| Grupo de hosts | Grupos de hosts para os quais o script estar¨¢ dispon¨ªvel (ou Todos para todos os grupos). |
| Acesso ao host | N¨ªvel m¨ªnimo de acesso ao grupo de host para que o script apare?a - Leitura ou Escrita. Apenas usu¨¢rios com o n¨ªvel de acesso adequado ter?o acesso ao script. |
Para configurar um novo script, utilize o bot?o Criar script localizado no lado direito da barra de t¨ªtulo.
Op??es de atualiza??o em massa
Ao final da lista existem bot?es que executam opera??es em massa:
- Excluir - Excluir os scripts selecionados
Para usar estas op??es, selecione os scripts e clique no bot?o com a a??o desejada.
Configurando um script global
| Coluna | Descri??o |
|---|---|
| Nome | Identificador ¨²nico do script. Desde o Áú»¢¶Ä²© 2.2 o nome pode ser prefixado com o caminho, por exemplo, Padr?o/, colocando o script no diret¨®rio respectivo. Nos menus de monitora??o, os scripts ser?o organizados por seus diret¨®rios.Um script n?o pode ter o mesmo nome de um diret¨®rio (e vice-versa). Um nome de scritp dever¨¢ ser ¨²nico em seu diret¨®rio. Os caracteres de escape s?o ignorados na valida??o de unicidade, ex. "Ping" e "\Ping" n?o poder?o ser adicionados no mesmo diret¨®rio. Caracteres de escape podem ser escapados com o uso da contrabarra "\", Ex. '\/' ou '\\'. |
| Tipo | Tipo do script - Script ou IPMI. Uma caixa de sele??o especial para scripts contendo comandos IPMI est¨¢ dispon¨ªvel desde o Áú»¢¶Ä²© 2.0. |
| Execute on | Selecione o local de execu??o do script (Servidor Áú»¢¶Ä²© ou Agente). O suporte a execu??o de scripts no agente est¨¢ dispon¨ªvel desde o Áú»¢¶Ä²© 2.0 (¨¦ necess¨¢ria a habilita??o do par?metro EnableRemoteCommands no arquivo de configura??o do agente). |
| Comandos | Caminho completo para os comandos a serem executados pelo script. Algumas macros s?o suportadas nos comandos: {HOST.CONN}, {HOST.IP}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}. Se o valor de uma macro contiver espa?os voc¨º dever¨¢ escapa-la. O suporte a macros foi adicionado no Áú»¢¶Ä²© 2.2. |
| Description | Descri??o do script. |
| Grupo de usu¨¢rios | Grupos de usu¨¢rios para os quais o script estar¨¢ dispon¨ªvel (ou Todos para todos os grupos). |
| Grupo de hosts | Grupos de hosts para os quais o script estar¨¢ dispon¨ªvel (ou Todos para todos os grupos). |
| Acesso ao host | N¨ªvel m¨ªnimo de acesso ao grupo de host para que o script apare?a - Leitura ou Escrita. Apenas usu¨¢rios com o n¨ªvel de acesso adequado ter?o acesso ao script. |
| Habilitar confirma??o | Marque para que uma mensagem de confirma??o seja exibida antes da execu??o do script. Esta fun??o pode ser especialmente ¨²til em comandos potencialmente perigosos (como um comando de reboot) ou que ir?o demorar muito. |
| Mensagem de confirma??o | Mensagem customizada de confirma??o usada no popup de confirma??o de execu??o do script (por exemplo, O comando ir¨¢ reiniciar o servidor remoto, continuar?). Para ver como a mensagem ser¨¢ exibida, clique no bot?o Testar mensagem de confirma??o pr¨®ximo ao campo. Desde o Áú»¢¶Ä²© 2.2, a mensagem de confirma??o pode utilizar macros: {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN} e macros de usu¨¢rio. Nota: As macros n?o ser?o expandidas durante o teste de confirma??o da mensagem. |
Resultado do script
O resultado da execu??o do script ser¨¢ exibido em um pop-up ap¨®s sua execu??o.
Nota: O valor de retorno do script ser¨¢ o que ele enviar para a saida normal.
Veja exemplo de um script e da janela de resultado a seguir:
