RemoteClusterAccess

连接到调度器,当客户端工具不是本地可用

构造函数

r = parallel.cluster.RemoteClusterAccess(用户名)

r = parallel.cluster.RemoteClusterAccess(用户名、P1 V1,…, Pn, Vn)

描述

r = parallel.cluster.RemoteClusterAccess (用户名)创建一个RemoteClusterAccess对象的用户名设置为用户名。

默认情况下,提示输入密码,当你连接到集群。

提示

如果你设置为远程集群,集群配置文件使用parcluster。有关更多信息,请参见发现集群和集群配置文件使用。

你只需要使用RemoteClusterAccess如果你需要修改插件脚本为您连接到第三方调度器处于非公用或远程提交模式。你使用的插件脚本使用通用调度程序接口连接到一个集群。

如果客户不能直接提交第三方调度器,或客户不与集群共享一个文件系统,考虑以下:

如果第三方调度器MathWorks^®插件,安装它。当您使用一个插件,您可以设置您的集群配置文件使用设置向导或集群配置文件管理器设置许多设置。有关更多信息,请参见插件脚本通用的调度器。
如果你需要使用第三方的调度器,并没有一个插件,或者如果你需要定制一个插件,看看使用通用调度程序接口配置(MATLAB并行服务器)。
使用RemoteClusterAccess当你需要修改设置为远程集群连接,提交,或数据传输。

r = parallel.cluster.RemoteClusterAccess (___,名称,值)创建一个RemoteClusterAccess对象使用一个或多个名称参数。例如,指定“端口”,31415年连接到一个集群使用端口号31415年。毕竟其他输入参数指定名称参数。

公认的名称参数:

“AuthenticationMode”——身份验证模式时使用连接到集群中,指定为一个字符串标量或特征向量。
如果指定的参数“IdentityFilename”默认值是“IdentityFile”。否则,默认值是“密码”。有效值为“AuthenticationMode”是:
- “代理”——客户端接口与SSH代理运行在客户端机器上。
- “IdentityFile”——客户端使用身份文件连接到集群时进行身份验证。如果你指定一个文件使用IdentityFilename选项,您可以使用该文件。否则,MATLAB^®提示您指定完整路径身份文件当你连接。
- 多因素的——客户端提示您输入一个或更多的时间。例如,如果启用了双因素身份验证(2 fa)在客户端,客户端请求你的密码和响应为第二个身份验证因素。
- “密码”——客户端提示您为您的SSH密码。您的用户名是指定的用户名财产。
“IdentityFileHasPassphrase”——国旗表示如果需要密码身份文件,指定为真正的或假。如果真正的,你是连接时提示输入密码。如果不提供身份文件,不使用这个名称参数。
“IdentityFilename”——完整路径时使用的身份文件RemoteClusterAccess连接到一个远程主机,指定为“IdentityFilename”和一个字符串标量或特征向量。
“端口”——端口号在集群上你连接,指定为一个整数标量之间1和65535年。
默认值是22。

更多信息和详细的例子,看看提交从远程主机和没有共享文件系统提交。

方法

方法名称	描述
`连接`	`连接(r, clusterHost)`建立一个连接到指定的主机在构造函数中使用用户证书的选项提供。不支持文件镜像。金宝app`clusterHost`必须运行Linux。 `连接(r, clusterHost, remoteDataLocation)`建立一个连接到指定的主机在构造函数中使用用户证书的选项提供。`remoteDataLocation`标识上的一个文件夹中`clusterHost`用于文件镜像。在构造函数中提供的用户凭据必须写访问这个文件夹。
`断开连接`	`断开(右)`断开连接现有的远程连接。的`连接`方法必须已经被调用。
`doLastMirrorForJob`	`doLastMirrorForJob (r,工作)`执行最后一个从远程更改文件的副本`remoteDataLocation`到本地`JobStorageLocation`对所提供的工作。任何正在运行的镜子也停止工作和工作文件从远程删除`remoteDataLocation`。的`startMirrorForJob`或`resumeMirrorForJob`方法必须已经被调用。
`getRemoteJobLocation`	`getRemoteJobLocation (r, jobID, remoteOS)`返回完整路径的位置提供的远程工作`jobID`。有效值为`remoteOS`是`“电脑”`和`“unix”`。
`isJobUsingConnection`	`isJobUsingConnection (r, jobID)`返回`真正的`如果工作是目前反映。
`resumeMirrorForJob`	`resumeMirrorForJob (r,工作)`从远程恢复的镜像文件`remoteDataLocation`到本地`JobStoragelocation`对所提供的工作。这是相似的`startMirrorForJob`方法,但不首先复制文件从本地`JobStorageLocation`到远程`remoteDataLocation`。的`连接`方法必须已经被调用。这是非常有用的,如果原来的客户MATLAB会话已经结束,你从一个新的客户端访问同一个文件会话。
`runCommand`	`[状态,结果]= runCommand (r,命令)`运行在远程主机上提供的命令并返回产生的地位和标准输出。的`连接`方法必须已经被调用。
`startMirrorForJob`	`startMirrorForJob (r,工作)`所有的工作文件从本地副本`JobStorageLocation`到远程`remoteDataLocation`,开始镜像文件,以便在远程对文件的任何更改`remoteDataLocation`复制回当地吗`JobStorageLocation`。的`连接`方法必须已经被调用。
`stopMirrorForJob`	`stopMirrorForJob (r,工作)`立即停止从远程镜像文件`remoteDataLocation`到本地`JobStorageLocation`为指定的工作。的`startMirrorForJob`或`resumeMirrorForJob`方法必须已经被调用。这取消运行镜像和删除文件的工作从远程位置。这类似于`doLastMirrorForJob`,除了`stopMirrorForJob`没有试图确保本地工作文件是最新的。正常的镜子停工,使用`doLastMirrorForJob`。
`getConnectedAccess`	`getConnectedAccess(主机、用户名)`返回一个`RemoteClusterAccess`对象连接到主机提供。这个函数可以返回一个先前构造的`RemoteClusterAccess`如果存在一个对象。`主机`必须运行Linux。 `getConnectedAccess (…, P1, V1,……Pn, Vn)`通过额外的参数`RemoteClusterAccess`构造函数。
`getConnectedAccessWithMirror`	`getConnectedAccessWithMirror(主机、remoteDataLocation用户名)`返回一个`RemoteClusterAccess`对象连接到主机,提供使用`remoteDataLocation`作为镜子的位置。这个函数可以返回一个先前构造的`RemoteClusterAccess`如果存在一个对象。`主机`必须运行Linux。 `getConnectedAccessWithMirror (…, P1, V1,……Pn, Vn)`通过额外的参数`RemoteClusterAccess`构造函数。

