lamexec - Online na nuvem

PROGRAMA:

NOME

lamexec - Executa programas não MPI em nós LAM.

SINOPSE

lamexec [-fhvD] [-c # | -np #] [-nw | -w] [-pty] [-s nó] [-x
VAR1 [= VALUE1] [, VAR2 [= VALUE2], ...]] [onde] programar [- args]

OPÇÕES

-c # Sinônimo de -np (ver abaixo).

-D Use a localização do programa executável como o diretório de trabalho atual para criado
processos. O diretório de trabalho atual dos processos criados será definido
antes que o programa do usuário seja invocado.

-f Não configure descritores de arquivo de E / S padrão - use padrões.

-h Imprima informações úteis sobre este comando.

-np # (Veja abaixo). Execute esse número de cópias do programa nos nós fornecidos. Esse
opção indica que o arquivo especificado é um programa executável e não um
esquema do aplicativo. Se nenhum nó for especificado, todos os nós LAM são considerados para
agendamento; LAM irá agendar os programas em rodízio, "embrulhando
ao redor "(e agendando várias cópias em um único nó), se necessário.

-nw Não espere que todos os processos sejam concluídos antes de sair lamexec. Esta opção
é mutuamente exclusivo com -w.

-pty Habilite o suporte a pseudo-tty. Entre outras coisas, este buffer de linha habilitado
saída (que provavelmente é o que você deseja). A única razão pela qual esse recurso é
não habilitado por padrão é porque é muito novo e não foi extensivamente
testado ainda.

-s nó Carregue o programa a partir deste nó. Esta opção não é válida na linha de comando
se um esquema de aplicativo for especificado.

-v Seja prolixo; relatar as etapas importantes à medida que são realizadas.

-w Aguarde até que todos os aplicativos sejam encerrados antes lamexec saídas.

-x Exporte as variáveis ​​de ambiente especificadas para os nós remotos antes de executar
o programa. Variáveis ​​de ambiente existentes podem ser especificadas (veja os Exemplos
seção, abaixo), ou novos nomes de variáveis ​​especificados com os valores correspondentes. o
analisador para o -x opção não é muito sofisticada; nem mesmo entende
valores cotados. Os usuários são aconselhados a definir variáveis ​​no ambiente e, em seguida,
usar -x para exportá-los (não defini-los).

onde Um conjunto de identificadores de nó e / ou CPU indicando onde começar

-- args Passe esses argumentos de tempo de execução para cada novo processo. Este deve ser sempre o último
argumento para lamexec. Esta opção não é válida na linha de comando se um
o esquema do aplicativo é especificado.

DESCRIÇÃO

lamexec é essencialmente um clone do mpirun(1), mas se destina a programas não MPI.

Uma invocação de lamexec inicia um aplicativo não MPI em execução no LAM. Para iniciar o
mesmo programa em todos os nós LAM, o aplicativo pode ser especificado no lamexec comando
linha. Para iniciar vários aplicativos nos nós LAM, um esquema de aplicativo é necessário
em um arquivo separado. Ver esquema de aplicativos(5) para uma descrição da sintaxe do esquema do aplicativo,
mas contém essencialmente vários lamexec linhas de comando, menos o próprio nome do comando.
A capacidade de especificar diferentes opções para diferentes instanciações de um programa é
outro motivo para usar um esquema de aplicativo.

Localização Nomenclatura
A nomenclatura de localização que é usada para a menção da cláusula where no SINOPSE
seção, acima, é idêntica a mpirun(1) nomenclatura de. Veja o mpirun(1) página de manual para
uma longa discussão da nomenclatura de localização.

Observe que a sintaxe por CPU, embora válida para lamexec, não é tão significativo porque
a ordem de classificação do processo em MPI_COMM_WORLD é irrelevante. Como tal, a nomenclatura por nó
é tipicamente a sintaxe preferida para lamexec.

