Dell EMC OpenManage Command Line Interface Guide Version 9.1

Omconfig preferences webserver

Use the omconfig preferences webserver command to set the encryption levels of the Server Administrator web server, configure the URL launch point in the Server Administrator web server environment, and to set the JRE version for the Server Administrator.

The following table displays the name=value pairs you can use with this command:

Table 1. Valid Parameters Of Omconfig Preferences Webserver . This table lists the Valid Parameters Of Omconfig Preferences Webserver
name=value pair 1	name=value pair 2	Description
attribute=sslencryption	setting=autonegotiate \| 128bitorhigher	autonegotiate: Sets the encryption levels automatically based on your web browser settings. 128bitorhigher: Sets the encryption levels to 128-bit or higher. NOTE: This attribute is deprecated in the future releases, use `ciphers` instead.
attribute=seturl	host=< string> port=< value>	Enables you to configure the Distributed Web Server (DWS) URL launch point, for accessing the management node. This command is used when Server Administrator Instrumentation Service and Remote Enablement are installed on the same system and the Server Administrator GUI is accessed using the DWS URL. NOTE: This command is not supported if the web server is present on the same system.
attribute=signalgorithm	setting=MD5 \| SHA1 \| SHA256 \| SHA512	MD5: Sets the key signing algorithm to MD5. SHA1: Sets the key signing algorithm to SHA1. SHA256: Sets the key signing algorithm to SHA256. SHA512: Sets the key signing algorithm to SHA512.
attribute=setjre	jreversion=bundled \| value	bundled: Sets the version bundled with Server Administrator. This is the default value. value: Sets the provided version, which is available on the system. To obtain the available versions on the system, type `omreport preferences webserver attribute=getjrelist`. For more details, see omreport preferences webserver .
attribute=exportcsr	N/A	Exports a Certificate Signing Request (CSR) file. The exported .csr file is saved at <Server Administrator installation directory>\apache-tomcat\temp .
attribute=gennewcert	cn=< common name> org=< organization name > ou=< organization unit name> location=< location name > state=< state name> country=< country name> validity=< validity> keysize=<512 \| 1024 \| 2048> algorithm=<MD5 \| SHA1 \| SHA256 \| SHA512> webserverrestart=<true \| false>	Creates a new self-signed certificate for the SSL communication between the server running Server Administrator and the web server. NOTE: The country name ( `country name`) must be of two characters, and validity ( `validity`) must be in days. For country names, see the table, Country names and codes, provided later in this section. The `validity`, `keysize`, and `algorithm` parameters are optional. If you do not set any value for the optional parameters, Server Administrator assigns default values to the optional parameters. The default values of `validity`, `keysize`, and `algorithm` are `1095`, `2048`, and `SHA512` respectively. Restarting Server Administrator web server is optional, but the generated certificate comes to effect only after restarting the web server.
attribute=uploadcert	certfile=< path of the certificate file> type=<pkcs12> password=< password of the certificate file> webserverrestart=true \| false	Allows you to import a PKCS#12 keystore that replaces the private key and certificate used in Server Administrator web server. PKCS#12 is public keystore that contains a private key and the certificate for a web server. Server Administrator uses the Java KeyStore (JKS) format to store the SSL certificates and its private key. Importing a PKCS#12 keystore to Server Administrator deletes the keystore entries, and imports a private key and certificate entries to the Server Administrator JKS. NOTE: If you are importing a PKCS#12 keystore, specify the type and password of the certificate. Restarting Server Administrator web server is optional, but the uploaded certificate comes to effect only after restarting the web server. NOTE: An error message is displayed if you either type an invalid PKCS file name or an incorrect password.
attribute=<ciphers>	setting=<valid ciphers text value>	Allows you to choose the ciphers that support the web server while configuring. SSL provides a secure connection between the web server and the browser. The connection service does not start if an invalid cipher suite is set. NOTE: If an incorrect cipher value is set and the connection service fails to start, use the CLI command prompt or manually set the valid ciphers and restart the connection service.
attribute=<sslprotocol>	setting=<valid sslprotocol values are TLSv1.1\| TLSv1.2\| TLSv1.1, TLSv1.2\|	Allows you to set the web server SSL protocols configuration from the valid values. The changes to take effect after web server restart.
attribute=<port>	setting=<valid port value>	Sets the number of secure ports that you want Server Administrator to use. The port value range from 1024 to 65535. The default port for Server Administrator is 1311.
attribute=<ipaddress>	setting=<valid Binding IPAddress value>	Sets by default the web server to incoming browser requests on ALL IP addresses. However, for increased security you can specify a single IP address or, ALL IP addresses. An error message is displayed on an invalid entry of the configurable Bind List of IP Address. For the changes to take effect, restart the web server.
attribute=<sessiontimeout>	setting=<valid Session Timeout value between 1– 30>	Allows Server Administrator to time-out if there is no user input for a specified number of minutes. Users whose sessions time-out must log in again to continue.

