5.8. Assigning Users to Desktops

5.8.1. How to Assign Users to Pools or Desktops
5.8.2. How to Create Custom Groups and Custom Group Filters
5.8.3. How to Assign Tokens to Users
5.8.4. How to Assign Tokens to Desktops or Pools
5.8.5. How to Create Bulks of Tokens
5.8.6. How to Search for Desktops
5.8.7. Obtaining the ID of a Desktop or Template

5.8.1. How to Assign Users to Pools or Desktops

You can either assign a user to a specific desktop, or you can assign a user (or user group) to a desktop pool. If a user is assigned to a pool and requests a desktop, Oracle VDI will automatically deliver any available desktop from the pool.

For Microsoft Remote Desktop providers, users cannot be directly assigned to desktops. Instead, users or groups are assigned to Remote Desktop Services pools.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, go to Users.

  2. Select a company.

  3. To assign a user or a group, go to the Users and Groups tab.

    1. Search for users and groups in the user directory.

      You can specify user name or user ID.

    2. Click on the user name, and click the Assignment tab in their profile.

    3. Select Add in the Assigned Desktops or Assigned Pools table, depending on your preference.

  4. To assign a custom group, go to the Custom Groups tab.

    1. Click the Assignment tab in the custom group's profile.

    2. In the Assigned Pools table, select Add.

  5. Select the checkbox for the desktop or pool assignment, and click OK.

You can always see which pools and desktops are associated with a user by clicking the Summary tab of the user or group's profile.

CLI Steps

  • Assign a user to a desktop.

    1. List the available desktops.

      # /opt/SUNWvda/sbin/vda pool-desktops pool name
      
    2. Assign a user to a desktop.

      # /opt/SUNWvda/sbin/vda user-assign --desktop=desktop IDuser name
      

      Example - Assigning a user to a desktop.

      # /opt/SUNWvda/sbin/vda pool-desktops "Sales - EMEA"
      NAME ID MACHINE_STATE STATUS DN
      Solaris 2008.11 De 2
      2 Powered Off Available -
      # /opt/SUNWvda/sbin/vda user-assign --desktop=2 jd123456
      User/Group jd123456 assigned to desktop 2
    3. List the users of the pool.

      # /opt/SUNWvda/sbin/vda pool-users -u pool name
      
  • Assign a custom group to a pool.

    # /opt/SUNWvda/sbin/vda group-assign -p pool namecustom group name
    

    Example - Assigning a custom group to a pool

    # /opt/SUNWvda/sbin/vda group-assign -p "Solaris 2008.11 En" "Support EMEA"
    Custom Groups [Support EMEA] assigned to pool Solaris 2008.11 En

5.8.2. How to Create Custom Groups and Custom Group Filters

Oracle VDI user directory integration not only recognizes existing groups, but also allows you to make custom groups, and assign them to a pool. If you want to define a set of users that is not an existing group in the user directory, you can create a custom group, and specify the filter to search in the user directory. This functionality allows you to define Oracle VDI user groups locally without the need for any changes in your Active Directory or LDAP user directory.

Oracle VDI Manager Steps

To create a custom group:

  1. Select the Users category, and the Custom Groups subcategory in the left sidebar.

  2. Select New in the Custom Groups overview.

  3. Give the Custom Group a descriptive name, and click OK.

To define a custom group filter:

  1. Click the Filter tab, and choose a Filter Mode:

    The default filter mode is Composition. You can create a custom filter by choosing an Attribute, Relationship, and Value.

    You can also use the Advanced filter mode, which uses LDAP search syntax defined by RFC 2254 LDAP documentation.

    For more information, see RFC 2254.

  2. Before saving, click Preview to see how the filter configuration will behave. If the filter defines the target group of users, click Save.

5.8.3. How to Assign Tokens to Users

In a Sun Ray environment, users may take advantage of smart cards (tokens) to initiate a session on a Sun Ray Client. With Oracle VDI, you can assign a token to a user. It is also possible to assign desktops directly to specific tokens. Once tokens have been created, they can be assigned to pools and desktops.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, go to Users.

  2. Select a company.

  3. Go to the Users and Groups tab.

  4. Search for a user in the user directory.

  5. Click on the user name, and go the Token tab.

  6. Assign the token.

    • If you are assigning a new token, click New in the Tokens table. Then Enter the ID of the new token (e.g. Payflex.500d9b8900130200).

    • If you are assigning an existing token, select Add in the Tokens table. Then search for the desired token.

Note

Token IDs can be copied directly from the Sun Ray Admin GUI (see the Tokens tab and display Currently Used Tokens).

CLI Steps

  • Assign a new token to a user.

    # /opt/SUNWvda/sbin/vda token-create -p token-id=token ID,user=user ID
    

    Example - Creating a new token and assigning it to a user

    # /opt/SUNWvda/sbin/vda token-create -p token-id=Payflex.600a7c5600130200,user=jd123456
    Token Payflex.600a7c5600130200 created
  • Assign an existing token to a user.

    # /opt/SUNWvda/sbin/vda token-create -p token-id=token ID,user=user ID
    

    Example - Assigning an existing token to a user

    # /opt/SUNWvda/sbin/vda token-setprops -p user=jd123456 Payflex.600a7c5600130200
    Token properties updated

5.8.4. How to Assign Tokens to Desktops or Pools

You can assign tokens to desktops or desktop pools. This is similar to assigning desktops to users, however, a single user can potentially own multiple tokens (smart cards). By assigning tokens to desktops, users are able to easily switch between the assigned desktops by just inserting different smart cards into the Thin Client.

