1.2. VDA Subcommands, Arguments, and Properties Deprecated in Oracle VDI Release 3.3

1.2.1. Password Properties
1.2.2. Pool Settings
1.2.3. User Directory Settings
1.2.4. Remote Access Subcommands
1.2.5. Forced Deletion of a User Directory

This section lists the VDA subcommands, arguments, and properties that are deprecated in Oracle VDI release 3.3.

The deprecated items still work as in the previous release of Oracle VDI. However, because these items might not be available in a future release of Oracle VDI, it is best to stop using them as soon as possible.

1.2.1. Password Properties

All properties that provide passwords for subcommands have been are deprecated. Passwords are now only provided when prompted.

Subcommand

Deprecated Password Property

pool-create-sysprep

domain-password and admin-password

pool-create-fastprep

domain-password and admin-password

provider-vc-create

password

provider-vc-setprops

password

provider-add-host

password

provider-host-setprops

password

provider-add-storage

password

provider-replace-storage

password

provider-storage-setprops

password

directory-add

password

directory-setprops

password

For the above commands, when specifying a username property, the command automatically prompts for the corresponding password.

For the provider-vc-setprops, provider-host-setprops, provider-storage-setprops, and directory-setprops subcommands, if you only want to update the password without changing the username, use the password-prompt property.

1.2.2. Pool Settings

The pool Sun Ray setting hotdesking is replaced by hotdesking-action.

# sbin/vda pool-setprops --help
Edit the properties of the pool

Usage:
 vda pool-setprops [-p <prop1>=<value1>,<prop2>=<value2> |
                   --properties=<prop1>=<value1>,<prop2>=<value2>] [-u <userdir>
                   | --userdir=<userdir>] <name>
 -?, --help                Print this help list
Options:
*-p <prop1>=<value1>,<prop2>=<value2>, --properties=<prop1>=<value1>,<prop2>=<value2> 
                           The list of properties to set
 -u <userdir>, --userdir=<userdir> 
                           The name of the user directory for the pool
Properties:
[...]
 hotdesking=<hotdesking>   DEPRECATED: use the hotdesking-action property
                           instead.
                           Enable or disable optimized hotdesking behaviour for
                           Sun Ray client sessions. Valid values are 'enabled'
                           and 'disabled'
 hotdesking-action=<hotdesking-action> 
                           The Sun Ray Connector reconnection behavior on
                           hotdesking of Sun Ray client sessions. Valid values
                           are 'nodisconnect', 'reconnect' and 'autoreconnect'
[...]

1.2.3. User Directory Settings

User directory settings have moved from Global Settings (settings-getprops, settings-setprops, settings-resetprops subcommands) to User Directory Settings (directory-getprops, directory-setprops, directory-resetprops subcommands).

Oracle VDI 3.2.x Property Name in Settings Subcommands

Oracle VDI 3.3 Property Name in Directory Subcommands

Help Text

directory.white.list

whitelist

List of comma-separated Active Directory global catalog servers that are always used for LDAP queries. The order of the servers in the whitelist is important. If Oracle VDI cannot contact the first server in the list, it tries the next one

directory.black.list

blacklist

List of comma-separated Active Directory servers that are never used for LDAP queries (this overrides any whitelist settings)

directory.mail.domain

user.auth.mail.domain

Email domain for users of the user directory. For example, example.com. Allows users to log in with their e-mail address

directory.default.domain

user.auth.default.domain

The default authentication domain if authenticating users using email addresses

ldap.user.object.filter

ldap.user.object.filter

LDAP filter used to identify objects of type user

ldap.user.search.filter

ldap.user.search.filter

LDAP filter used to search for users according a search criteria. Searches for users can be done using the user-search command or in the web administration console. $SEARCH_STRING is the placeholder for the search criteria

ldap.user.member.attributes

ldap.user.member.attributes

List of comma-separated LDAP attributes on a user object storing the groups the user is a member of

ldap.userid.attributes

ldap.userid.attributes

List of comma-separated LDAP attributes storing the userid value for user objects. This is used to find a user given its userid

ldap.group.object.filter

ldap.group.object.filter

LDAP filter used to identify objects of type group

ldap.group.search.filter

ldap.group.search.filter

LDAP filter used to search for groups according a search criteria. Searches for groups can be done using the user-search command or in the web administration console. $SEARCH_STRING is the placeholder for the search criteria

ldap.group.member.attributes

ldap.group.member.attributes

List of comma-separated LDAP attributes on a group object storing the users member of the group

ldap.group.short.attributes

ldap.group.short.attributes

List of comma-separated LDAP attributes on a group object storing the information for short membership

ldap.container.object.filter

ldap.container.object.filter

LDAP filter used to identify objects of type container. Containers can be selected as root for custom group filters in the web administration console

ldap.container.search.filter

ldap.container.search.filter

LDAP filter used by the web administration console to search for containers according a search criteria, when selecting a root for a custom group filter. $SEARCH_STRING is the placeholder for the search criteria

ldap.default.attributes

ldap.default.attributes

List of LDAP separated attributes loaded in the cache when looking up an object

ldap.search.wildcard

ldap.search.wildcard

Determines whether wildcards are used to extend the user or group searches. Valid values are enabled and disabled.

ldap.vdicenter.displayname. attributes

ldap.vdicenter.displayname. attributes

List of comma-separated LDAP attributes on an Oracle VDI Center object containing its display name

ldap.vdihost.object.filter

ldap.vdihost.object.filter

LDAP filter used to match Oracle VDI host objects inside the Oracle VDI Center

ldap.vdihost.dnsname. attributes

ldap.vdihost.dnsname. attributes

List of comma-separated LDAP attributes on an Oracle VDI host object containing its DNS name or IP address

ldap.user.vdicenter. attributes

ldap.user.vdicenter. attributes

List of comma-separated LDAP attributes on a User object containing its Oracle VDI Center DN

1.2.4. Remote Access Subcommands

The remote-access-setprops and remote-access-getprops subcommands are deprecated.

Remote Subcommands:
   remote-access-setprops:    DEPRECATED: Remote access is now possible using
                              the Webservice API.
                              Enable and disable remote access and specify the
                              listening port
   remote-access-getprops:    DEPRECATED: Remote access is now possible using
                              the Webservice API.
                              Displays remote access properties which include
                              enabled state and port

1.2.5. Forced Deletion of a User Directory

The --force option on the directory-remove subcommand no longer has any effect because pools must be deleted before a directory can be removed.

# sbin/vda directory-remove --help
Remove the user directory configuration from the system

Usage:
 vda directory-remove [-f | --force] [<userdir>]
 -?, --help                Print this help list
Options:
 -f, --force               DEPRECATED: pre-conditions to remove a user directory
                           have changed. It is not possible to remove user
                           directories which have pools.
                           Force removal of the user directory configuration
                           when the user directory is in use, because some users
                           are assigned to desktops or associated to tokens
Operand:
 <userdir>                 The name of the user directory
'*' denotes mandatory parameters.