lamexec - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

lamexec - Chạy các chương trình không phải MPI trên các nút LAM.

SYNOPSIS

lamexec [-fhvD] [-c # | -np #] [-nw | -w] [-pty] [-s nút] [-x
VAR1 [= VALUE1] [, VAR2 [= VALUE2], ...]] [trong đó] chương trình [- args]

LỰA CHỌN

-c # Từ đồng nghĩa với -np (xem bên dưới).

-D Sử dụng vị trí chương trình thực thi làm thư mục làm việc hiện tại cho
các quy trình. Thư mục làm việc hiện tại của các quy trình đã tạo sẽ được thiết lập
trước khi chương trình của người dùng được gọi.

-f Không định cấu hình bộ mô tả tệp I / O tiêu chuẩn - sử dụng giá trị mặc định.

-h In thông tin hữu ích về lệnh này.

-np # (xem bên dưới). Chạy nhiều bản sao của chương trình này trên các nút nhất định. Cái này
tùy chọn chỉ ra rằng tệp được chỉ định là một chương trình thực thi chứ không phải
lược đồ ứng dụng. Nếu không có nút nào được chỉ định, tất cả các nút LAM được coi là
lập kế hoạch; LAM sẽ lên lịch các chương trình theo kiểu vòng tròn "
xung quanh "(và lập lịch nhiều bản sao trên một nút duy nhất) nếu cần.

-nw Đừng đợi tất cả các quy trình hoàn tất trước khi thoát lamexec. Tùy chọn này
loại trừ lẫn nhau với -w.

-pty Bật hỗ trợ giả tty. Trong số những thứ khác, điều này đã kích hoạt bộ đệm dòng
đầu ra (có thể là những gì bạn muốn). Lý do duy nhất mà tính năng này là
không được bật theo mặc định là vì nó quá mới và chưa được mở rộng
đã thử nghiệm.

-s nút Tải chương trình từ nút này. Tùy chọn này không hợp lệ trên dòng lệnh
nếu một lược đồ ứng dụng được chỉ định.

-v Dài dòng; báo cáo về các bước quan trọng khi chúng được thực hiện.

-w Chờ cho tất cả các ứng dụng thoát trước khi lamexec lối thoát hiểm.

-x Xuất các biến môi trường được chỉ định sang các nút từ xa trước khi thực thi
chương trình. Các biến môi trường hiện tại có thể được chỉ định (xem các Ví dụ
phần, bên dưới), hoặc các tên biến mới được chỉ định với các giá trị tương ứng. Các
phân tích cú pháp cho -x tùy chọn không phải là rất phức tạp; nó thậm chí không hiểu
các giá trị được trích dẫn. Người dùng nên đặt các biến trong môi trường và sau đó
sử dụng -x để xuất (không xác định) chúng.

Ở đâu Một tập hợp các mã nhận dạng nút và / hoặc CPU cho biết nơi bắt đầu

-- args. Chuyển các đối số thời gian chạy này cho mọi quy trình mới. Cái này luôn phải là cái cuối cùng
tranh luận với lamexec. Tùy chọn này không hợp lệ trên dòng lệnh nếu
lược đồ ứng dụng được chỉ định.

MÔ TẢ

lamexec về cơ bản là một bản sao của mpirun(1), nhưng dành cho các chương trình không thuộc Bộ KH & ĐT.

Một lời kêu gọi của lamexec khởi động một ứng dụng không phải MPI đang chạy trong LAM. Để bắt đầu
cùng một chương trình trên tất cả các nút LAM, ứng dụng có thể được chỉ định trên lamexec lệnh
hàng. Để khởi động nhiều ứng dụng trên các nút LAM, cần có một lược đồ ứng dụng
trong một tệp riêng biệt. Nhìn thấy ứng dụng(5) để biết mô tả về cú pháp lược đồ ứng dụng,
nhưng về cơ bản nó chứa nhiều lamexec dòng lệnh, bớt tên lệnh.
Khả năng chỉ định các tùy chọn khác nhau cho các khởi tạo khác nhau của một chương trình là
một lý do khác để sử dụng một lược đồ ứng dụng.

Địa Chỉ Danh pháp
Danh pháp vị trí được sử dụng cho mệnh đề where trong SYNOPSIS
phần trên giống hệt với mpirun(1) của danh pháp. Xem mpirun(1) trang người đàn ông cho
một cuộc thảo luận dài về danh pháp địa điểm.

Lưu ý rằng cú pháp của CPU, mặc dù hợp lệ đối với lamexec, không hoàn toàn có ý nghĩa vì
thứ tự xếp hạng quy trình trong MPI_COMM_WORLD không liên quan. Như vậy, danh pháp từng nút
thường là cú pháp ưu tiên cho lamexec.

