'\" 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: servertool.1
.\"
.if n .pl 99999
.TH servertool 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)"
servertool \- رابطی با استفاده آسان برای توسعه‌دهندگان جهت ثبت، لغو ثبت، راه‌اندازی و خاموش کردن یک سرور پایا فراهم می‌کند\&.
.SH "خلاصه دستور (SYNOPSIS)"
.sp     
.nf     

\fBservertool\fR \-ORBInitialPort \fInameserverport\fR [ \fIoptions\fR ] [ \fIcommands \fR]
.fi     
.sp     
.TP     
\fIoptions\fR
گزینه‌های خط فرمان\&. بخش گزینه‌ها را ببینید\&.
.TP     
commands
دستورهای خط فرمان\&. بخش دستورها را ببینید\&.
.SH "توضیحات (DESCRIPTION)"
دستور \f3servertool\fR رابط خط فرمانی را برای توسعه‌دهندگان فراهم می‌کند تا یک سرور پایا (persistent) را ثبت، لغو ثبت، راه‌اندازی و متوقف کنند\&. دستورهای خط فرمان به شما امکان می‌دهند اطلاعات آماری گوناگونی درباره سرور به دست آورید\&. بخش دستورها را ببینید\&.
.SH "گزینه‌ها (OPTIONS)"
.TP
-ORBInitialHost \fInameserverhost\fR
.br
این گزینه الزامی است\&. این گزینه ماشین میزبانی را مشخص می‌کند که سرور نام (name server) روی آن اجرا می‌شود و به درخواست‌های ورودی گوش می‌دهد\&. مقدار \f3nameserverhost\fR باید پورتی را مشخص کند که \f3orb\fR روی آن در حال اجرا و گوش دادن به درخواست‌ها است\&. در صورت مشخص نشدن این گزینه، مقدار به طور پیش‌فرض \f3localhost\fR است\&. اگر \f3orbd\fR و \f3servertool\fR روی ماشین‌های متفاوتی اجرا می‌شوند، باید نام یا نشانی IP میزبانی که \f3orbd\fR روی آن در حال اجرا است را مشخص کنید\&.

