Dell EMC OpenManage Command Line Interface Guide Version 9.1

PDF

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


Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\