Package Deployment

Deploys a package to a domain.

Syntax

void deployPackage(String fileName, DEPLOY_MODE deployMode, String securityConfiguration, Collection<RoleMappingVO> roleMappings, Map<String, String> endpointMappings) throws SUPAdminException;

Parameters

The deployment mode determines how the deployment process handles the objects in a deployment unit and package. Which value you choose depends on whether or not a package of the same name already exists on Unwired Server. Allowed values are:

UPDATE – updates the target package with updated objects. After deployment, objects in the server's package with the same name as those being deployed are updated. By default, deploymentMode is UPDATE.
NOCLOBBER – deploys the package only if there are no objects in the target server's package that have the same name as any of those objects being deployed.
REPLACE – replaces any of the target objects with those in the package. After deployment, the servers package contains only those objects being deployed.
VERIFY – do not deploy package. Only return errors, if any. Used to determine the results of the UPDATE deploy mode.

If the deployment mode is specified both in the descriptor file and the command-line, the command-line deploymentMode option override the deployment mode specified in the descriptor file.

Returns

If successful, returns silently. If unsuccessful, returns SUPAdminException.

Examples

Package deployment – deploys a package to a domain:

Collection<RoleMappingVO> roleMappingVOs = new ArrayList<RoleMappingVO>();
RoleMappingVO rmvo1 = new RoleMappingVO();
rmvo1.setSourceRole("Role1");
rmvo1.setRoleMappingType(ROLE_MAPPING_TYPE.AUTO);
RoleMappingVO rmvo2 = new RoleMappingVO();
rmvo2.setSourceRole("Role2");
rmvo2.setRoleMappingType(ROLE_MAPPING_TYPE.AUTO);
RoleMappingVO rmvo3 = new RoleMappingVO();
rmvo3.setSourceRole("Role3");
rmvo3.setRoleMappingType(ROLE_MAPPING_TYPE.AUTO);

roleMappingVOs.add(rmvo1);
roleMappingVOs.add(rmvo2);
roleMappingVOs.add(rmvo3);

Map<String, String> endpointMappings = new HashMap<String, String>();
endpointMappings.put("sampledb", "sampledb2");

supDomain.deployPackage("<deployment unit file name>",
		DEPLOY_MODE.UPDATE,
		"<security configuration name>", roleMappingVOs, endpointMappings);