\fIنکته:\fR در Oracle Solaris، برای راه‌اندازی یک پردازش روی پورت زیر ۱۰۲۴ باید کاربر root باشید\&. شرکت Oracle توصیه می‌کند برای مقدار \f3nameserverport\fR از شماره پورت بزرگتر یا مساوی ۱۰۲۴ استفاده کنید\&.
.TP
-J\fIoption\fR
.br
گزینه \f3option\fR را به ماشین مجازی جاوا (JVM) ارسال می‌کند، که در آن \f3option\fR یکی از گزینه‌های شرح‌داده‌شده در صفحه ارجاع راه‌انداز برنامه جاوا است\&. برای نمونه، \f3-J-Xms48m\fR حافظه راه‌اندازی را روی ۴۸ مگابایت تنظیم می‌کند\&. java(1) را ببینید\&.
.SH "دستورها (COMMANDS)"
شما می‌توانید دستور \f3servertool\fR را همراه با یک دستور خط فرمان یا بدون آن اجرا کنید\&.
.TP 0.2i    
\(bu
اگر هنگام اجرای \f3servertool\fR دستوری مشخص نکنید، ابزار خط فرمان اعلان \f3servertool\fR را نمایش می‌دهد که در آن می‌توانید دستورها را وارد کنید: \f3servertool >\fR\&.
.TP 0.2i    
\(bu
اگر هنگام اجرای \f3servertool\fR دستوری را مشخص کنید، ابزار Java IDL Server Tool اجرا می‌شود، دستور را اجرا می‌کند و خارج می‌شود\&.
.TP     
.ll 180
register -server \fIserver-class-name\fR -classpath \fIclasspath-to-server\fR [ -applicationName \fIapplication-name\fR -args \fIargs-to-server\fR -vmargs \fIflags-for-JVM\fR ]
یک سرور پایای جدید را در دیمن کارگزار درخواست شیء (ORBD) ثبت می‌کند\&. اگر سرور قبلاً ثبت نشده باشد، ثبت و فعال می‌شود\&. این دستور موجب فراخوانی یک متد نصب در کلاس \f3main\fR سرور مشخص‌شده با گزینه \f3-server\fR می‌شود\&. متد نصب باید به صورت \f3public static void install(org\&.omg\&.CORBA\&.ORB)\fR باشد\&. متد install اختیاری است و به توسعه‌دهندگان اجازه می‌دهد رفتار سفارشی نصب سرور خود را ارائه دهند، مانند ایجاد یک طرح پایگاه داده (database schema)\&.
.TP     
.ll 180
unregister -serverid \fIserver-id\fR | -applicationName \fIapplication-name\fR
یک سرور را با استفاده از شناسه سرور (server ID) یا نام برنامه (application name) از ORBD لغو ثبت می‌کند\&. این دستور موجب فراخوانی یک متد حذف نصب در کلاس \f3main\fR سرور مشخص‌شده با گزینه \f3-server\fR می‌شود\&. متد \f3uninstall\fR باید به صورت \f3public static void uninstall(org\&.omg\&.CORBA\&.ORB)\fR باشد\&. متد \f3uninstall\fR اختیاری است و به توسعه‌دهندگان امکان می‌دهد رفتار سفارشی حذف نصب سرور خود را ارائه دهند، مانند لغو تغییرات ایجاد شده توسط متد \f3install\fR\&.
.TP     
getserverid -applicationName \fIapplication-name\fR
شناسه سرور متناظر با مقدار \f3application-name\fR را بازمی‌گرداند\&.
.TP     
list
اطلاعات تمام سرورهای پایای ثبت‌شده در ORBD را فهرست می‌کند\&.
.TP     
listappnames
نام برنامه‌های تمام سرورهایی که در حال حاضر در ORBD ثبت شده‌اند را فهرست می‌کند\&.
.TP     
listactive
اطلاعات تمام سرورهای پایایی که توسط ORBD راه‌اندازی شده‌اند و در حال حاضر در حال اجرا هستند را فهرست می‌کند\&.
.TP     
.ll 180
locate -serverid \fIserver-id\fR | -applicationName \fIapplication-name\fR [ -endpointType \fIendpointType\fR ]
نقاط انتهایی (پورت‌های) یک نوع خاص را برای تمام ORBهای ایجاد شده توسط یک سرور ثبت‌شده پیدا می‌کند\&. اگر سرور هنوز در حال اجرا نباشد، فعال می‌شود\&. اگر مقداری برای \f3endpointType\fR مشخص نشود، نقطه انتهایی عادی/محافظت‌نشده مرتبط با هر ORB در سرور بازگردانده می‌شود\&.
.TP     
.ll 180
locateperorb -serverid \fIserver-id\fR | -applicationName \fIapplication-name\fR [ -orbid \fIORB-name\fR ]
تمام نقاط انتهایی (پورت‌های) ثبت‌شده توسط یک کارگزار درخواست شیء (ORB) خاص از یک سرور ثبت‌شده را پیدا می‌کند\&. اگر سرور هنوز در حال اجرا نباشد، فعال می‌شود\&. اگر \f3orbid\fR مشخص نشود، مقدار پیش‌فرض \f3""\fR به \f3orbid\fR اختصاص می‌یابد\&. اگر هر ORB با مقدار \f3orbid\fR رشته خالی ایجاد شده باشد، تمام پورت‌های ثبت‌شده توسط آن بازگردانده می‌شوند\&.
.TP     
orblist -serverid \fIserver-id\fR | -applicationName \fIapplication-name\fR
مقدار \f3ORBId\fR مربوط به ORBهای تعریف‌شده در یک سرور را فهرست می‌کند\&. یک \f3ORBId\fR نام رشته‌ای برای ORB ایجاد شده توسط سرور است\&. اگر سرور هنوز در حال اجرا نباشد، فعال می‌شود\&.
.TP     
shutdown -serverid \fIserver-id\fR | -applicationName application-name
یک سرور فعال ثبت‌شده در ORBD را خاموش می‌کند\&. هنگام اجرای این دستور، متد \f3shutdown\fR تعریف‌شده در کلاسی که با پارامتر \f3-serverid\fR یا \f3-applicationName\fR مشخص شده نیز برای خاموش کردن پردازش سرور فراخوانی می‌شود\&.
.TP     
startup -serverid \fIserver-id\fR | -applicationName application-name
یک سرور ثبت‌شده در ORBD را راه‌اندازی یا فعال می‌کند\&. اگر سرور در حال اجرا نباشد، این دستور سرور را راه‌اندازی می‌کند\&. اگر سرور از قبل در حال اجرا باشد، یک پیام خطا نمایش داده می‌شود\&.
.TP     
help
تمام دستورهای در دسترس سرور از طریق دستور \f3servertool\fR را فهرست می‌کند\&.
.TP     
quit
از دستور \f3servertool\fR خارج می‌شود\&.
.SH "همچنین ببینید (SEE ALSO)"
.TP 0.2i    
\(bu
orbd(1)
.RE
.br
'pl 8.5i
'bp