Aplicação Esquema or Executável Programa?
Para distinguir as duas formas diferentes, lamexec procura na linha de comando por nós ou o
-c opção. Se nenhum dos dois for especificado, o arquivo nomeado na linha de comando será considerado
ser um esquema de aplicativo. Se um ou ambos forem especificados, o arquivo será assumido
para ser um programa executável. Se nós e -c ambos são especificados, então cópias do
programa são iniciados nos nós especificados de acordo com uma política de agendamento LAM interna.
Especificar apenas um nó força efetivamente o LAM a executar todas as cópias do programa em um
Lugar, colocar. Se -c é fornecido, mas não os nós, então todos os nós LAM são usados. Se nós for fornecido,
mas não -c, então uma cópia do programa é executada em cada nó.

Agenda Transferir entre Contas
Por padrão, o LAM procura por programas executáveis ​​no nó de destino onde um determinado
a instanciação será executada. Se o sistema de arquivos não for compartilhado, os nós de destino são
homogêneo, e o programa é freqüentemente recompilado, pode ser conveniente ter LAM
transferir o programa de um nó de origem (geralmente o nó local) para cada nó de destino. o
-s opção especifica este comportamento e identifica o único nó de origem.

Localizando Arquivos
LAM procura por um programa executável pesquisando os diretórios no PATH do usuário
variável de ambiente conforme definido no (s) nó (s) de origem. Este comportamento é consistente com
efetuar login no nó de origem e executar o programa a partir do shell. Em nós remotos,
a "." path é o diretório inicial.

O LAM procura um esquema de aplicativo em três diretórios: o diretório local, o valor
da variável de ambiente LAMAPPLDIR e laminstalldir / boot, onde "laminstalldir" é
o diretório onde o LAM / MPI foi instalado.

Padrão I / O
O LAM direciona a entrada padrão do UNIX para / dev / null em todos os nós remotos. No nó local que
invocado lamexec, a entrada padrão é herdada de lamexec. O padrão é o que costumava ser
a opção -w para evitar o acesso conflitante ao terminal.

O LAM direciona a saída e o erro padrão do UNIX para o daemon LAM em todos os nós remotos. LAM
envia todas as saídas / erros capturados para o nó que invocou lamexec e imprime no
saída padrão / erro de lamexec. Os processos locais herdam a saída / erro padrão de
lamexec e transferir diretamente para ele.

Assim, é possível redirecionar I / O padrão para aplicativos LAM usando o típico
procedimento de redirecionamento de shell em lamexec.

% lamexec N meu_app minha_entrada minha_saída

A -f opção evita toda a configuração necessária para suportar E / S padrão descrito acima.
Os processos remotos são completamente direcionados para / dev / null e os processos locais herdam o arquivo
descritores de rabo de cavalo(1).

Pseudo-tty ajuda
A -pty opção habilitada suporte pseudo-tty para saída de processo. Isso permite, entre outros
coisas, para saída com buffer de linha de nós remotos (que provavelmente é o que você quer).

Esta opção não é atualmente o padrão para lamexec porque não foi completamente
testado em uma variedade de Unixes diferentes. Os usuários são encorajados a usar -pty e relatar qualquer
problemas de volta para a equipe LAM.

Atual Trabalho Diretório
O diretório de trabalho atual para novos processos criados no nó local é herdado
da lamexec. O diretório de trabalho atual para novos processos criados em nós remotos é
o diretório inicial do usuário remoto. Este comportamento padrão é substituído pelo -D opção.

A -D opção irá mudar o diretório de trabalho atual de novos processos para o diretório
onde o executável reside antes de o programa do novo usuário ser chamado.

Uma alternativa para o -D opção é o -wd opção. -wd permite que o usuário especifique um
diretório de trabalho atual arbitrário (vs. a localização do executável). Observe que o
-wd opção pode ser usada em arquivos de esquema do aplicativo (veja esquema de aplicativos(5)) também.

