マップサービスキャッシュ格納形式のアップグレード (Upgrade Map Server Cache Storage Format) (サーバー)—ArcMap

概要
使用法
構文
コードのサンプル
環境
ライセンス情報

概要

10.3 以降のバージョンで利用できるパフォーマンスの向上を活用するために、(10.2.2 以前に作成した) マップまたはイメージサービスのコンパクトキャッシュ格納形式をアップグレードします。

10.3 から、キャッシュされたマップおよびイメージサービスを利用するときのパフォーマンスを向上させるために、コンパクトキャッシュ格納形式が改善されました。この改善では、*.bundle ファイルの内部にタイルインデックス情報を含めることで、キャッシュディレクトリ内に作成されるファイルの数も削減されています。ArcGIS 10.3 for Server (以降のバージョン) で作成された新しいコンパクトキャッシュは、このパフォーマンスの向上を自動的に活用します。

10.3 以降のバージョンにアップグレードしても、以前のバージョンで生成されたコンパクトキャッシュを使用したサービスは引き続き動作します。サーバーキャッシュツールを使用してこれらのキャッシュを維持し続けることができます。

既存のキャッシュでパフォーマンスの向上を活用するには、10.3 (以降のバージョン) にアップグレードしてから、このツールを使用してキャッシュをアップグレードします。キャッシュをアップグレードしても新しいタイルは作成されませんが、ファイルは改善された形式に準拠しているものとして認識されます。

改善されたコンパクトキャッシュ格納形式は、以前の ArcGIS と後方互換性はありません。たとえば、10.3 (以降のバージョン) を使用して作成またはアップグレードされたコンパクトキャッシュを移動したり、10.2.2 (以前のバージョン) のソフトウェアで使用することはできません。改善されたコンパクトキャッシュ格納形式は、常にサービスに関連付けられている必要があります。

使用法

このツールを使用するには、アップグレードするマップまたはイメージサービスのキャッシュを指定します。ツールは、サービスの現在の格納形式を検出し、その情報を使用してキャッシュがアップグレード可能であるかどうかを判定します。
[キャッシュサービスのインスタンス数] (num_of_caching_service_instances Python では ) パラメーターに値を指定することで、キャッシュのアップグレードに専用で使用するサービスインスタンスの数を選択できます。
このツールは新しいタイルを作成しませんが、既存のタイルは改善された形式に準拠しているものととして同じフォルダー内で認識されます。古い形式は、アップグレードの一部として削除されます。このツールを実行する前に、既存のキャッシュをバックアップしておくことをお勧めします。
ツールが失敗したり、処理中にキャンセルされた場合、ツールを再実行すると、タスクは失敗またはキャンセルされた場所から開始されます。
エクスプロード形式のキャッシュサービスをアップグレードするには、[マップサービスキャッシュ格納形式を変換 (Convert Map Server Cache Storage Format)] ツールを使用します。

構文

arcpy.server.UpgradeMapServerCacheStorageFormat(input_service, {num_of_caching_service_instances})

パラメーター	説明	データタイプ
input_service	アップグレードするマップまたはイメージサービスのキャッシュ。この文字列には、サーバーとサービスの両方の情報が含まれています。この文字列の構築方法を確認するには、ArcCatalog を開き、カタログツリーでサービスを選択して、[場所] ツールバーに表示されているテキストを記録します。バックスラッシュをスラッシュに変更します (たとえば、GIS Servers/arcgis on MYSERVER (admin)/USA.MapServer)。	String
num_of_caching_service_instances (オプション)	このツールの実行に専用で使用する、システム/CachingTools サービスのインスタンス数の合計。ArcGIS Server への管理者接続を通して使用できる [サービスエディター] ウィンドウで、システム/CachingTools サービスの [コンピューターごとのインスタンスの最大数] の値を大きく変更することができます。選択したインスタンス数を、サーバーコンピューターでサポートできることを確認してください。	Long

パラメーター

説明

データタイプ

input_service

アップグレードするマップまたはイメージサービスのキャッシュ。

この文字列には、サーバーとサービスの両方の情報が含まれています。この文字列の構築方法を確認するには、ArcCatalog を開き、カタログツリーでサービスを選択して、[場所] ツールバーに表示されているテキストを記録します。バックスラッシュをスラッシュに変更します (たとえば、GIS Servers/arcgis on MYSERVER (admin)/USA.MapServer)。

String

num_of_caching_service_instances

(オプション)

このツールの実行に専用で使用する、システム/CachingTools サービスのインスタンス数の合計。ArcGIS Server への管理者接続を通して使用できる [サービスエディター] ウィンドウで、システム/CachingTools サービスの [コンピューターごとのインスタンスの最大数] の値を大きく変更することができます。選択したインスタンス数を、サーバーコンピューターでサポートできることを確認してください。

Long

コードのサンプル

Upgrade Map Cache Storage Format (マップサービスキャッシュ格納形式のアップグレード) の例 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトは、コンパクトキャッシュ格納形式をアップグレードする方法を示しています。

# Name: UpgradeMapServerCacheStorageFormat.py
# Description: The following stand-alone script demonstrates how to upgrade map
# server cache storage format to the latest compact storage format

# Requirements: os, sys, time, traceback modules
# Any line that begins with a pound sign is a comment and will not be executed
# Empty quotes take the default value.
# To accept arguments from the command line replace values of variables to
# "sys.argv[]"

# Import system modules
import arcpy
from arcpy import env
import os, sys, time, string, datetime, traceback

# Set environment settings
env.workspace = "C:/data"

# Set local variables for mapservice properties
connectionFile = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.3\ArcCatalog"
server = "arcgis on MyServer_6080 (publisher)"
serviceName = "Rainfall.MapServer"
inputService = connectionFile + "\\" + server + "\\" + serviceName
numOfCachingServiceInstances = "2"

currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = "C:/data/report_%s.txt" % arg1
# print results of the script to a report
report = open(file,'w')

# Execute UpgradeMapServerCacheFormat
try:
    starttime = time.clock()
    result = arcpy.UpgradeMapServerCacheStorageFormat_server(inputService,
                                                             numOfCachingServiceInstances)
    finishtime = time.clock()
    elapsedtime = finishtime - starttime
    #print messages to a file
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))
    
    print "Upgraded Map Server Cache Storage format for " + serviceName + " in " +\
    str(elapsedtime) + " sec \n on" + arg2
    
except Exception, e:
    # If an error occurred, print line number and error message
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(e.message)
report.close()
    
print "Upgraded Map Server Cache Storage format "

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

Basic: はい
Standard: はい
Advanced: はい

概要

使用法

構文

コードのサンプル

Upgrade Map Cache Storage Format (マップ サービス キャッシュ格納形式のアップグレード) の例 (スタンドアロン スクリプト)

環境

ライセンス情報

関連トピック

Upgrade Map Cache Storage Format (マップサービスキャッシュ格納形式のアップグレード) の例 (スタンドアロンスクリプト)