Các Ứng Dụng Schema or Thực thi Chương trình?
Để phân biệt hai hình thức khác nhau, lamexec tìm kiếm trên dòng lệnh cho các nút hoặc
-c Lựa chọn. Nếu cả hai đều không được chỉ định, thì tệp có tên trên dòng lệnh được giả định là
là một lược đồ ứng dụng. Nếu một trong hai hoặc cả hai được chỉ định, thì tệp được giả định là
là một chương trình thực thi. Nếu các nút và -c cả hai đều được chỉ định, sau đó là bản sao của
chương trình được bắt đầu trên các nút được chỉ định theo chính sách lập lịch LAM nội bộ.
Việc chỉ định một nút có hiệu quả buộc LAM phải chạy tất cả các bản sao của chương trình trong một
địa điểm. Nếu như -c được đưa ra, nhưng không phải là nút, sau đó tất cả các nút LAM được sử dụng. Nếu các nút được cung cấp,
nhưng không -c, sau đó một bản sao của chương trình được chạy trên mỗi nút.

chương trình chuyển khoản
Theo mặc định, LAM tìm kiếm các chương trình thực thi trên nút đích nơi một
tức thời sẽ chạy. Nếu hệ thống tệp không được chia sẻ, các nút đích sẽ
đồng nhất và chương trình thường xuyên được biên dịch lại, có thể thuận tiện khi có LAM
chuyển chương trình từ một nút nguồn (thường là nút cục bộ) đến mỗi nút đích. Các
-s tùy chọn chỉ định hành vi này và xác định nút nguồn duy nhất.

Định vị Các tập tin
LAM tìm kiếm một chương trình thực thi bằng cách tìm kiếm các thư mục trong PATH của người dùng
biến môi trường như được xác định trên (các) nút nguồn. Hành vi này phù hợp với
đăng nhập vào nút nguồn và thực thi chương trình từ trình bao. Trên các nút từ xa,
NS "." đường dẫn là thư mục chính.

LAM tìm kiếm một lược đồ ứng dụng trong ba thư mục: thư mục cục bộ, giá trị
của biến môi trường LAMAPPLDIR và laminstalldir / boot, trong đó "laminstalldir" là
thư mục nơi LAM / MPI đã được cài đặt.

Tiêu chuẩn I / O
LAM hướng đầu vào chuẩn UNIX tới / dev / null trên tất cả các nút từ xa. Trên nút cục bộ mà
viện dẫn lamexec, đầu vào tiêu chuẩn được kế thừa từ lamexec. Mặc định là những gì đã từng là
tùy chọn -w để ngăn truy cập xung đột vào thiết bị đầu cuối.

LAM hướng đầu ra chuẩn UNIX và lỗi tới daemon LAM trên tất cả các nút từ xa. LAM
vận chuyển tất cả đầu ra / lỗi đã thu thập đến nút đã gọi lamexec và in nó trên
đầu ra tiêu chuẩn / lỗi của lamexec. Các quy trình cục bộ kế thừa đầu ra / lỗi tiêu chuẩn của
lamexec và chuyển trực tiếp đến nó.

Do đó, có thể chuyển hướng I / O tiêu chuẩn cho các ứng dụng LAM bằng cách sử dụng
quy trình chuyển hướng shell trên lamexec.

% lamexec N my_app my_input my_output

Sản phẩm -f tùy chọn tránh tất cả các thiết lập cần thiết để hỗ trợ I / O tiêu chuẩn được mô tả ở trên.
Các quy trình từ xa hoàn toàn được hướng đến / dev / null và các quy trình cục bộ kế thừa tệp
bộ mô tả từ xe lam(1).

giả-tty hỗ trợ
Sản phẩm -pty đã bật tùy chọn hỗ trợ giả tty cho đầu ra quy trình. Điều này cho phép, trong số các
mọi thứ, cho đầu ra có bộ đệm dòng từ các nút ở xa (có thể là những gì bạn muốn).

Tùy chọn này hiện không phải là tùy chọn mặc định cho lamexec bởi vì nó chưa được triệt để
được thử nghiệm trên nhiều Unix khác nhau. Người dùng được khuyến khích sử dụng -pty và báo cáo bất kỳ
vấn đề trở lại Nhóm LAM.

Current Đang làm việc thư mục
Thư mục làm việc hiện tại cho các quy trình mới được tạo trên nút cục bộ được kế thừa
từ lamexec. Thư mục làm việc hiện tại cho các quy trình mới được tạo trên các nút từ xa là
thư mục chính của người dùng từ xa. Hành vi mặc định này bị ghi đè bởi -D tùy chọn.

Sản phẩm -D tùy chọn sẽ thay đổi thư mục làm việc hiện tại của các quy trình mới thành thư mục
nơi tệp thực thi nằm trước khi chương trình của người dùng mới được gọi.

Một sự thay thế cho -D tùy chọn là -wd tùy chọn. -wd cho phép người dùng chỉ định một
thư mục làm việc hiện tại tùy ý (so với vị trí của tệp thực thi). Lưu ý rằng
-wd tùy chọn có thể được sử dụng trong các tệp lược đồ ứng dụng (xem ứng dụng(5)) nữa.

