استخدام وحدة التحكم في سطر الأوامر (CLC)

تتيح وحدة التحكم في سطر الأوامر (CLC) للمسؤولين استخدام سطر الأوامر لتنفيذ وظائف GAX المعينة الخاصة بــ تعريفات الحل (SPDs) وحزم التثبيت (IPs). على سبيل المثال، قد تستخدم CLC لنشر SPDs تلقائيًا على المضيفون البعيدون.

يجب أن تكون قادرًا على الوصول إلى واجهة سطر أوامر نظام التشغيل لاستخدام CLC. إذا لم تكن على جهاز GAX المضيف، فيجب أن تكون أداة CLC (gaxclc.jar) متاحة لديك على الجهاز المحلي.

للوصول إلى ملف تعليمات CLC المضمّن، نفذ أحد الأوامر التالية:

java –jar gaxclc.jar help

java –jar gaxclc.jar ?

Important

بمجرد تنفيذك الأوامر مع CLC، يتم إنشاء ملف السجل في نفس المكان الذي تم تنفيذ الأداه به.

البنية

تدعم CLC الأوامر التي تستخدم البنية التالية:

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> <function> <operation> <args>

في المثال أعلاه:

• -u:user هو اسم المستخدم لتسجيل الدخول في خادم التكوين.
• -p:password هي كلمة المرور لتسجيل الدخول في خادم التكوين. يفترض CLC أنه لا توجد كلمة مرور إذا لم تحدد هذه العلامة قيمة.
• -s لاستخدام اتصال https آمن بخادم GAX. إذا كانت العلامة غير محددة، فإن CLC تستخدم http.
• -h:<host>:<port> تُحدد المضيف ومنفذ الخادم GAX. إذا كانت العلامة غير محددة، فإن CLC تستخدم القيمة التالية. -h:localhost:8080.
• <function> عبارة عن ip أو spd.
• <operation> تُحدد العملية ليتم تنفيذها. تُحدد القيم الصالحة لهذه العملية للوظيفة التي قمت بتحديدها في الخطوة السابقة (ip أو spd).
• <args> تُحدد وسيطات العملية. تُحدد القيم الصالحة لهذه العملية للوظيفة <function> ومعلمات <operation>التي قمت بتحديدها في الخطوات السابقة.

ما يلي هو مثال لأمر CLC:

java -jar gaxclc.jar -u:default -p:password -h:localhost:8080 spd execute 10054 1 "C:/GAX/input.txt"

معلمات SPD

يدعم CLC العمليات التالية لمعلمات SPD:

• إضافة
• استعلام
• استعلام querybyid
• تنفيذ
• حذف
• تشفير (انظر علامة التبويب تنفيذ)

إضافة

نظرة عامة

تضيف هذه العملية SPD إلى قاعدة بيانات GAX. إذا كانت SPD موجودة بالفعل، كما هي محددة من خلال الاسم والإصدار في SPD XML، فإن هذه العملية تستبدل SPD الموجودة.

في حال نجاحها، تقوم العملية بإرجاع معلمات SPD المضافة.

التنسيق

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd add "file path"

• "مسار الملف"—المسار إلى ملف XML.

مثال

java -jar gaxclc.jar -u:default -p:password spd add "c:\GAX\newSpd.xml"

استعلام

نظرة عامة

تستعلم هذه العملية عن جميع معلمات SPD وتعرض جدولاً يدرج التفاصيل التالية لكل معلمة SPD:

• رقم المعرف
• الاسم
• الإصدار
• معرف DBID للمستأجر

إليك المثال التالي:

10054 gvp 8.1.5 1
10060 genesysOne 8.1.5 1
10060 eServices 8.1.5 1

التنسيق

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd query

مثال

java -jar gaxclc.jar -u:default -p:password -s -h:132.45.43.45:443 spd query

استعلام querybyid

نظرة عامة

تستعلم هذه العملية عن SPD من خلال معرفها. إذا لم تكن SPD موجودة، سوف تفشل العملية.

في حال نجاحها، تعرض العملية جدول يُدرج التفاصيل التالية عن SPD:

• معرف ملف التعريف
• الاسم

على سبيل المثال:

1 Install

التنسيق

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd query SPDID

• SPDID—معرف SPD الذي يجري الاستعلام عنه.

مثال

java -jar gaxclc.jar -u:default -p:password -h:132.45.43.45:8080 spd query 4374

تنفيذ

نظرة عامة

تنفذ هذه العملية معرف SPD.

