Use the installServiceMap command to
install a service map in preparation for attaching that service map
to one or more local mapping services.
Purpose
The installServiceMap command
installs a service map to the service map repository. After you install
a service map, you can attach that service map to one or more local
mapping services.
Required parameters
- -sourceLibrary
- Specifies the name of the service map library compressed file
with extension .zip or .slibzip that
contains the service map that you want to install.
Optional parameters
- -sourceServiceMap
- Specifies the name of the service map file that you want to install
as a service map. If the service map library has multiple service
map files, this parameter is required.
- -name
- Specifies a human readable name for the service map. A service
map must have a name. If you do not specify a name, the name is derived
from the ID value of the service map that is to be installed.
Names
must be unique within a cell, cannot begin with a number, dot or minus
character, and cannot contain unsupported characters. The following
characters are not supported:
\/,.#$@:;"*?<>()|=+&%'![]{}
(space)
the character combination ]]>
- -description
- A description for the service map.
- -deploymentTargets
- The names of the clusters or servers on which to install this
service map. Use one of the following formats:
- For a cluster of application servers: WebSphere:cluster=myClusterName.
- For an application server that is not a cluster member: WebSphere:node=myNodeName,server=myServerName.
To specify multiple targets, precede each additional target
with the plus sign (+). For example: WebSphere:cluster=myCluster1+WebSphere:cluster=myCluster2.
- -targetServiceEndpoints
- Specifies target service endpoints to be passed to the install command.
These endpoints are set as the overriding endpoint address for each
target service that is specified in the source service map.
Each
target service endpoint is specified by name and endpointURL table
step parameters. Because they are table steps, the order of the two
parameters is fixed, and you must always specify the name first and
the endpointURL second:
- In Jython:[name endpointURL]
- In Jacl: {name endpointURL}
Example usage
The following example shows
how you install a service map named MyServiceMap.
Using
Jython:
Input message:
AdminTask.installServiceMap('-sourceLibrary serviceMapLib.slibzip -sourceServiceMap myMap.srvcmap -name MyServiceMap -description "My simple service map" -targetServiceEndpoints[[MyServiceService http://localhost:9080/MyServiceService][MyEnhancedServiceService http://localhost:9080/MyEnhancedServiceService]]')
Output
message:
MyServiceMap
Using Jacl:
Input
message:
$AdminTask installServiceMap {-sourceLibrary serviceMapLib.slibzip -sourceServiceMap myMap.srvcmap -name MyServiceMap -description "My simple service map" -targetServiceEndpoints {{MyServiceService http://localhost:9080/MyServiceService} {MyEnhancedServiceService http://localhost:9080/MyEnhancedServiceService}}}
Output
message:
MyServiceMap