Обновить формат хранения кэша картографического сервера

Краткая информация

Обновляет формат компактного хранения кэша картографического сервиса или сервиса изображений (созданного в версии 10.2.2 или ранее), что позволяет воспользоваться преимуществами повышения производительности, доступными в версии 10.3 и более новых.

Начиная с версии 10.3 формат компактного хранения кэша изменен, что позволило повысить производительность при использовании кэшированных картографических сервисов и сервисов изображений. При изменении также было снижено число файлов, создаваемых в папке кэша, с помощью включения индексов листов (файлов .bundlx) непосредственно в файлы .bundle. Новый компактный кэш, создаваемый с помощью ArcGIS 10.3 for Server (и более новых версий), будет автоматически использовать новый формат.

Если вы обновили сервер до версии 10.3 или более новой, сервисы с компактным кэшем, созданные в более ранних версиях, продолжат работать. Вы можете продолжить работу с этим кэшем, используя соответствующие серверные инструменты.

Если вы хотите перевести существующий кэш в новый формат, выполните обновление сервера до 10.3 или более новой версии, затем обновите кэш с помощью этого инструмента. Обновление кэша не приводит к созданию новых листов; старые файлы преобразуются в соответствии с новой версией.

Улучшенный формат компактного хранения кэша не является обратно совместимым с ранними версиями ArcGIS. Например, компактный кэш, созданный или обновленный в версии 10.3 (или более новой), не может быть использован в версии 10.2.2 (или более ранних). Улучшенная версия формата компактного хранения кэша всегда будет связана с сервисом.

Использование

• Чтобы использовать этот инструмент, укажите картографический сервис или сервис изображений, кэш которого вы хотите обновить. Инструмент определяет текущий формат хранения сервиса и использует эту информацию для определения возможности обновления.

• Вы можете выбрать количество экземпляров сервиса для обновления кэша, задав значение параметра Количество экземпляров сервиса кэширования (num_of_caching_service_instances в Python).

• Этот инструмент не создает новых листов; вместо этого старые листы преобразуются в той же папке в соответствии с новой версией. Предыдущий формат при обновлении удаляется. Рекомендуется выполнить резервное копирование кэша перед запуском этого инструмента.

• Если работа инструмента прерывается или отменяется, перезапуск инструмента позволит продолжить работу с прерванного места.

• Чтобы обновить кэш раздельного сервиса, используйте инструмент Конвертировать формат хранения кэш картографического сервера.

Синтаксис

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 (Дополнительный)	Общее количество экземпляров сервиса System/CachingTools, которые вы хотите выделить для работы этого инструмента. Вы можете увеличить Максимальное число экземпляров на компьютер сервиса System/CachingTools с помощью окна Редактор сервисов, доступного через административное подключение к ArcGIS for Server. Убедитесь, что ваши серверы смогут поддерживать выбранное количество экземпляров.	Long

Пример кода

Upgrade Map Cache Storage Format, пример (автономный скрипт Python)

Следующий автономный скрипт демонстрирует, как обновить формат компактного хранения кэша.

# 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: Да