D.42. tarantella object new_host

Creates one or more application server or dynamic application server objects. See Section C.1.3, “Application Server Object” and Section C.1.13, “Dynamic Application Server Object”.

Syntax

For an application server object, use the following syntax:

tarantella object new_host {
                             --name obj
                           [ --address address ]
                           [ --description text ]
                           [ --ntdomain dom ]
                           [ --available true|false ]
                           [ --auth trytta|nevertrytta|default ]
                           [ --location location ]
                           [ --hostlocale ll_tt ]
                           [ --maxcount count ]
                           [ --userassign spec ]
                           } | --file file

For a dynamic application server object, use the following syntax:

tarantella object new_host {
                             --name obj
                             --dynamic 
                           [ --description text ]
                           [ --auth trytta|nevertrytta|default ]
                           [ --vsbclass classname ]
                           [ --vsbparams params ]
                           } | --file file

Description

The following table shows the available options for this command.

Option

Description

More Information

--name

The names of objects you want to add assigned applications links for.

Section C.2.84, “Name”

--address

Network address of the application server.

Section C.2.1, “Address”

--dynamic

Create a dynamic application server.

Section C.1.13, “Dynamic Application Server Object”

--description

A text description of the object.

Section C.2.29, “Comment”

--ntdomain

The Windows domain used for application server authentication.

Section C.2.44, “Domain Name”

--available

Specifies whether applications can run on this application server.

Section C.2.9, “Application Start”

--auth

Specifies the policy for authenticating users on the application server, if no password is already cached for that server.

Section C.2.88, “Password Cache Usage”

--location

String describing the location of the application server. Used for load balancing.

Section C.2.69, “Load Balancing Groups”

--hostlocale

Default language setting for the application server.

Section C.2.91, “Prompt Locale”

--vsbclass

Fully-qualified class name for the virtual server broker (VSB).

Dynamic application servers only.

Section C.2.111, “Virtual Server Broker Class”

--vsbparams

Parameters passed to the VSB.

Dynamic application servers only.

Section C.2.112, “Virtual Server Broker Parameters”

--maxcount

Maximum number of application sessions that can be run concurrently on the application server

Section C.2.77, “Maximum Count”

--userassign

Specifies the users that can run applications on the application server

Section C.2.109, “User Assignment”

--file

A file containing a batch of commands to add assigned applications links.

 
Note

Make sure you quote any object names containing spaces, for example, "o=Example".

Examples

The following example creates a new application server object with common name paris, belonging to the organizational unit object Finance, which must already exist.

$ tarantella object new_host \
--name "o=appservers/ou=Finance/cn=paris" \
--address paris.example.com \
--auth default \
--location Europe-north

The following example creates a new dynamic application server object MyBroker that uses the User-defined SGD broker.

$ tarantella object new_host --dynamic \
--name "o=appservers/cn=MyBroker" \
--vsbclass com.sun.sgd.vsbim.UserDefinedSGDBroker

The following example creates a new dynamic application server object MyVDIBroker that uses the VDI broker. A list of preferredhosts is configured for the broker.

$ tarantella object new_host --dynamic \
--name "o=appservers/cn=MyVDIBroker" \
--vsbclass com.oracle.sgd.vsbim.OracleVDIVirtualServerBroker \
--vsbparams "preferredhosts=\"https://vdihost1.com:1802/client,https://vdihost2.com:1802/client,
  https://vdihost3.com:1802/client\""

The following example creates three application server objects using a batch script defined as a “here-document”. Alternatively, you can store the batch script in a file, and reference it using --file filename.

$ tarantella object new_host --file - <<EOF
--name "o=appservers/ou=Finance/cn=paris"
--address paris.example.com
--name "o=appservers/cn=brussels"
--address brussels.example.com
--name "o=appservers/ou=IT/cn=london"
--address london.example.com
EOF