命令行工具

这部分主要介绍iclientpy中所提供的命令行工具

没有你想要的工具的话，点 这里 告诉开发人员。

这些命令行工具可以完成特定的任务。 安装iClient Python的时候这些命令行工具会一起安装。 如果只想使用这些命令行工具而不想安装iClient Python，或者是想在没有Python环境的机器上使用这些命令行工具，也可以下载独立运行包。

点击下载win64命令行工具

点击下载linux64命令行工具

注意： iServer示范notebook、Online示范notebook、iclientpy引导notebook需要在完成安装iclientpy后才能使用，不包含在单独提供的命令行工具

token工具

icpy-tokentool 生成token

示例：

对服务http://localhost:8090/iserver生成一个不做任何客户端验证的60分钟的token

icpy-tokentool -l http://localhost:8090/iserver -u admin -p iserver -c NONE -e 60

详细参数：

-l ADDRESS, --uri ADDRESS
 服务地址，如：http://localhost:8090/iserver
-u USERNAME, --user USERNAME
 用户名
-p PASSWORD, --password PASSWORD
 密码
-c CLIENT_TYPE, --client_type CLIENT_TYPE
 发放令牌的方式。支持以下四个取值，分别对应四种发放令牌的方式：IP，即指定的 IP地址；Referer，即指定的 URL；RequestIP，即发送申请令牌请求的客户端IP；NONE，即不做任何验证。
-e EXPIRATION, --expiration EXPIRATION
 申请令牌的有效期，默认单位为分钟，支持单位m(分)，h(小时)，d(天)，w(周)，M(月)，y(年)
--ip IP clientType=IP 时，必选。 如果按照指定 IP 的方式申请令牌，则传递相应的 IP 地址。
--referer REFERER
 clientType=Referer 时，必选。如果按照指定 URL 的方式申请令牌，则传递相应的 URL。
-h, --help 查看帮助

缓存工具

icpy-cachetool

recache

指定组件名称与地图名称，重新向存储id指明的存储位置增加新的切图

示例：

对服务map-World的World地图进行切图，且新的缓存存储在id是m的存储位置

icpy-cachetool recache -l http://localhost:8090/iserver -t {tokenstr} -c map-World -m World -s m

注： {tokenstr}为占位字符串，生成token字符串请参考：token工具

详细参数：

-l ADDRESS, --uri ADDRESS
 服务地址，如：http://localhost:8090/iserver
-u USERNAME, --user USERNAME
 用户名
-p PASSWORD, --password PASSWORD
 密码
-t TOKEN, --token TOKEN
 用于身份验证的token
-c COMPONENT_NAME, --component-name COMPONENT_NAME
 待更新缓存服务名称
-m MAP_NAME, --map-name MAP_NAME
 切图地图名称
-s STORAGEID, --storageid STORAGEID
 存储的id
-h, --help 查看帮助

updatecache

已经发布为服务的切片，更新切片数据

示例：

从本地的工作空间zip压缩包对map-smtiles-World服务的World地图进行全图缓存更新

icpy-cachetool updatecache -l http://localhost:8090/iserver -t {tokenstr} -c map-smtiles-World -w C:\World.zip -m World -o '-180,90' -b '-180,-90,180,90'

从map-World服务对对map-smtiles-World服务的World地图进行全图缓存更新

icpy-cachetool updatecache -l http://localhost:8090/iserver -t {tokenstr} -c map-smtiles-World -m World -o '-180,90' -b '-180,-90,180,90' --source-component map-World --update

注： {tokenstr}为占位字符串，生成token字符串请参考：token工具

详细参数：

-l ADDRESS, --uri ADDRESS
 服务地址，如：http://localhost:8090/iserver
-u USERNAME, --user USERNAME
 用户名
-p PASSWORD, --password PASSWORD
 密码
-c COMPONENT_NAME, --component-name COMPONENT_NAME
 待更新缓存服务名称
-w W_LOC, --w-loc W_LOC
 工作空间路径
-m MAP_NAME, --map-name MAP_NAME
 切图地图名称
-o ORIGINAL_POINT, --original-point ORIGINAL_POINT
 切图原点，需以单引号开始和结束，如：'-180,90'
-b CACHE_BOUNDS, --bounds CACHE_BOUNDS
 缓存范围，需以单引号开始和结束，如：'-180,-90,0,0'
-s SCALE, --scale SCALE
 缓存比例尺分母，如：8000000,4000000,2000000
--service-type W_SERVICETYPE
 工作空间服务类型
--tile-size TILE_SIZE
 切片大小
--tile-type TILE_TYPE
 切片类型
--format FORMAT
 切片输出格式
--epsgcode EPSG_CODE
 投影
--storageid STORAGEID
 存储id
-rw 输入的工作空间地址是远程iServer所在服务器上的地址，不需要上传工作空间。
--quiet 不需要确认，直接运行
--source-component SOURCE_COMPONENT_NAME
 缓存更新数据来源服务
--update 更新服务缓存，与--source-component搭配使用
-h, --help 查看帮助

cacheworkspace

对本地的工作空间进行切图

示例：

从本地工作空间zip压缩包进行切图，以C:\World.zip，World地图为例，切图原点-180,90，切图范围：-180,-90,180,90，比例尺：4000000,8000000，存储id为m

icpy-cachetool cacheworkspace -l http://localhost:8090/iserver -t {tokenstr} -w C:/World.zip -m World -o '-180,90' -b '-180,-90,180,90' -s 4000000,8000000 --storageid m --quiet

注： {tokenstr}为占位字符串，生成token字符串请参考：token工具

详细参数：

-l ADDRESS, --uri ADDRESS
 服务地址，如：http://localhost:8090/iserver
