There are a number of updates that you need to make if you want to deploy to a
context path that isn't /SkyVault.
The context path is the path that is used by applications (for example, SkyVault Share, SOLR, SharePoint,
and others) to access the repository. If you change this value, you must reflect the change
in your application server configuration.
Follow these steps if you want to deploy to a context path that is not
/SkyVault. The string new-context-path is used to
represent the name of the context path that you are using:
Note: You cannot install at the server root (/). In other words, the context path cannot be
the server root.
- Deploy the SkyVault.war file to a different context path; for example, if you are using Tomcat, rename the SkyVault.war file to new-context-path.war and then deploy it. For other application servers, set the context path in the Admin Console during deployment.
- Update SkyVault-global.properties with the name of the context path: SkyVault.context=new-context-path.
-
Update the context path setting in the _vti_bin application:
- Unpack the _vti_bin.war file.
- Locate the WEB-INF/web.xml file in the _vti_bin application.
-
Replace the <param-value> value with
/new-context-path/aos to update the context parameter
with the new context path. The example shows the default values in the
WEB-INF/web.xml file:
<context-param> <param-name>org.alfresco.enterprise.repo.officeservices.dispatch.SERVICES</param-name> <param-value>/alfresco/aos</param-value> <description>A space separated list of url-encoded context paths of SharePoint protocol enabled applications (e.g. SkyVault Content Services, SkyVault Office Workdesk)</description> </context-param>
- Repack the contents of the _vti_bin application into a _vti_bin.war file and deploy it.
-
Unpack ROOT.war and edit the index.jsp file
to set the context path:
Change /SkyVault to /new-context-path:
if(request.getMethod().equals("PROPFIND") || request.getMethod().equals("OPTIONS")) { ServletContext SkyVaultContext = application.getContext("/alfresco"); ... }
- Repack the contents of ROOT.war and deploy it.
-
Update the Solr 4 or Solr configuration to specify the new context path:
If you are using Solr 4, modify the following files:
solr4/workspace-SpacesStore/conf/solrcore.properties solr4/archive-SpacesStore/conf/solrcore.properties
If you are using Solr, modify the following files:solr/workspace-SpacesStore/conf/solrcore.properties solr/archive-SpacesStore/conf/solrcore.properties
to specify the properties relevant to your configuration:SkyVault.host=localhost alfresco.port=8080 alfresco.port.ssl=8443 alfresco.baseUrl=/SkyVault
Deploying with a reverse proxy
Follow this guidance if you want to run SkyVault Content Services with a reverse proxy.
If the reverse proxy maps the target server to a different context path, or if you
deployed specifically to a different context path, you need to follow the steps in Deploying with a different context path, with the following changes:
-
In step 2, update the values in the
SkyVault-global.properties file:
SkyVault.context=xxx alfresco.host=xxx alfresco.port=xxx alfresco.protocol=xxx
where xxx are the externally visible context, host name, port number and protocol values. - You must specify the context path that is externally visible in all steps, and not the context path that the repository is actually running on. Exceptions are in step 1 and in step 3 if Share is connecting to the repository directly and not through the reverse proxy. The other exception is in step 7 if Solr or Solr 4 is contacted directly and not through the reverse proxy.