التنسيق

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd execute SPDID profileName|-profileID:profileID|-profileName:profileName -encrypted "input file"

• SPDID—معرف SPD المطلوب تنفيذه.
• profileName|-profileID:profileID|-profileName:profileName—ملف تعريف SPD المطلوب تنفيذه.

Important

إذا لم يتم تحديد علامة، من ثم يفترض تنفيذ profileName مثلها مثل ملف تعريف

SPD.

• -encrypted—إذا تم تحديدها، فتوضح ما إذا كان قد تم تشفير ملف الإدخال.

[+] عرض الاستخدام

توفر CLC دعم التشفير لملفات الإدخال التي تحتوي على بيانات حساسة مثل كلمات المرور.

تنسيق:

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd encrypt "input file path" "encrypted output file path"

يتم تخزين ملف الإدخال المشفر في الموقع المحدد بواسطة "مسار ملف إخراج مشفر". إذا كان الملف موجود بالفعل في هذا المكان، فسوف يتم استبداله.

مثال:

java -jar gaxclc.jar -u:default -p:password spd -encrypted "c:\GAX\input.txt" "c:\GAX\encrypted.txt"

java -jar gaxclc.jar -u:default -p:password spd -encrypted "input.txt" "encrypted.txt"

• "ملف الإدخال"—تحديد ملف الإدخال الذي يحتوي على معلمات SPD. إذا تم تعيين -encrypted، فسيتم تشفير ملف الإدخال.

يجب أن يكون ملف الإدخال في صيغة JSONObject ويحتوي على معلمات SPD لملف التعريف المحدد. يجب أن يتم ترميز الملف في التنسيق UTF-8.

[+] عرض الاستخدام

نوع السلسلة

فيما يلي وصف بنية الإدخال لنوع سلسلة:

{
	"Dialog name" : {
		"Input name" : "string"
	}
}

مثال

ملف تعريف SPD

<profile name="Install">
 <dialog step="Step1">
	<input name="NAME_PARAM1" title="PERSON NAME"  default="birit" type="string" required="true">
	   <description>Please enter the person name</description>
	</input>
 </dialog>
 <dialog step="Step2">
	<input name="NAME_PARAM2" title="PERSON NAME"  default="birit" type="string" required="true">
	   <description>Please enter the person name</description>
	</input>
 </dialog>
 <execution>
	<script>
		log('string test' );
	</script>
 </execution>
</profile>

ملف الإدخال لملف تعريف التثبيت

{
	"Step1" : {
		"NAME_PARAM1" : "Kate"
	},
	"Step2" : {
		"NAME_PARAM2" : "John"
	}
}

نوع بيانات منطقي

فيما يلي وصف لبنية الإدخال لنوع بيانات منطقي:

{
	"Dialog name" : {
		"Input name" : true/false
	}
}

مثال

ملف تعريف SPD

<profile name="Install">
 <dialog step="Step1">
	<input name="STATUS" title="status"  type="boolean" required="true">
	   <description>status field</description>
	</input>
 </dialog>
 <execution>
	<script>
		log('boolean test');
	</script>
 </execution>
</profile>

ملف الإدخال لملف تعريف التثبيت

{
	"Step1" : {
		"STATUS" : true
	}
}

نوع عدد صحيح

فيما يلي وصف لبنية الإدخال لنوع عدد صحيح:

{
	"Dialog name" : {
		"Input name" : <integer>
	}
}

مثال

ملف تعريف SPD

<profile name="Install">
 <dialog step="Step1">
	<input name="NUMBER" title="number"  type="integer" required="true">
	   <description>number field</description>
	</input>
 </dialog>
 <execution>
	<script>
		log('number test');
	</script>
 </execution>
</profile>

ملف الإدخال لملف تعريف التثبيت

{
	"Step1" : {
		"NUMBER" : 132
	}
}

نوع كلمة المرور

فيما يلي وصف لبنية إدخال لنوع كلمة مرور:

{
	"Dialog name" : {
		"Input name" : "password"
	}
}

Important

يجب تشفير ملفات الإدخال التي تشمل على بيانات حساسة مثل كلمات المرور باستخدام عملية التشفير SPD.

مثال

ملف تعريف SPD

<profile name="Install">
 <dialog step="Step1">
	<input name="PASSWORD" title="password"  type="password" required="true">
	   <description>password field</description>
	</input>
 </dialog>
 <execution>
	<script>
		log('password test');
	</script>
 </execution>
</profile>

ملف الإدخال لملف تعريف التثبيت