An example command to set the URL launch point is as follows:

omconfig preferences webserver attribute=seturl host=<name, ip, fqdn> port=<
                                    number>

The host input must contain a valid IPv4 or IPv6 address, or a valid host name.

An example command to set the signing algorithm value is as follows:

omconfig preferences webserver attribute=signalgorithm setting=MD5

An example command to set the JRE versions is as follows:

omconfig preferences webserver attribute=setjre jreversion=<bundled | value>

An example command to export a Certificate Signing Request (CSR) is as follows:

omconfig preferences webserver attribute=exportcsr

The command creates a file of the format xxxx.csr in the < Server Administrator installation directory>\apache-tomcat\temp folder.

An example command to create a web server certificate is as follows:

omconfig preferences webserver attribute=gennewcert cn=HostName org=dell ou=ESG location=RoundRock state=TX country=US validity=300
                                    keysize=2048 algorithm=SHA512 webserverrestart=true

An example command to upload a certificate on the Server Administrator web server is as follows:

omconfig preferences webserver attribute=uploadcert certfile=C:/xyz.crt webserverrestart=true

An example command to upload a certificate with a PKCS#12 keystore on the Server Administrator web server is as follows:

omconfig preferences webserver attribute=uploadcert certfile=C:/xyz.pfx type=pkcs12 password=abc webserverrestart=true