Assigning desktops or pools to each token individually can be cumbersome. To ease this process, Oracle VDI provides some predefined special tokens ("AnySmartCard.000" and "AnySunRayClient.000"), which can be used to make default pool assignments in a single company setup.

For example, if you assign a pool to the AnySmartCard.000 token, any user taking advantage of a smart card (regardless of the smart card ID) will get a desktop from this pool. Or, if you assign a pool to the AnySunRayClient.000 token, any user using a Sun Ray Client (Sun Ray hardware and Oracle Virtual Desktop Client) without a smart card will get a desktop from this pool.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, go to Users.

  2. Select a company.

  3. Go to the Tokens tab.

  4. Select a token from the Tokens table.

  5. Assign the token.

    • If you are assigning a token to a desktop, click Add on the Assigned Desktops table. Then enter the ID of the token (e.g. Payflex.500d9b8900130200).

    • If you are assigning a token to a pool, click Add on the Assigned Pool table. Then enter the ID of the token (e.g. Payflex.500d9b8900130200).

Note

Token IDs can be copied directly from the Sun Ray Admin GUI (see the Tokens tab and display Currently Used Tokens).

CLI Steps

  • Assign a token to a desktop.

    1. List available desktops.

      # /opt/SUNWvda/sbin/vda pool-desktops pool name
      
    2. Assign the token to one of the listed desktops.

      # /opt/SUNWvda/sbin/vda token-assign --desktop=desktop IDtoken ID
      

      Example - Assigning an existing token to a desktop

      # /opt/SUNWvda/sbin/vda pool-desktops "Sales - EMEA"
      NAME                      ID MACHINE_STATE       STATUS         USER          DN
      Ubuntu_02                  4   Powered Off    Available            -           -
      Ubuntu_01                  6   Powered Off    Available            -           -
      Ubuntu_05                  8   Powered Off    Available            -           -
      
      # /opt/SUNWvda/sbin/vda token-assign --desktop=4 Payflex.500d9b8900130200
      Token Payflex.500d9b8900130200 assigned to desktop 4
  • Assign a token to a pool.

    # /opt/SUNWvda/sbin/vda token-assign --pool=pool nametoken ID
    

    Example - Assigning an existing token to a pool

    # /opt/SUNWvda/sbin/vda token-assign --pool="Sales - EMEA" Payflex.500d9b8900130200

    Example - Assigning all smart cards to a pool

    # /opt/SUNWvda/sbin/vda token-assign --pool="Sales - EMEA" AnySmartCard.000

5.8.5. How to Create Bulks of Tokens

It is possible to create a number of tokens at once using the token-create subcommand.

The token-create subcommand can take an input file containing the tokens to create and the user associated with the token if needed.

Usage

Options:
-f token-file, --file=token-file
A CSV file containing the properties of the tokens to
be created. Format of the file is: token-idcommentuserid
-w, --write Overwrite existing tokens, option to be used with the
token-file option

The format of the token file is CSV with the following values:

  • token-id: the id of the smart card, this value is mandatory.

  • comment: a comment about the token that can be used as a user friendly description of the token. This value maybe empty.

  • userid: the user id of a user from the user directory, to be associated with the token. This value maybe empty.

Example

The following example shows a valid csv file for token creation and uses the file to create the tokens and their association to users.

example% cat /tokens.csv
mo12.345,"token for Mary O'Leary",moleary
js46.23,"token for user John Smith",jsmith
x34.45,"token without any associated user",
example% /opt/SUNWvda/sbin/vda token-create -f /tokens.csv
example% /opt/SUNWvda/sbin/vda token-search
NAME USER DN
mo12.345 Mary O'Leary cn=Mary O'Leary,ou=people
js46.23 John Smith cn=John Smith,ou=people
x34.45 - -

5.8.6. How to Search for Desktops

This task describes how to search for any desktop managed by Oracle VDI Manager. The Desktop Search feature enables you to search for any desktop in any pool based on a set of predefined filters, or by using the search field.

Oracle VDI Manager Steps

  1. In Oracle VDI Manager, go to Pools.

  2. Select Desktop Search.

  3. Click a predefined filter link to display the list of desktops:

    • All desktops - The complete set of desktops from all existing pools.

    • Assigned desktops - All the desktops currently assigned to a user.

    • Running desktops - All the desktops currently up and running.

    • Desktops with error - All the desktops currently with errors, which can be due to a Defective State, or when the Machine State is Stuck, Aborted, Unresponsive or Unknown.

  4. (Optional) Search the list of desktops by assigned user.

    Type a user name into the Desktop Search field and click Search to show only the currently listed desktops with the matching assigned user.

5.8.7. Obtaining the ID of a Desktop or Template

When you use the vda command to perform an action on a desktop or template, you must use the unique ID of the desktop or template rather than the name. Oracle VDI Manager only displays the name.

To obtain the ID of a desktop, use the vda pool-desktops command.

To obtain the ID of a template, use the vda pool-templates command.

In the following example, information about the desktops in the pool winxp-pool is displayed:

$ /opt/SUNWvda/sbin/vda pool-desktops winxp-pool
NAME                      ID MACHINE_STATE       STATUS         USER          DN
winxp-001                 33   Powered Off         Idle      aberginuid=bergin,ou=People
                                                                                
winxp-002                 34   Powered Off    Available            -           -

There are two desktops in the pool with IDs of 33 and 34.