servertool(1) Java IDL and RMI-IIOP Tools servertool(1)

servertool - رابطی با استفاده آسان برای توسعه‌دهندگان جهت ثبت، لغو ثبت، راه‌اندازی و خاموش کردن یک سرور پایا فراهم می‌کند.

servertool -ORBInitialPort nameserverport [ options ] [ commands ]
گزینه‌های خط فرمان. بخش گزینه‌ها را ببینید.
دستورهای خط فرمان. بخش دستورها را ببینید.

دستور servertool رابط خط فرمانی را برای توسعه‌دهندگان فراهم می‌کند تا یک سرور پایا (persistent) را ثبت، لغو ثبت، راه‌اندازی و متوقف کنند. دستورهای خط فرمان به شما امکان می‌دهند اطلاعات آماری گوناگونی درباره سرور به دست آورید. بخش دستورها را ببینید.


این گزینه الزامی است. این گزینه ماشین میزبانی را مشخص می‌کند که سرور نام (name server) روی آن اجرا می‌شود و به درخواست‌های ورودی گوش می‌دهد. مقدار nameserverhost باید پورتی را مشخص کند که orb روی آن در حال اجرا و گوش دادن به درخواست‌ها است. در صورت مشخص نشدن این گزینه، مقدار به طور پیش‌فرض localhost است. اگر orbd و servertool روی ماشین‌های متفاوتی اجرا می‌شوند، باید نام یا نشانی IP میزبانی که orbd روی آن در حال اجرا است را مشخص کنید.

نکته: در Oracle Solaris، برای راه‌اندازی یک پردازش روی پورت زیر ۱۰۲۴ باید کاربر root باشید. شرکت Oracle توصیه می‌کند برای مقدار nameserverport از شماره پورت بزرگتر یا مساوی ۱۰۲۴ استفاده کنید.


گزینه option را به ماشین مجازی جاوا (JVM) ارسال می‌کند، که در آن option یکی از گزینه‌های شرح‌داده‌شده در صفحه ارجاع راه‌انداز برنامه جاوا است. برای نمونه، -J-Xms48m حافظه راه‌اندازی را روی ۴۸ مگابایت تنظیم می‌کند. java(1) را ببینید.

شما می‌توانید دستور servertool را همراه با یک دستور خط فرمان یا بدون آن اجرا کنید.

•
اگر هنگام اجرای servertool دستوری مشخص نکنید، ابزار خط فرمان اعلان servertool را نمایش می‌دهد که در آن می‌توانید دستورها را وارد کنید: servertool >.
•
اگر هنگام اجرای servertool دستوری را مشخص کنید، ابزار Java IDL Server Tool اجرا می‌شود، دستور را اجرا می‌کند و خارج می‌شود.
register -server server-class-name -classpath classpath-to-server [ -applicationName application-name -args args-to-server -vmargs flags-for-JVM ]
یک سرور پایای جدید را در دیمن کارگزار درخواست شیء (ORBD) ثبت می‌کند. اگر سرور قبلاً ثبت نشده باشد، ثبت و فعال می‌شود. این دستور موجب فراخوانی یک متد نصب در کلاس main سرور مشخص‌شده با گزینه -server می‌شود. متد نصب باید به صورت public static void install(org.omg.CORBA.ORB) باشد. متد install اختیاری است و به توسعه‌دهندگان اجازه می‌دهد رفتار سفارشی نصب سرور خود را ارائه دهند، مانند ایجاد یک طرح پایگاه داده (database schema).
unregister -serverid server-id | -applicationName application-name
یک سرور را با استفاده از شناسه سرور (server ID) یا نام برنامه (application name) از ORBD لغو ثبت می‌کند. این دستور موجب فراخوانی یک متد حذف نصب در کلاس main سرور مشخص‌شده با گزینه -server می‌شود. متد uninstall باید به صورت public static void uninstall(org.omg.CORBA.ORB) باشد. متد uninstall اختیاری است و به توسعه‌دهندگان امکان می‌دهد رفتار سفارشی حذف نصب سرور خود را ارائه دهند، مانند لغو تغییرات ایجاد شده توسط متد install.
شناسه سرور متناظر با مقدار application-name را بازمی‌گرداند.
اطلاعات تمام سرورهای پایای ثبت‌شده در ORBD را فهرست می‌کند.
نام برنامه‌های تمام سرورهایی که در حال حاضر در ORBD ثبت شده‌اند را فهرست می‌کند.
اطلاعات تمام سرورهای پایایی که توسط ORBD راه‌اندازی شده‌اند و در حال حاضر در حال اجرا هستند را فهرست می‌کند.
locate -serverid server-id | -applicationName application-name [ -endpointType endpointType ]
نقاط انتهایی (پورت‌های) یک نوع خاص را برای تمام ORBهای ایجاد شده توسط یک سرور ثبت‌شده پیدا می‌کند. اگر سرور هنوز در حال اجرا نباشد، فعال می‌شود. اگر مقداری برای endpointType مشخص نشود، نقطه انتهایی عادی/محافظت‌نشده مرتبط با هر ORB در سرور بازگردانده می‌شود.
locateperorb -serverid server-id | -applicationName application-name [ -orbid ORB-name ]
تمام نقاط انتهایی (پورت‌های) ثبت‌شده توسط یک کارگزار درخواست شیء (ORB) خاص از یک سرور ثبت‌شده را پیدا می‌کند. اگر سرور هنوز در حال اجرا نباشد، فعال می‌شود. اگر orbid مشخص نشود، مقدار پیش‌فرض "" به orbid اختصاص می‌یابد. اگر هر ORB با مقدار orbid رشته خالی ایجاد شده باشد، تمام پورت‌های ثبت‌شده توسط آن بازگردانده می‌شوند.
مقدار ORBId مربوط به ORBهای تعریف‌شده در یک سرور را فهرست می‌کند. یک ORBId نام رشته‌ای برای ORB ایجاد شده توسط سرور است. اگر سرور هنوز در حال اجرا نباشد، فعال می‌شود.
یک سرور فعال ثبت‌شده در ORBD را خاموش می‌کند. هنگام اجرای این دستور، متد shutdown تعریف‌شده در کلاسی که با پارامتر -serverid یا -applicationName مشخص شده نیز برای خاموش کردن پردازش سرور فراخوانی می‌شود.
یک سرور ثبت‌شده در ORBD را راه‌اندازی یا فعال می‌کند. اگر سرور در حال اجرا نباشد، این دستور سرور را راه‌اندازی می‌کند. اگر سرور از قبل در حال اجرا باشد، یک پیام خطا نمایش داده می‌شود.
تمام دستورهای در دسترس سرور از طریق دستور servertool را فهرست می‌کند.
از دستور servertool خارج می‌شود.

•
orbd(1)
21 November 2013 JDK 8