'\" t .\" Copyright (c) 2001, 2013, Oracle and/or its affiliates. All rights reserved. .\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. .\" .\" This code is free software; you can redistribute it and/or modify it .\" under the terms of the GNU General Public License version 2 only, as .\" published by the Free Software Foundation. .\" .\" This code is distributed in the hope that it will be useful, but WITHOUT .\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or .\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License .\" version 2 for more details (a copy is included in the LICENSE file that .\" accompanied this code). .\" .\" You should have received a copy of the GNU General Public License version .\" 2 along with this work; if not, write to the Free Software Foundation, .\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. .\" .\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA .\" or visit www.oracle.com if you need additional information or have any .\" questions. .\" .\" Arch: generic .\" Software: JDK 8 .\" Date: 21 November 2013 .\" SectDesc: Java IDL and RMI-IIOP Tools .\" Title: orbd.1 .\" .if n .pl 99999 .TH orbd 1 "21 November 2013" "JDK 8" "Java IDL and RMI-IIOP Tools" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" orbd \- به کلاینت‌ها امکان می‌دهد تا اشیای ماندگار را روی سرورها در محیط CORBA مکان‌یابی کرده و فراخوانی کنند\&. .SH "خلاصه دستور (SYNOPSIS)" .sp .nf \fBorbd\fR [ \fIoptions\fR ] .fi .sp .TP \fIoptions\fR گزینه‌های خط فرمان\&. بخش گزینه‌ها را ببینید\&. .SH "توضیحات (DESCRIPTION)" دستور \f3orbd\fR به کلاینت‌ها امکان می‌دهد تا به‌صورت شفاف، اشیای ماندگار را روی سرورها در محیط CORBA مکان‌یابی و فراخوانی کنند\&. مدیر سرور (Server Manager) ارائه‌شده همراه با ابزار orbd برای توانمندسازی کلاینت‌ها در مکان‌یابی و فراخوانی شفاف اشیای ماندگار روی سرورها در محیط CORBA استفاده می‌شود\&. سرورهای ماندگار، هنگام انتشار ارجاعات اشیای ماندگار در سرویس نام‌گذاری (naming service)، به جای شماره پورت سرور، شماره پورت ORBD را در ارجاع شیء قرار می‌دهند\&. گنجاندن شماره پورت ORBD در ارجاع شیء برای ارجاعات اشیای ماندگار دارای مزایای زیر است: .TP 0.2i \(bu ارجاع شیء در سرویس نام‌گذاری مستقل از چرخه حیات سرور باقی می‌ماند\&. به عنوان مثال، ارجاع شیء می‌تواند در نخستین نصب سرور توسط آن در سرویس نام‌گذاری منتشر شود، و سپس مستقل از تعداد دفعات راه‌اندازی یا متوقف شدن سرور، ORBD ارجاع شیء صحیح را به کلاینت فراخواننده بازمی‌گرداند\&. .TP 0.2i \(bu کلاینت تنها یک بار نیاز به جستجوی ارجاع شیء در سرویس نام‌گذاری دارد و می‌تواند بدون وابستگی به تغییرات ناشی از چرخه حیات سرور، از این ارجاع دوباره استفاده کند\&. .PP برای دسترسی به مدیر سرور ORBD، سرور باید با استفاده از \f3servertool\fR راه‌اندازی شود که یک رابط خط فرمان برای برنامه‌نویسان جهت ثبت، لغو ثبت، راه‌اندازی و خاموش کردن یک سرور ماندگار است\&. برای اطلاعات بیشتر در مورد مدیر سرور، به بخش مدیر سرور مراجعه کنید\&. .PP هنگامی که \f3orbd\fR شروع به کار می‌کند، یک سرویس نام‌گذاری را نیز راه‌اندازی می‌نماید\&. برای اطلاعات بیشتر در مورد سرویس نام‌گذاری، به بخش شروع و توقف سرویس نام‌گذاری مراجعه کنید\&. .SH "گزینه‌ها (OPTIONS)" .TP -ORBInitialPort \fInameserverport\fR .br اجباری\&. پورتی را که سرور نام (name server) باید روی آن شروع به کار کند مشخص می‌کند\&. پس از شروع، \f3orbd\fR به درخواست‌های دریافتی روی این پورت گوش می‌دهد\&. در سیستم‌عامل Oracle Solaris، برای راه‌اندازی یک پردازش روی پورت کمتر از 1024 باید کاربر ریشه (root) باشید\&. به همین دلیل، اوراکل توصیه می‌کند از شماره پورت بزرگتر یا مساوی 1024 استفاده کنید\&. .SS "گزینه‌های غیراجباری (NONREQUIRED OPTIONS)" .TP -port \fIport\fR .br پورت فعال‌سازی را مشخص می‌کند که در آن ORBD باید راه‌اندازی شود و درخواست‌های اشیای ماندگار را بپذیرد\&. مقدار پیش‌فرض این پورت 1049 است\&. این شماره پورت به فیلد پورت ارجاعات اشیای هم‌کنش‌پذیر ماندگار (IOR) اضافه می‌شود\&. .TP -defaultdb \fIdirectory\fR .br مسیر پایه‌ای را مشخص می‌کند که دایرکتوری ذخیره‌سازی ماندگار ORBD، یعنی \f3orb\&.db\fR، در آن ایجاد می‌شود\&. اگر این گزینه مشخص نشود، مقدار پیش‌فرض \f3\&./orb\&.db\fR خواهد بود\&. .TP -serverPollingTime \fImilliseconds\fR .br مشخص می‌کند ORBD هر چند وقت یک‌بار سلامت سرورهای ماندگار ثبت‌شده از طریق \f3servertool\fR را بررسی کند\&. مقدار پیش‌فرض 1000 میلی‌ثانیه است\&. مقدار مشخص‌شده برای \f3milliseconds\fR باید یک عدد صحیح مثبت معتبر باشد\&. .TP -serverStartupDelay milliseconds .br مشخص می‌کند ORBD پس از راه‌اندازی مجدد یک سرور ماندگار که از طریق \f3servertool\fR ثبت شده است، چه مدت پیش از ارسال استثنای هدایت مکان (location forward exception) منتظر بماند\&. مقدار پیش‌فرض 1000 میلی‌ثانیه است\&. مقدار مشخص‌شده برای \f3milliseconds\fR باید یک عدد صحیح مثبت معتبر باشد\&. .TP -J\fIoption\fR .br گزینه \f3option\fR را به ماشین مجازی جاوا (JVM) ارسال می‌کند، که در آن \f3option\fR یکی از گزینه‌های شرح داده‌شده در صفحه راهنمای راه‌انداز برنامه‌های جاوا است\&. برای نمونه، \f3-J-Xms48m\fR حافظه راه‌اندازی را روی 48 مگابایت تنظیم می‌کند\&. به java(1) مراجعه کنید\&. .SS "شروع و توقف سرویس نام‌گذاری (START AND STOP THE NAMING SERVICE)" سرویس نام‌گذاری یک سرویس CORBA است که امکان نام‌گذاری اشیای CORBA را از طریق پیوند دادن یک نام به یک ارجاع شیء فراهم می‌کند\&. پیوند نام را می‌توان در سرویس نام‌گذاری ذخیره کرد، و یک کلاینت می‌تواند نام را ارائه دهد تا ارجاع شیء مورد نظر را به دست آورد\&. .PP پیش از اجرای کلاینت یا سرور، شما ORBD را راه‌اندازی می‌کنید\&. ORBD شامل یک سرویس نام‌گذاری ماندگار و یک سرویس نام‌گذاری گذرا است که هر دو پیاده‌سازی سرویس نام‌گذاری COS هستند\&. .PP سرویس نام‌گذاری ماندگار پایداری و ماندگاری را برای زمینه‌های نام‌گذاری فراهم می‌کند\&. این بدان معناست که این اطلاعات در بین خاموش شدن‌ها و راه‌اندازی‌های سرویس پایدار می‌ماند و در صورت بروز خرابی در سرویس، قابل بازیابی است\&. اگر ORBD مجدداً راه‌اندازی شود، سرویس نام‌گذاری ماندگار نمودار زمینه نام‌گذاری را بازیابی می‌کند، به‌طوری که پیوند نام‌های تمام کلاینت‌ها و سرورها دست‌نخورده (پایدار) باقی می‌ماند\&. .PP برای سازگاری با نسخه‌های پیشین، \f3tnameserv\fR که یک سرویس نام‌گذاری گذرا ارائه‌شده در نسخه‌های قبلی JDK بود، در این نسخه از Java SE نیز گنجانده شده است\&. یک سرویس نام‌گذاری گذرا تا زمانی که در حال اجرا است، زمینه‌های نام‌گذاری را حفظ می‌کند\&. در صورت بروز وقفه در سرویس، نمودار زمینه نام‌گذاری از دست می‌رود\&. .PP آرگومان \f3-ORBInitialPort\fR یک آرگومان خط فرمان الزامی برای \f3orbd\fR است و برای تنظیم شماره پورتی که سرویس نام‌گذاری روی آن اجرا می‌شود به کار می‌رود\&. دستورالعمل‌های زیر فرض می‌کنند که می‌توانید از پورت 1050 برای دیمن کارگزار درخواست شیء جاوا IDL استفاده کنید\&. هنگام استفاده از نرم‌افزار Oracle Solaris، برای راه‌اندازی یک پردازش روی پورت کمتر از 1024 باید کاربر ریشه (root) باشید\&. به همین دلیل، توصیه می‌شود از شماره پورت بزرگتر یا مساوی 1024 استفاده کنید\&. در صورت لزوم می‌توانید از پورت دیگری استفاده نمایید\&. .PP برای راه‌اندازی \f3orbd\fR از پوسته یونیکس، دستور زیر را وارد کنید: .sp .nf \f3orbd \-ORBInitialPort 1050&\fP .fi .sp از اعلان سیستم MS-DOS (ویندوز)، دستور زیر را وارد کنید: .sp .nf \f3start orbd \-ORBInitialPort 1050\fP .fi .sp اکنون که ORBD در حال اجرا است، می‌توانید برنامه‌های سرور و کلاینت خود را اجرا کنید\&. هنگام اجرای برنامه‌های کلاینت و سرور، آنها باید از شماره پورت (و نام دستگاه، در صورت لزوم) که سرویس نام‌گذاری در آن در حال اجرا است مطلع شوند\&. یک روش برای انجام این کار افزودن کد زیر به برنامه شما است: .sp .nf \f3Properties props = new Properties();\fP .fi .nf \f3props\&.put("org\&.omg\&.CORBA\&.ORBInitialPort", "1050");\fP .fi .nf \f3props\&.put("org\&.omg\&.CORBA\&.ORBInitialHost", "MyHost");\fP .fi .nf \f3ORB orb = ORB\&.init(args, props);\fP .fi .sp در این مثال، سرویس نام‌گذاری روی پورت 1050 در میزبان \f3MyHost\fR در حال اجرا است\&. روش دیگر مشخص کردن شماره پورت یا نام دستگاه در هنگام اجرای برنامه سرور یا کلاینت از خط فرمان است\&. برای نمونه، می‌توانید برنامه \f3HelloApplication\fR خود را با خط فرمان زیر راه‌اندازی کنید: .sp .nf \f3java HelloApplication \-ORBInitialPort 1050 \-ORBInitialHost MyHost\fP .fi .sp برای متوقف کردن سرویس نام‌گذاری، از دستور مربوط به سیستم‌عامل استفاده کنید، مانند \f3pkill orbd\fR در Oracle Solaris، یا \fICtrl+C\fR در پنجره اعلان داس که \f3orbd\fR در آن در حال اجرا است\&. توجه داشته باشید که نام‌های ثبت‌شده در سرویس نام‌گذاری ممکن است در صورت خاتمه سرویس به دلیل استفاده از سرویس نام‌گذاری گذرا ناپدید شوند\&. سرویس نام‌گذاری Java IDL تا زمانی که به‌طور صریح متوقف نشود، به اجرا ادامه می‌دهد\&. .PP برای اطلاعات بیشتر درباره سرویس نام‌گذاری همراه با ORBD، به Naming Service در نشانی زیر مراجعه کنید: http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.html .SH "مدیر سرور (SERVER MANAGER)" برای دسترسی به مدیر سرور ORBD و اجرای یک سرور ماندگار، سرور باید با \f3servertool\fR راه‌اندازی شود که یک رابط خط فرمان برای برنامه‌نویسان جهت ثبت، لغو ثبت، راه‌اندازی و خاموش کردن یک سرور ماندگار است\&. هنگامی که یک سرور با استفاده از \f3servertool\fR راه‌اندازی می‌شود، باید روی همان میزبان و پورتی که \f3orbd\fR اجرا می‌شود راه‌اندازی گردد\&. اگر سرور روی پورت متفاوتی اجرا شود، اطلاعات ذخیره‌شده در پایگاه‌داده برای زمینه‌های محلی نامعتبر خواهد بود و سرویس به درستی کار نخواهد کرد\&. .PP به Java IDL: The "Hello World" Example در نشانی زیر مراجعه کنید: http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlExample\&.html .PP در این مثال، کامپایلر \f3idlj\fR و کامپایلر \f3javac\fR را همان‌طور که در آموزش نشان داده شده است اجرا می‌کنید\&. برای اجرای مدیر سرور ORBD، این مراحل را برای اجرای برنامه دنبال کنید: .PP راه‌اندازی \f3orbd\fR\&. .PP پوسته یونیکس، وارد کنید: \f3orbd -ORBInitialPort 1050\fR\&. .PP اعلان سیستم MS-DOS (ویندوز)، وارد کنید: \f3start orbd -ORBInitialPort 1050\fR\&. .PP پورت 1050 پورتی است که می‌خواهید سرور نام روی آن اجرا شود\&. گزینه \f3-ORBInitialPort\fR یک آرگومان خط فرمان الزامی است\&. هنگام استفاده از نرم‌افزار Oracle Solaris، برای راه‌اندازی یک پردازش روی پورت کمتر از 1024 باید کاربر ریشه (root) باشید\&. به همین دلیل، توصیه می‌شود از شماره پورت بزرگتر یا مساوی 1024 استفاده کنید\&. .PP راه‌اندازی \f3servertool\fR: \f3servertool -ORBInitialPort 1050\fR\&. .PP اطمینان حاصل کنید که پورت سرور نام (\f3orbd\fR) همانند مرحله قبل است، برای مثال \f3-ORBInitialPort 1050\&.\fR ابزار \f3servertool\fR باید روی همان پورت سرور نام راه‌اندازی شود\&. .PP در رابط خط فرمان \f3servertool\fR، سرور \f3Hello\fR را از اعلان \f3servertool\fR راه‌اندازی کنید: .sp .nf \f3servertool > register \-server HelloServer \-classpath \&. \-applicationName\fP .fi .nf \f3 HelloServerApName\fP .fi .sp ابزار \f3servertool\fR سرور را ثبت می‌کند، نام \f3HelloServerApName\fR را به آن اختصاص می‌دهد و شناسه سرور آن را به همراه فهرستی از تمام سرورهای ثبت‌شده نمایش می‌دهد\&. برنامه کلاینت را از پنجره ترمینال یا اعلان دیگری اجرا کنید: .sp .nf \f3java HelloClient \-ORBInitialPort 1050 \-ORBInitialHost localhost\fP .fi .sp برای این مثال، می‌توانید \f3-ORBInitialHost localhost\fR را حذف کنید زیرا سرور نام روی همان میزبانی اجرا می‌شود که کلاینت \f3Hello\fR در آن در حال اجرا است\&. اگر سرور نام روی میزبان متفاوتی در حال اجرا است، از گزینه \f3-ORBInitialHost nameserverhost\fR برای مشخص کردن میزبانی که سرور نام IDL در آن اجرا می‌شود استفاده کنید\&. پورت سرور نام (\f3orbd\fR) را همانند مرحله قبل مشخص کنید، برای مثال \f3-ORBInitialPort 1050\fR\&. هنگامی که کار شما با مدیر سرور ORBD پایان یافت، حتماً سرور نام (\f3orbd\fR) و \f3servertool\fR را خاموش یا متوقف کنید\&. برای متوقف کردن \f3orbd\fR از اعلان MS-DOS، پنجره‌ای را که سرور در آن در حال اجرا است انتخاب کرده و کلیدهای ترکیبی \fICtrl+C\fR را برای خاموش کردن آن فشار دهید\&. .PP برای خاموش کردن \f3orbd\fR از پوسته Oracle Solaris، پردازش را پیدا کرده و با دستور \f3kill\fR خاتمه دهید\&. سرور تا زمانی که به‌طور صریح متوقف نشود، به انتظار برای فراخوانی‌ها ادامه می‌دهد\&. برای متوقف کردن \f3servertool\fR، عبارت \fIquit\fR را تایپ کرده و کلید \fIEnter\fR را فشار دهید\&. .SH "همچنین ببینید (SEE ALSO)" .TP 0.2i \(bu servertool(1) .TP 0.2i \(bu راهنمای Naming Service در نشانی http://docs\&.oracle\&.com/javase/8/docs/technotes/guides/idl/jidlNaming\&.html .RE .br 'pl 8.5i 'bp