{
	"Step1" : {
		"PASSWORD" : "xyz9846gdkjg"
	}
}

النوع "تحديد واحد"

فيما يلي وصف لبنية الإدخال للنوع تحديد واحد المزود بعلامة <objectselect>:

{
	"Dialog name" : {
		"Input name" : {
			"objectselect" : {
				"filter" : [{
						"value" : "filter value",
						"name"  : "filter name"
					}
				]
			}
		}
	}
}

Important

يتقاطع CLC مع عوامل تصفية (AND) المحددة في ملف SPD وملف الإدخال للإدخال تحديد واحد. يجب أن تكون معايير التصفية مختلفة في ملف إدخال SPD وأسماء عامل التصفية يجب أن تختلف في نفس تعريف عامل التصفية.

مثال

ملف تعريف SPD

<profile name="Install">
 <dialog step="Step1">
	<input name="APP_OBJ_SELECT_ONE" title="Application Name" hidden="false" type="selectOne" default="">
				<description>select application</description>
				<objectselect>
					<filter value="CfgApplication" name="type"/>
				</objectselect>
	</input>
 </dialog>
 <execution>
	<script>
		log('test select one' );
	</script>

 </execution>

ملف الإدخال لملف تعريف التثبيت

{
	"Step1" : {
		"APP_OBJ_SELECT_ONE" : {
			"objectselect" : {
				"filter" : [{
						"value" : "SIP_lrm26",
						"name"  : "name"
					}
				]
			}
		}
	}
}

النوع "تحديد متعدد"

فيما يلي وصف لبنية الإدخال للنوع تحديد متعدد المزود بعلامة <objectselect>:

{
	"Dialog name" : {
		"Input name" : {
			"objectselect" : {
				"filter" : [{
						"value" : "filter value",
						"name"  : "filter name"
					}
				]
			}
		}
	}
}

تنضم عوامل التصفية المحددة في ملف إدخال SPD في اتحاد (OR) ثم تتقاطع (AND) مع عوامل التصفية المحددة في ملف SPD لإدخال تحديد متعدد.

مثال

ملف تعريف SPD

<profile name="Install">
 <dialog step="Step1">
	<input name="APP_OBJ_SELECT_MULTIPLE" title="Application Name" hidden="false" type="selectMultiple" default="">
				<description>select application</description>
				<objectselect>
					<filter value="CfgApplication" name="type"/>
				</objectselect>
	</input>
 </dialog>
 <execution>
	<script>
		log('test select multiple' );
	</script>

 </execution>

ملف الإدخال لملف تعريف التثبيت

{
	"Step1" : {
		"APP_OBJ_SELECT_MULTIPLE" : {
			"objectselect" : {
				"filter" : [{
						"value" : "SIP_lrm26",
						"name"  : "name"
					},{
						"value" : "SIP_lrm27",
						"name"  : "name"
					}
				]
			}
		}
	}
}

تقوم العملية بإرجاع تطبيقين يطلق عليهما SIP_lrm26 وSIP_lrm27.

النوع SELECTONE

فيما يلي وصف لبنية الإدخال للنوع تحديد واحد/تحديد متعدد/منطقي المزود بعلامة <selection>:

{
	"Dialog name" : {
		"Input name" : {
			"selection" : {
				"option" : [{
						"value" : "option value assigned to the input parameter",
						"name"  : "option name is displayed in UI"
					}
				]
			}
		}
	}
}

يحدد CLC خيارات محددة في ملف إدخال SPD. يمكن تحديد خيارات متعددة فقط لنوع الإدخال تحديد متعدد.

مثال

ملف تعريف SPD

<profile name="Install">
 <dialog step="Application Parameters">
	<input name="DATA_MODEL" title="Binary Version (32-bit or 64-bit)" default="64" type="selectOne" required="true">
	    <description>This parameter defines the 32-bit or the 64-bit version of the binary to be deployed.  </description>
		<selection>
		    <option name="32" value="32"/>
		    <option name="64" value="64"/>
		</selection>
	</input>
 </dialog>
 <execution>
	<script>
		log('test selection support' );
	</script>

 </execution>

ملف الإدخال لملف تعريف التثبيت

{
	"Application Parameters" : {
		"DATA_MODEL" : {
			"selection" : {
				"option" : [{
						"value" : "64",
						"name"  : "64"
					     }
				]
			}
		}
	}
}

Important