Extração Meio Ambiente
Os processos no aplicativo herdam seu ambiente do daemon LAM no nó
em que estão sendo executados. O ambiente de um daemon LAM é corrigido na inicialização do
LAM com rabo de cavalo(1) e é herdado do shell do usuário. No nó de origem, isso vai
seja a concha da qual rabo de cavalo(1) foi invocado e em nós remotos este será o shell
começado por rsh(1). Ao executar aplicativos dinamicamente vinculados que requerem o
Variável de ambiente LD_LIBRARY_PATH a ser definida, deve-se tomar cuidado para garantir que seja
definido corretamente ao inicializar o LAM.

Exportado Meio Ambiente Variáveis
A -x opção para lamexec pode ser usado para exportar variáveis ​​de ambiente específicas para o novo
processos. Embora a sintaxe do -x opção permite a definição de novas variáveis, nota
que o analisador para esta opção não é muito sofisticado - ele nem mesmo
entender os valores cotados. Os usuários são aconselhados a definir variáveis ​​no ambiente e usar
-x para exportá-los; não para defini-los.

EXEMPLOS

lamexec N prog1
Carregue e execute prog1 em todos os nós. Procure o arquivo executável em cada nó.

lamexec -c 8 prog1
Execute 8 cópias de prog1 onde quer que o LAM queira executá-las.

lamexec n8-10 -v -nw -s n3 prog1 - -q
Carregue e execute prog1 nos nós 8, 9 e 10. Procure prog1 no nó 3 e transfira
para os três nós de destino. Relate conforme cada processo é criado. Dê "-q" como um
linha de comando para cada novo processo. Não espere que os processos sejam concluídos antes
saindo lamexec.

lamexec -v meuaplicativo
Analise o esquema do aplicativo, myapp, e inicie todos os processos especificados nele. Relatório
à medida que cada processo é criado.

lamexec NN -pty -wd / workstuff / output -x DISPLAY run_app.csh
Execute o aplicativo "run_app.csh" (supostamente um script de shell C) duas vezes em cada nó em
o sistema (ideal para SMPs bidirecionais). Também habilite o suporte pseudo-tty, mude o diretório
para / workstuff / output, e exportar a variável DISPLAY para os novos processos (talvez
o script de shell invocará um aplicativo X como xv para exibir a saída).

lamexec -np 5 -D `pwd` / my_application
Um uso comum de lamexec em ambientes onde um sistema de arquivos é compartilhado entre todos
nós no multicomputador, usando o comando "pwd" com escape de shell, especifica o
nome do executável a ser executado. Isso evita a necessidade de colocar o diretório em
o caminho; as notas remotas terão um nome de arquivo absoluto para executar (e mudar
para ele na chamada).

DIAGNÓSTICO

lamexec: erro de formato Exec
Um caractere não ASCII foi detectado no esquema do aplicativo. Isso geralmente é um
erro de uso de linha de comando onde lamexec está esperando um esquema de aplicativo e um
arquivo executável foi fornecido.

lamexec: erro de sintaxe no esquema do aplicativo, linha XXX
O esquema do aplicativo não pode ser analisado devido a um erro de uso ou sintaxe no
dada linha no arquivo.

nome do arquivo: Não existe tal arquivo ou diretório
Este erro pode ocorrer em dois casos. O arquivo nomeado não pode ser localizado ou tem
foi encontrado, mas o usuário não tem permissões suficientes para executar o programa ou
leia o esquema do aplicativo.

RETORNO VALOR

lamexec retorna 0 se todos os processos iniciados por lamexec saia normalmente. Um valor diferente de zero é
retornado se um erro interno ocorreu no lamexec, ou um ou mais processos saíram
anormalmente. Se ocorreu um erro interno no lamexec, o código de erro correspondente é
retornou. No caso de um ou mais processos saírem com código de saída diferente de zero, o
valor de retorno do processo que lamexec os primeiros avisos morridos de forma anormal serão devolvidos.
Observe que, em geral, este será o primeiro processo que morreu, mas não há garantia de
seja assim.

No entanto, observe que se o -nw switch for usado, o valor de retorno de lamexec não
indicam o status de saída dos processos iniciados por ele.

Use lamexec online usando serviços onworks.net