Quy trình xét duyệt Môi trường
Các quy trình trong ứng dụng kế thừa môi trường của chúng từ daemon LAM trên nút
mà họ đang chạy. Môi trường của daemon LAM được cố định khi khởi động
LAM với xe lam(1) và được kế thừa từ shell của người dùng. Trên nút gốc, nút này sẽ
là cái vỏ mà từ đó xe lam(1) đã được gọi và trên các nút từ xa, đây sẽ là trình bao
bắt đầu bởi rsh(1). Khi chạy các ứng dụng được liên kết động yêu cầu
Biến môi trường LD_LIBRARY_PATH sẽ được đặt, cần phải cẩn thận để đảm bảo rằng nó
được thiết lập chính xác khi khởi động LAM.

Xuất khẩu Môi trường Biến
Sản phẩm -x tùy chọn để lamexec có thể được sử dụng để xuất các biến môi trường cụ thể sang
các quy trình. Trong khi cú pháp của -x tùy chọn cho phép định nghĩa các biến mới, lưu ý
rằng trình phân tích cú pháp cho tùy chọn này hiện không quá phức tạp - nó thậm chí không
hiểu các giá trị được trích dẫn. Người dùng nên đặt các biến trong môi trường và sử dụng
-x để xuất khẩu chúng; không phải để xác định chúng.

VÍ DỤ

lamexec N prog1
Tải và thực thi prog1 trên tất cả các nút. Tìm kiếm tệp thực thi trên mỗi nút.

lamexec -c 8 prog1
Chạy 8 bản sao của prog1 ở bất cứ nơi nào LAM muốn chạy chúng.

lamexec n8-10 -v -nw -s n3 prog1 - -q
Tải và thực thi prog1 trên các nút 8, 9 và 10. Tìm kiếm prog1 trên nút 3 và chuyển
nó đến ba nút mục tiêu. Báo cáo khi mỗi quá trình được tạo. Cho "-q" dưới dạng
dòng lệnh cho mỗi quá trình mới. Đừng đợi quá trình hoàn tất trước đó
thoát ra lamexec.

lamexec -v ứng dụng của tôi
Phân tích cú pháp lược đồ ứng dụng, myapp và bắt đầu tất cả các quy trình được chỉ định trong đó. Bản báo cáo
khi mỗi quá trình được tạo.

lamexec NN -pty -wd / workstuff / output -x DISPLAY run_app.csh
Chạy ứng dụng "run_app.csh" (giả sử là tập lệnh shell C) hai lần trên mỗi nút trong
hệ thống (lý tưởng cho SMP 2 chiều). Đồng thời bật hỗ trợ pseudo-tty, thay đổi thư mục
sang / workstuff / output và xuất biến DISPLAY sang các quy trình mới (có lẽ
tập lệnh shell sẽ gọi một ứng dụng X chẳng hạn như xv để hiển thị đầu ra).

lamexec -np 5 -D `pwd` / my_application
Một cách sử dụng phổ biến của lamexec trong môi trường nơi hệ thống tệp được chia sẻ giữa tất cả
các nút trong máy đa máy tính, bằng cách sử dụng lệnh "pwd" thoát khỏi shell chỉ định toàn bộ
tên của tệp thực thi để chạy. Điều này ngăn cản sự cần thiết phải đưa thư mục vào
con đường; các ghi chú từ xa sẽ có một tên tệp tuyệt đối để thực thi (và thay đổi
thư mục đến nó khi được gọi).

CHẨN ĐOÁN

lamexec: Lỗi định dạng thực thi
Một ký tự không phải ASCII đã được phát hiện trong lược đồ ứng dụng. Đây thường là một
lỗi sử dụng dòng lệnh ở đâu lamexec đang mong đợi một giản đồ ứng dụng và một
tệp thực thi đã được cung cấp.

lamexec: lỗi cú pháp trong lược đồ ứng dụng, dòng XXX
Không thể phân tích cú pháp lược đồ ứng dụng do lỗi sử dụng hoặc cú pháp trên
dòng đã cho trong tệp.

tên tệp: Không có tệp hoặc thư mục như vậy
Lỗi này có thể xảy ra trong hai trường hợp. Không thể định vị tệp đã đặt tên hoặc tệp có
được tìm thấy nhưng người dùng không có đủ quyền để thực thi chương trình hoặc
đọc lược đồ ứng dụng.

TRỞ VỀ VALUE

lamexec trả về 0 nếu tất cả các quá trình bắt đầu bởi lamexec thoát ra bình thường. Giá trị khác XNUMX là
được trả lại nếu xảy ra lỗi nội bộ trong lamexec hoặc một hoặc nhiều quy trình đã thoát
một cách bất thường. Nếu xảy ra lỗi nội bộ trong lamexec, mã lỗi tương ứng là
trả lại. Trong trường hợp một hoặc nhiều quy trình thoát với mã thoát khác XNUMX,
trả về giá trị của quá trình mà lamexec thông báo đầu tiên chết bất thường sẽ được trả lại.
Lưu ý rằng, nói chung, đây sẽ là quy trình đầu tiên bị chết nhưng không đảm bảo
được như vậy.

Tuy nhiên, lưu ý rằng nếu -nw công tắc được sử dụng, giá trị trả về từ lamexec không
cho biết trạng thái thoát của các quy trình do nó bắt đầu.

Sử dụng lamexec trực tuyến bằng các dịch vụ onworks.net