属性

一个RemoteClusterAccess对象有以下只读属性。它们的值设置当你构建对象或调用它连接方法。

属性名	描述
`AuthenticationMode`	选项指示你如何验证连接到集群时,返回的是下列之一: `“代理”`——客户端接口与SSH代理运行在客户端机器上。 `“IdentityFile”`——客户端使用身份文件连接到集群时进行身份验证。如果`IdentityFilename`房地产并不是一个空字符串或空特征向量,使用该文件。否则,MATLAB提示您指定完整路径身份文件当你连接。 `“多因素”`——客户端提示您输入一个或更多的时间。例如,如果启用了双因素身份验证(2 fa)在客户端,客户端请求你的密码和响应为第二个身份验证因素。 `“密码”`——客户端提示您为您的SSH密码。您的用户名是指定的`用户名`财产。如果`IdentityFilename`房地产并不是一个空字符串标量或空特征向量,该属性被设置为`“IdentityFile”`默认情况下。否则,它将`“密码”`默认情况下。设置该属性,指定`“AuthenticationMode”`当你创建一个名称-值参数`RemoteClusterAccess`对象。
`主机名`	远程主机的名称来访问,返回一个特征向量。默认值是一个空的特征向量。
`IdentityFileHasPassphrase`	国旗表示如果需要密码身份文件,指定为逗号分隔组成的`“IdentityFileHasPassphrase”`和`真正的`或`假`。默认值是`假`。如果将此属性设置为`真正的`,你是连接时提示输入密码。如果不提供身份文件,不使用这个属性。设置该属性,指定`“IdentityFileHasPassphrase”`当你创建一个名称-值参数`RemoteClusterAccess`对象。
`IdentityFilename`	完整路径时使用的身份文件`RemoteClusterAccess`对象连接到一个远程主机,作为一个特征向量返回。默认值是一个空的特征向量。如果这个属性是空的,你是连接时提示输入密码。设置该属性,指定`“IdentityFilename”`当你创建一个名称-值参数`RemoteClusterAccess`对象。
`与一`	国旗表明如果`RemoteClusterAccess`对象连接到集群中,返回`真正的`或`假`。默认值是`假`。
`IsFileMirror金宝appSupported`	标志指示是否支持文件镜像的金宝app`RemoteClusterAccess`对象,指定为`真正的`或`假`。默认值是`假`。的`IsFileMirror金宝appSupported`属性设置为`真正的`如果`JobStorageLocation`属性不是空的。
`JobStorageLocation`	位置在远程主机上的文件被镜像,作为一个特征向量返回。默认值是一个空的特征向量。设置此属性,使用下列语法连接到集群: `连接(r, clusterHost, remoteDataLocation)` `r = getConnectedAccessWithMirror(主机、remoteDataLocation用户名)` `r = getConnectedAccessWithMirror (___, P1, V1,……Pn, Vn)`
`港口`	您使用端口号连接到集群中,作为一个整数返回标量之间`1`和`65535年`。默认值是`22`。设置该属性,指定`“端口”`当你创建一个名称-值参数`RemoteClusterAccess`对象。
`UseIdentityFile`	国旗表明如果`RemoteClusterAccess`对象使用一个身份文件连接到集群中,返回`真正的`或`假`。默认值是`假`。如果`AuthenticationMode`属性是`“IdentityFile”`,`UseIdentityFile`属性是`真正的`。
`用户名`	用户名可以使用连接到集群中,作为一个特征向量返回。

例子

从远程数据镜像文件的位置。假设对象工作代表了一个工作在你的通用的调度器。

remoteConnection = parallel.cluster.RemoteClusterAccess (“testname”);连接(remoteConnection“headnode1”,“/ tmp / filemirror”);startMirrorForJob (remoteConnection、工作);提交(工作)%等工作完成等待(工作);%确保当地所有的文件是最新的,并删除%远程文件doLastMirrorForJob (remoteConnection、工作);%得到的输出参数工作结果= fetchOutputs(工作)

的更多信息和示例,请参阅提交从远程主机和没有共享文件系统提交。

RemoteClusterAccess

构造函数

描述

方法

属性

例子

版本历史

另请参阅

主题