Table 2. Country names and codes . This table lists the Country names and codes
Country Names	Codes
AFGHANISTAN	AF
ALBANIA	AL
ALGERIA	DZ
AMERICAN SAMOA	AS
ANDORRA	AD
ANGOLA	AO
ANGUILLA	AI
ANTARCTICA	AQ
ANTIGUA AND BARBUDA	AG
ARGENTINA	AR
ARMENIA	AM
ARUBA	AW
AUSTRALIA	AU
AUSTRIA	AT
AZERBAIJAN	AZ
BAHAMAS	BS
BAHRAIN	BH
BANGLADESH	BD
BARBADOS	BB
BELARUS	BY
BELGIUM	BE
BELIZE	BZ
BENIN	BJ
BERMUDA	BM
BHUTAN	BT
BOLIVIA	BO
BOSNIA AND HERZEGOWINA	BA
BOTSWANA	BW
BOUVET ISLAND	BV
BRAZIL	BR
BRITISH INDIAN OCEAN TERRITORY	IO
BRUNEI DARUSSALAM	BN
BULGARIA	BG
BURKINA FASO	BF
BURUNDI	BI
CAMBODIA	KH
CAMEROON	CM
CANADA	CA
CAPE VERDE	CV
CAYMAN ISLANDS	KY
CENTRAL AFRICAN REPUBLIC	CF
CHAD	TD
CHILE	CL
CHINA	CN
CHRISTMAS ISLAND	CX
COCOS (KEELING) ISLANDS	CC
COLOMBIA	CO
COMOROS	KM
CONGO	CG
CONGO, THE DEMOCRATIC REPUBLIC OF THE	CD
COOK ISLANDS	CK
COSTA RICA	CR
COTE D'IVOIRE	CI
CROATIA (local name: Hrvatska)	HR
CYPRUS	CY
CZECH REPUBLIC	CZ
DENMARK	DK
DJIBOUTI	DJ
DOMINICA	DM
DOMINICAN REPUBLIC	DO
EAST TIMOR	TP
ECUADOR	EC
EGYPT	EG
EL SALVADOR	SV
EQUATORIAL GUINEA	GQ
ERITREA	ER
ESTONIA	EE
ETHIOPIA	ET
FALKLAND ISLANDS (MALVINAS)	FK
FAROE ISLANDS	FO
FIJI	FJ
FINLAND	FI
FRANCE	FR
FRANCE, METROPOLITAN	FX
FRENCH GUIANA	GF
FRENCH POLYNESIA	PF
FRENCH SOUTHERN TERRITORIES	TF
GABON	GA
GAMBIA	GM
GEORGIA	GE
GERMANY	DE
GHANA	GH
GIBRALTAR	GI
GREECE	GR
GREENLAND	GL
GRENADA	GD
GUADELOUPE	GP
GUAM	GU
GUATEMALA	GT
GUINEA	GN
GUINEA-BISSAU	GW
GUYANA	GY
HAITI	HT
HEARD AND MC DONALD ISLANDS	HM
HOLY SEE (VATICAN CITY STATE)	VA
HONDURAS	HN
HONG KONG	HK
HUNGARY	HU
ICELAND	IS
INDIA	IN
INDONESIA	ID
IRAQ	IQ
IRELAND	IE
ISRAEL	IL
ITALY	IT
JAMAICA	JM
JAPAN	JP
JORDAN	JO
KAZAKHSTAN	KZ
KENYA	KE
KIRIBATI	KI
KOREA, REPUBLIC OF	KR
KUWAIT	KW
KYRGYZSTAN	KG
LAO PEOPLE'S DEMOCRATIC REPUBLIC	LA
LATVIA	LV
LEBANON	LB
LESOTHO	LS
LIBERIA	LR
LIBYAN ARAB JAMAHIRIYA	LY
LIECHTENSTEIN	LI
LITHUANIA	LT
LUXEMBOURG	LU
MACAU	MO
MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF	MK
MADAGASCAR	MG
MALAWI	MW
MALDIVES	MV
MALTA	MT
MARSHALL ISLANDS	MH
MARTINIQUE	MQ
MAURITANIA	MR
MAURITIUS	MY
MAYOTTE	YT
MEXICO	MX
MICRONESIA, FEDERATED STATES OF	FM
MOLDOVA, REPUBLIC OF	MD
MONACO	MC
MONGOLIA	MN
MONTSERRAT	MS
MOROCCO	MA
MOZAMBIQUE	MZ
MYANMAR	MM
NAMIBIA	NA
NAURU	NR
NEPAL	NP
NETHERLANDS	ML
NETHERLANDS ANTILLES	AN
NEW CALEDONIA	NC
NEW ZEALAND	NZ
NICARAGUA	NI
NIGER	NE
NIGERIA	NG
NIUE	NU
NORFOLK ISLAND	NF
NORTHERN MARIANA ISLANDS	MP
NORWAY	NO
OMAN	OM
PAKISTAN	PK
PALAU	PW
PALESTINIAN TERRITORY, OCCUPIED	PS
PANAMA	PA
PAPUA NEW GUINEA	PG
PARAGUAY	PY
PERU	PE
PHILIPPINES	PH
PITCAIRN	PN
POLAND	PL
PORTUGAL	PT
PUERTO RICO	PR
QATAR	QA
REUNION	RE
ROMANIA	RO
RUSSIAN FEDERATION	RU
RWANDA	RW
SAINT KITTS AND NEVIS	KN
SAINT LUCIA	LC
SAINT VINCENT AND THE GRENADINES	VC
SAMOA	WS
SAN MARINO	SM
SAO TOME AND PRINCIPE	ST
SAUDI ARABIA	SA
SENEGAL	SN
SEYCHELLES	SC
SIERRA LEONE	SL
SINGAPORE	SG
SLOVAKIA (Slovak Republic)	SK
SLOVENIA	SI
SOLOMON ISLANDS	SB
SOMALIA	SO
SOUTH AFRICA	ZA
SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS	GS
SPAIN	ES
SRI LANKA	LK
ST. HELENA	SH
ST. PIERRE AND MIQUELON	PM
SURINAME	SR
SVALBARD AND JAN MAYEN ISLANDS	SJ
SWAZILAND	SZ
SWEDEN	SE
SWITZERLAND	CH
TAIWAN	TW
TAJIKISTAN	TJ
TANZANIA, UNITED REPUBLIC OF	TZ
THAILAND	TH
TOGO	TG
TOKELAU	TK
TONGA	TO
TRINIDAD AND TOBAGO	TT
TUNISIA	TN
TURKEY	TR
TURKMENISTAN	TM
TURKS AND CAICOS ISLANDS	TC
TUVALU	TV
UGANDA	UG
UKRAINE	UA
UNITED ARAB EMIRATES	AE
UNITED KINGDOM	GB
UNITED STATES	US
UNITED STATES MINOR OUTLYING ISLANDS	UM
URUGUAY	UY
UZBEKISTAN	UZ
VANUATU	VU
VENEZUELA	VE
VIETNAM	VN
VIRGIN ISLANDS (BRITISH)	VG
VIRGIN ISLANDS (U.S.)	VI
WALLIS AND FUTUNA ISLANDS	WF
WESTERN SAHARA	EH
YEMEN	YE
YUGOSLAVIA	YU
ZAMBIA	ZM
ZIMBABWE	ZW

Welcome

Welcome to Dell

Dell EMC OpenManage Command Line Interface Guide Version 9.1

Omconfig preferences webserver

Rate this content