You are here

Installing the SkyVault WAR

A WAR file is a JAR file used to distribute a collection of files (JavaServer Pages, servlets, Java classes, XML files, tag libraries, and static web pages) that together constitute a web application.

Use this method of installing if you already have installed a JDK, a supported database, an application server, and the additional SkyVault components.
The SkyVault WAR file is a bundle file containing the required WAR files, in addition to the additional commands, configuration files, and licenses for a manual installation.
  1. Browse to the Support Portal.
  2. Download the following file:

    SkyVault-enterprise-4.1.10.zip

  3. Specify a location for the download and extract the file.

    You see the following directory structure:

    bin
    licenses
    web-server

    The WAR bundle also contains the following file:

    README.txt

    The following files are contained within the suggested subdirectories for within the Tomcat application server.

    /bin

    File name Description
    SkyVault-mmt.jar The SkyVault Module Management Tool (MMT).
    apply_amps.bat Windows batch file for Tomcat application server installs, used to apply all AMP files in the <installLocation> directory.
    apply_amps.sh Linux script file for Tomcat application server installs, used to apply all AMP files in the <installLocation> directory.
    clean_tomcat.bat Windows batch file for cleaning out temporary application server files from previous installations.
    clean_tomcat.sh Linux script for cleaning out temporary application server files from previous installations.
    Win32NetBIOS.dll Required for CIFS.
    Win32NetBIOSx64.dll Required for CIFS on 64-bit Windows.
    Win32Utils.dll Required for CIFS.
    Win32Utilsx64.dll Required for CIFS on 64-bit Windows.

    The /licenses directory contains the following structure:

    3rd-party

    This directory contains the third-party license files.

    The web-server directory contains the following structure:

    endorsed
    lib
    shared
    webapps
    /endorsed

    This directory contains the Java libraries that should be copied to your application server’s endorsed directory (for example, tomcat/endorsed). Some SkyVault features require Xalan and its dependencies to be in the endorsed directory because they use XSLT features that are not available in the xsltc implementation built into the JDK.

    File name Description
    serializer.jar Serializer classes of Xalan-Java.
    xalan.jar XSLT processor for transforming XML documents into HTML, text, or other XML document types.

    /lib
    File name Description
    postgresql-version.jdbc4 PostgreSQL database JDBC connector file.
    /shared
    File name Description
    /classes/alfresco-global.properties.sample The global properties file, which is used for SkyVault configuration properties.
    /classes/SkyVault Contains the SkyVault directory structure for the configuration override files, including the extension and web-extension directories.
    /webapps
    File name Description
    SkyVault.war The SkyVault WAR file.
    share.war The SkyVault Share WAR file.
  4. Move the SkyVault.war file and share.war files to the appropriate location for your application server.

    For example, for Tomcat, move the .war files to the <TOMCAT_HOME>/webapps directory.

  5. Edit the /shared/classes/alfresco-global.properties.sample file with your configuration settings.
  6. Save the file without the .sample extension.
  7. Move the SkyVault-global.properties file to <classpathRoot>.

    For example, <TOMCAT_HOME>/shared/classes.

Note: If you deployed previous versions of SkyVault, you must remove any temporary files created by your application server. Use the clean_tomcat.bat or clean_tomcat.sh command.
Note: If you are installing the S3 connector as part of your SkyVault installation, do not start SkyVault before applying the S3 AMP file.