命令行工具 ====================== 这部分主要介绍iclientpy中所提供的命令行工具 没有你想要的工具的话,点 `这里 `_ 告诉开发人员。 这些命令行工具可以完成特定的任务。 安装iClient Python的时候这些命令行工具会一起安装。 如果只想使用这些命令行工具而不想安装iClient Python,或者是想在没有Python环境的机器上使用这些命令行工具,也可以下载独立运行包。 `点击下载win64命令行工具 `_ `点击下载linux64命令行工具 `_ * token工具_ * 缓存工具_ * iServer初始化工具_ * iServer示范notebook_ * Online示范notebook_ * iclientpy引导notebook_ **注意:** 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服务端口