• إذا لم يحدد ملف الإدخال قيمة لمعلمة SPD، فسوف يتم استخدام القيمة المحددة في السمة الافتراضية لعنصر الإدخال.
• في حالة تعيين السمة المطلوبة لعنصر الإدخال SPD على صواب، ولكن مع عدم وجود قيمة إدخال مقابلة تم تزويدها في كل من SPD (كافتراضي) أو في ملف الإدخال، فسيفشل حينئذٍ تنفيذ SPD.
• في حالة تعيين قيمة السمة للقراءة فقط لعنصر إدخال SPD على صواب، فسيتم حينئذٍ استخدام القيمة الموجودة في قيمة السمة الافتراضية للتنفيذ، إذا تم تحديدها. إذا تم تعيين قيمة السمة للقراءة فقط على صواب، فسيتم تعين مطلوب على خطأ، ولا يتم تحديد السمة الافتراضية، ومن ثم يتم استخدام المنطق التالي لتحديد قيمة الإدخال:
  1. بالنسبة لنوع الإدخال منطقي، يتم تعيين قيمة الإدخال على خطأ.
  2. بالنسبة لأنواع الإدخال سلسلة وكلمة المرور، يتم تعيين قيمة الإدخال على "".
  3. بالنسبة لنوع الإدخال عدد صحيح، لا يتم نشر الإدخال.
• في حالة تعيين مربع حوار قيمة سمة cond على "خطأ"، فستتخطى الأداة CLC مربع الحوار. مثال:

   <dialog step="Role input" cond="false">
    <input name="ROLE" title="Role" hidden="false" type="selectOne" required="true">
  	<description>Please indicate the role</description>
  		<objectselect>
  			<filter value="CfgRole" name="type"/>
  		</objectselect>
  	</input>
   </dialog>

  
  

مثال

java -jar gaxclc.jar -u:default -p:password -s -h:localhost:8080 spd execute 10054 -profileID:1 "C:/GAX/input.txt"

java -jar gaxclc.jar -u:default -p:password -h:localhost:8080 spd execute 10054 -profileName:"Install profile" "C:/GAX/input.txt"

java -jar gaxclc.jar -u:default -p:password -s -h:localhost:8080 spd execute 10054 1 -encrypted "C:/GAX/encryptedinput.txt"

حذف

نظرة عامة

تحذف هذه العملية معرف SPD. تفشل العملية في حالة عدم وجود SPD.

التنسيق

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd delete SPDID

• SPDID—معرف SPD المطلوب حذفه.

مثال

java -jar gaxclc.jar -u:default -p:password spd delete 5436

وظائف IP

يدعم CLC العمليات التالية لوظيفة ip:

• إضافة
• استعلام
• استعلام querybyid
• حذف

إضافة

نظرة عامة

تضيف هذه العملية IP (يتم تجميعه كملف ‎.zip) لقاعدة بيانات GAX. إذا كان IP موجود بالفعل، فسوف يتم استبداله.

في حال نجاحها، تقوم العملية بعرض معرف الـ IP.

Important

يجب أن يحتوي ملف ‎.zip على IP ومجلد قوالب لـ IP.

التنسيق

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> ip add "path to IP zip file"

مثال

java -jar gaxclc.jar -u:default -p:password ip add "C:\GAX\TESTS\zippedIpUpload\PRODUCTION\IP_TSrvSIP64_18100079b1_ENU_windows.zip"

استعلام

نظرة عامة

تستعلم هذه العملية عن جميع معلمات IP وتعرض جدولاً يدرج التفاصيل التالية لكل معلمة IP:

• رقم المعرف
• الاسم
• الإصدار
• نظام التشغيل
• الإعدادات المحلية
• الحالة

التنسيق

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> ip query

مثال

java -jar gaxclc.jar -u:default -p:password -s -h:132.45.43.45:443 ip query

استعلام querybyid

نظرة عامة

تستعلم هذه العملية عن جميع معلمات IP وتعرض جدولاً يدرج التفاصيل التالية:

• رقم المعرف
• الاسم
• الإصدار
• نظام التشغيل
• الإعدادات المحلية
• الحالة

التنسيق

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> ip query IPID

• IPID—معرف IP المطلوب الاستعلام عنه.

مثال

java -jar gaxclc.jar -u:default -p:password -h:132.45.43.45:8080 ip query 543

حذف

نظرة عامة

تحذف هذه العملية معرف IP.

التنسيق

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> ip delete IPID

• IPID—معرف IP المطلوب حذفه.

مثال

java -jar gaxclc.jar -u:default -p:password ip delete 547

category:Genesys Administrator Extension category:Genesys Administrator Extension Help