installServiceMap command
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.Target object
None
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. - For a cluster of application servers:
- -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}
- In Jython:
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:
MyServiceMapUsing 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