-u USERNAME, --user USERNAME
 用户名
-p PASSWORD, --password PASSWORD
 密码
-t TOKEN, --token TOKEN
 用于身份验证的token
-w W_LOC, --w-loc W_LOC
 工作空间路径
-m MAP_NAME, --map-name MAP_NAME
 切图地图名称
-s SCALE, --scale SCALE
 缓存比例尺分母，如：8000000,4000000,2000000
-o ORIGINAL_POINT, --original-point ORIGINAL_POINT
 切图原点，需以单引号开始和结束，如：'-180,90'
-b CACHE_BOUNDS, --bounds CACHE_BOUNDS
 缓存范围，需以单引号开始和结束，如：'-180,-90,0,0'
--tile-size TILE_SIZE
 切片大小
--tile-type TILE_TYPE
 切片类型
--format FORMAT
 切片输出格式
--epsgcode EPSG_CODE
 投影
--storageid STORAGEID
 存储的id
--output OUTPUT
 结果输出路径
--remote-workspace
 是否是远程工作空间路径
--quiet 不需要确认，直接运行
--jobtilesourcetype JOBTILESOURCETYPE
 存储类型，可取四个值：SMTiles,MBTiles,UGCV5,GeoPackage。仅在输出到本地存储路径时生效，Mongo，OTS与FastDFS时不生效，Mongo，OTS与FastDFS应直接设置storageid

cacheservice

对已经发布为地图服务的地图进行切图

示例：

对map-World服务进行切图，以World地图为例，切图原点-180,90，切图范围：-180,-90,180,90，比例尺：4000000,8000000，存储类型为UGCV5

icpy-cachetool cacheservice -l http://localhost:8090/iserver -t {tokenstr} -c map-World -m World -o '-180,90' -b '-180,-90,180,90' -s 4000000,8000000 --jobtilesourcetype UGCV5 --quiet

注： {tokenstr}为占位字符串，生成token字符串请参考：token工具

详细参数：

-l ADDRESS, --uri ADDRESS
 服务地址，如：http://localhost:8090/iserver
-u USERNAME, --user USERNAME
 用户名
-p PASSWORD, --password PASSWORD
 密码
-t TOKEN, --token TOKEN
 用于身份验证的token
-c COMPONENT_NAME, --component-name COMPONENT_NAME
 服务名称
-m MAP_NAME, --map-name MAP_NAME
 切图地图名称
-o ORIGINAL_POINT, --original-point ORIGINAL_POINT
 切图原点，需以单引号开始和结束，如：'-180,90'
-b CACHE_BOUNDS, --bounds CACHE_BOUNDS
 缓存范围，需以单引号开始和结束，如：'-180,-90,0,0'
-s SCALE, --scale SCALE
 缓存比例尺分母，如：8000000,4000000,2000000
--service-type W_SERVICETYPE
 工作空间服务类型
--tile-size TILE_SIZE
 切片大小
--tile-type TILE_TYPE
 切片类型
--format FORMAT
 切片输出格式
--epsgcode EPSG_CODE
 投影
--storageid STORAGEID
 存储id
--output OUTPUT
 结果输出路径
--quiet 不需要确认，直接运行
--jobtilesourcetype JOBTILESOURCETYPE
 存储类型，可取四个值：SMTiles,MBTiles,UGCV5,GeoPackage。仅在输出到本地存储路径时生效，Mongo，OTS与FastDFS时不生效，Mongo，OTS与FastDFS应直接设置storageid

iServer初始化工具

对为进行初始化的iServer服务进行初始化

示例：

对地址是 http://localhost:8090/iserver 的iServer进行初始化，初始化用户名为supermap，密码为supermap

icpy-initserver -l http://localhost:8090/iserver -u supermap -p supermap

详细参数：

-l ADDRESS, --uri ADDRESS
 服务地址，如：http://localhost:8090/iserver
-u USERNAME, --user USERNAME
 用户名
-p PASSWORD, --password PASSWORD
 密码
-t TIMEOUT, --timeout TIMEOUT
 超时时间，等待iServer启动的超时时间，单位为分钟

iServer示范notebook

启动iServer的示范notebook

示例：

启动iServer的示例notebook，iServer地址为http://localhost:8090/iserver，用户名为supermap，密码为supermap，绑定notebook的ip为localhost，端口为8889

icpy-serverstart -l http://localhost:8090/iserver -u supermap -p supermap --ip localhost --port 8889

详细参数：

-l ADDRESS, --uri ADDRESS
 服务地址，如：http://localhost:8090/iserver
-u USERNAME, --user USERNAME
 用户名
-p PASSWORD, --password PASSWORD
 密码
--dir NOTEBOOK_DIR
 notebook目录
--ip IP notebook服务ip
--port PORT notebook服务端口

Online示范notebook

启动Online的示范notebook

示例：

启动Online的示例notebook，Online的用户名为supermap，密码为supermap，绑定notebook的ip为localhost，端口为8889

icpy-onlinestart -u supermap -p supermap --ip localhost --port 8889

详细参数：

-u USERNAME, --user USERNAME
 用户名
-p PASSWORD, --password PASSWORD
 密码
--dir NOTEBOOK_DIR
 notebook目录
--ip IP notebook服务ip
--port PORT notebook服务端口

iclientpy引导notebook

启动iclientpy引导使用的notebook

示例：

启动iclientpy示例，绑定notebook的ip为localhost，端口为8889

icpy-iclientpystart --ip localhost --port 8889
详细参数：
--dir NOTEBOOK_DIR
 notebook目录
--ip IP notebook服务ip
--port PORT notebook服务端口