Sun Java System SAML v2 Plug-in for Federation Services User's Guide

Deploying the SAML v2 Plug-in for Federation Services in Sun Java System Web Server

Sun Java System Web Server has the wdeploy command line utility to deploy a WAR file. The syntax is:

wdeploy deploy -u /deployment-URI -i instance-name -v vs-id -d deployment-directory WAR-file-location 

where:

deployment-URI

Defines the URI for the application. 


Note –

Note the inclusion of the leading slash.


instance-name

Defines the instance of Web Server to which you are deploying the web application. 

vs-id

Defines the virtual server ID of the instance of Web Server to which you are deploying the web application. 

deployment-directory

Defines the directory to which the WAR will be deployed. 

WAR-file-location

Defines the full path to the WAR file being deployed. 

When you execute wdeploy, a web application with the defined URI and directory is added to the server.xml file. The WAR file is also extracted from its location and deployed in the deployment directory.


Note –

More information on the wdeploy utility can be found in the Sun Java System Web Server 6.1 SP4 Programmer’s Guide to Web Applications.


To Deploy an Instance of the SAML v2 Plug-in for Federation Services in Web Server

To deploy the SAML v2 Plug-in for Federation Services in Web Server, type:


# WebServer-base/SUNWwbsvr/bin/https/httpadmin/bin/wdeploy deploy 
-u /deployment-URI -i instance-name -v vs-id 
-d WebServer-base/instance-name/deployment-URI war-file-location

For example, when deploying the SAML v2 Plug-in for Federation Services in an instance of Federation Manager deployed in Web Server, you might use:


# /WebServer-base/SUNWwbsvr/bin/https/httpadmin/bin/wdeploy deploy -
u /saml2 -i niceday.red.sun.com -v https-niceday.red.sun.com 
-d /opt/SUNWwbsvr/https-niceday.red.sun.com/saml2 
/var/opt/SUNWam/fm/war_staging/federation.war

To Remove the SAML v2 Plug-in for Federation Services from Web Server

To remove the SAML v2 Plug-in for Federation Services from Web Server, type:


# /WebServer-base/bin/https/httpadmin/bin/wdeploy delete -u /deployment-URI 
-i instance-name -v vs-id -n hard

where:

WebServer-base

Defines the Web Server installation directory. 

deployment-URI

Defines the SAML v2 Plug-in for Federation Services URI (with leading slash). 

instance-name

Defines the instance of Web Server to which the web application is deployed. 

vs-id

Defines the virtual server ID of the instance of Web Server to which you are deploying the web application. 

For example:


# /WebServer-base/SUNWwbsvr/bin/https/httpadmin/bin/wdeploy delete -u /saml2 
-i https-niceday.red.sun.com -v https-niceday.red.sun.com -n hard