D.45 tarantella object new_host

Creates one or more of the following objects:

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

For an Oracle VM hypervisor host object, use the following syntax:

tarantella object new_host {
                             --name obj
                             --address address
                             --ovm
                           [ --description text ]
                           [ --available true|false ]
                           [ --auth trytta|nevertrytta|default ]
                           [ --vmsubnet network-address/mask ]
                           [ --ovmtags tag... ]
                           [ --ovmpools pool... ]
                           [ --ovmservers server-name... ]
                           [ --vmnames vm-name... ]
                           [ --vmostypes os-type... ]
                           [ --maxcount count ]
                           [ --userassign spec ]
                           } | --file file

For a VirtualBox hypervisor host object, use the following syntax:

tarantella object new_host {
                             --name obj
                             --address address
                             --vbox
                           [ --description text ]
                           [ --available true|false ]
                           [ --auth trytta|nevertrytta|default ]
                           [ --vmsubnet network-address/mask ]
                           [ --vboxgroups group... ]
                           [ --vmnames vm-name... ]
                           [ --vmostypes os-type... ]
                           [ --maxcount count ]
                           [ --userassign spec ]
                           } | --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.87, “Name”

--address

Network address of the application server.

For hypervisor hosts, enter the web services URL.

Section C.2.1, “Address”

--dynamic

Create a dynamic application server.

Section C.1.11, “Dynamic Application Server Object”

--ovm

Create an Oracle VM hypervisor host.

Section C.1.13, “Oracle VM Hypervisor Object”

--vbox

Create a VirtualBox hypervisor host.

Section C.1.15, “VirtualBox Hypervisor 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.45, “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.91, “Password Cache Usage”

--location

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

Section C.2.71, “Load Balancing Groups”

--hostlocale

Default language setting for the application server.

Section C.2.97, “Prompt Locale”

--vsbclass

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

Dynamic application servers only.

Section C.2.119, “Virtual Server Broker Class”

--vsbparams

Parameters passed to the VSB.

Dynamic application servers only.

Section C.2.120, “Virtual Server Broker Parameters”

--vmsubnet

Connect only to VMs which use an IP address on the specified subnet.

Oracle VM hypervisor hosts and VirtualBox hypervisor hosts only.

Section C.2.31, “Connection Address”

--ovmtags

Tags used for VM selection criteria.

Oracle VM hypervisor hosts only.

Section C.2.118, “Virtual Machine Selection Criteria”

--ovmpools

Server pool names used for VM selection criteria.

Oracle VM hypervisor hosts only.

Section C.2.118, “Virtual Machine Selection Criteria”

--ovmservers

Oracle VM Server names used for VM selection criteria.

Oracle VM hypervisor hosts only.

Section C.2.118, “Virtual Machine Selection Criteria”

--vmnames

VM names used for VM selection criteria.

Oracle VM hypervisor hosts and VirtualBox hypervisor hosts only.

Section C.2.118, “Virtual Machine Selection Criteria”

--vmostypes

Operating system (OS) types used for VM selection criteria.

Oracle VM hypervisor hosts and VirtualBox hypervisor hosts only.

Section C.2.118, “Virtual Machine Selection Criteria”

--vboxgroups

Oracle VM VirtualBox groups used for VM selection criteria.

VirtualBox hypervisor hosts only.

Section C.2.118, “Virtual Machine Selection Criteria”

--maxcount

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

Section C.2.80, “Maximum Count”

--userassign

Specifies the users that can run applications on the application server

Section C.2.116, “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 Organization".

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 a new Oracle VM hypervisor object ovm1 that connects to the Oracle VM Manager host ovm-mgr.example.com on TCP port 7002. Only VMs which have a tag of marketing or sales are used by SGD.

$ tarantella object new_host --ovm \
--name "o=appservers/cn=ovm1" \
--address "https://ovm-mgr.example.com:7002/ovm/core/wsapi/rest" \
--ovmtags "marketing,sales" 

The following example creates a new Oracle VM hypervisor object ovm1 that connects to the Oracle VM Manager host ovm-mgr.example.com on TCP port 7002. Only VMs which have an IP address on the specified subnet are used by SGD.

$ tarantella object new_host --ovm \
--name "o=appservers/cn=ovm1" \
--address "https://ovm-mgr.example.com:7002/ovm/core/wsapi/rest" \
--vmsubnet 192.168.0.0/24 

The following example creates a new VirtualBox hypervisor object vbox1 that connects to the Oracle VM VirtualBox host vbox.example.com. Only VMs which are members of the Oracle VM VirtualBox groups support or sales are used by SGD.

$ tarantella object new_host --vbox \
--name "o=appservers/cn=vbox1" \
--address "https://vbox.example.com:18083" \
--vboxgroups "support,sales" 

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