GRBloadclientenv


GRBloadclientenv

int GRBloadclientenv Grbenv. ** envp,
const char * logfilename,
const char * computeserver,
const char *路由器,
const char *密码,
const char *团体,
int CSTLSINSECURE,
int 优先事项,
双倍的 暂停 )

在Compute Server上创建客户端环境。优化模型在环境中居住,因此这通常是应用程序中的第一个Gurobi例程。此呼叫指定将解决这些优化模型的计算服务器,以及关联作业的优先级。

此例程还将检查名为的文件的当前工作目录gurobi.env.,并且它将尝试从此文件中读取参数设置如果存在。该文件应该是PRM.格式(简要介绍,每行应包含参数名称,然后包含该参数的所需值)。

通常,您应该旨在在程序中创建一个Gurobi环境,即使您计划使用多种型号。重新使用一个环境比创建和销毁多个环境更有效。如果您正在编写多线程程序,则是一个例外,因为环境不是线程安全的。在这种情况下,您需要为每个线程提供单独的环境。

返回值:

非零返回值表示创建环境存在问题。参考错误代码表格有可能返回值列表。

论点:

envp.:应放置指向新创建的环境的指针的位置。

logfilename.:此环境的日志文件名称。可能是空值(或空字符串),在这种情况下,没有创建日志文件。

computeserver:计算服务器。您可以使用服务器名称或IP地址来引用服务器。如果使用非默认端口,服务器名称后面应该跟着端口号(例如,SERVER1:61000.的)

路由器:Compute Server群集的路由器。路由器可用于提高计算服务器部署的稳健性。您应该使用其名称或其IP地址引用路由器。如果没有使用路由器(这是典型的情况),请传递空字符串。

密码:获取对指定的Compute Server群集访问的密码。如果不需要密码,请传递空字符串。

团体:Compute Server组的名称。

CStlsinsecure:表示是否在TLS(传输层安全性)中使用不安全模式。将此设置为0,除非您的服务器管理员否则告诉您。

优先事项:工作的优先权。优先事项必须在-100和100之间,默认值为0(按约定)。在较低优先级作业之前,从服务器作业队列中选择更高的优先级作业。根据服务器的配置,具有优先级100的作业立即运行,绕过作业队列并忽略服务器上的作业限制。您应该在优先级100个作业中谨慎行事,因为它们可以严重过载服务器,这可能导致作业失败,并且在极端情况下可能导致服务器崩溃。此行为由此管理HARDJOBLIMIT,默认情况下禁用。参考Gurobi Remote Services参考手册有关启动Compute Server选项的详细信息。

暂停:队列超时(以秒为单位)。如果作业未在指定超时前到达队列的前部,则呼叫将退出aJob_rejected.错误。使用-1表示呼叫永远不会超时。

使用示例:

grbenv * env;错误= grbloadclientenv(&env,“gurobi.log”,“server1.mydomain.com,server2.mydomain.com”,“”,“,”,0,5,-1.0);