deployDSVM: Deploy a new Data Science Virtual Machine (DSVM).

Usage Arguments Details Examples

Usage

1
2
3
deployDSVM(context, resource.group, location, hostname, username,
  size = "Standard_D1_v2", os = "Ubuntu", authen = "Key", pubkey = "",
  password = "", dns.label = hostname, mode = "Sync")

Arguments

context

Authentication context of AzureSMR encapsulating the TID, CID, and key obtained from Azure Actrive Directory.

resource.group

The Azure resource group where the DSVM is created.

location

Location of the data centre to host the DSVM.

hostname

Name of the DSVM. Lowercase characters or numbers only. Special characters are not permitted.

username

User name of the DSVM. It should be different from 'name'.

size

Size of the DSVM. The default is "Standard_D1_v2". All available sizes can be obtained by function 'getVMSizes'.

os

Operating system of DSVM. Permitted values are "Ubuntu", "CentOS", "Windows", "DeepLearning", and "MRS". The default is to deploy a Ubuntu Linux Data Science Virtual Machine. NOTE previously Windows based DSVM for deep learning toolkit is using a separated package but now it is merged into one.

authen

Either "Key" for public-key based authentication (with Linux) or "Password" for a password based authentication (Linux or Windows). Default is to use public key authentication for Linux and password based authentication for Windows.

pubkey

Public key for the DSVM. Only applicable for public-key based authentication of Linux based DSVM.

password

Pass word for the DSVM.

dns.label

DNS label for the VM address. The URL for accessing the deployed DSVM will be "<dns_label>.<location>.cloudapp.azure.com

mode

Mode of virtual machine deployment. Default is "Sync".

Details

Usually an error message will be returned if the deployment is unsuccessful. If the deployment fails without explicit error message returned visit the Azure portal https://ms.portal.azure.com and browse to the resource group and click on the failed deployment link to view the failure message. Typical errors include DnsRecordInUse or StorageAccountAlreadyTaken. If so then choose a different hostname.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
## Not run: 
# The following deploys a Ubuntu DSVM with public key based authentication
deployDSVM(context, resource.group="<resource_group>", 
location="<location>", hostname="<machine_name>", username="<user_name>", 
os="Ubuntu", pubkey="<a_valid_public_key_string_in_SSH_format>")

# The following deploys a Windows DSVM with password based authentication. 
The VM size is selected from all the available A-series machines that have 
the maximum number of computing cores.

vm <- getVMSizes(context, "<location>")

names(vm)

vm_sub <- vm[grep(vm[, 1], pattern="Basic_A"), ]
vm_name <- vm_sub[vm_sub[, 2] == max(vm_sub[, 2]), 1]

deployDSVM(context,
           resource.group="<resource_group>",
           location="<location>",
           hostname="<machine_name>",
           username="<user_name>",
           os="Windows",
           password="<a_valid_password>")
## End(Not run)

Azure/AzureDSVM documentation built on May 20, 2019, 2:03 p.m.