You are here

Troubleshooting the installation

Follow these tips if you see error messages when using the SkyVault Share Installer.
Note: The SkyVault Content Services Installer is recommended for most purposes. See Installing on Linux using the SkyVault Content Services Installer for more information. These tips help troubleshoot problems found in SkyVault Share, when you have used the SkyVault Share Installer (see Installing on Linux using the SkyVault Share Installer for more information). Use this installer only if you have a specific requirement for it.
  1. Start SkyVault Content Services and log on to SkyVault Share (http://localhost:port/share) as the admin user. Enter the password that you specified in Installing on Linux using the SkyVault Share Installer in the Admin Password window.
  2. Check for error messages as you start Share.
  3. If you see the following message:

    SkyVault Content Services is running without Share Services. See your System Administrator for more details

    then check the Admin Console to determine which AMP files have been installed, and their versions. It might be that either you have not installed the Share Services AMP in the repository (see Installing on Linux using the SkyVault Share Installer or Installing on Windows using the SkyVault Share Installer), or the version of the AMP that you have installed is not correct.

  4. If you see the following message:

    Invalid MANIFEST.MF: Share Specification-Version is missing, are you using the valid
          MANIFEST.MF supplied with the Share.war? 
    check that you have not deleted or changed the MANIFEST.MF file. The MANIFEST.MF file shipped with the Share.war is required for validation, and SkyVault Share will not work correctly if this cannot be read.

    If you are using a Maven WAR build, this will override the shipped MANIFEST.MF file. When you unpack your WAR file, you will need to specify unpack-dependencies explicitly, for example:

    <plugin> 
      <artifactId>maven-dependency-plugin</artifactId> 
      <executions> 
        <execution> 
          <id>unpack</id> 
          <phase>generate-sources</phase> 
          <goals> 
            <goal>unpack-dependencies</goal> 
          </goals> 
          <configuration> 
            <includeTypes>war</includeTypes> 
            <includeGroupIds>org.alfresco</includeGroupIds> 
            <includeArtifactIds>share</includeArtifactIds> 
            <includes>META-INF/MANIFEST.MF</includes> 
          </configuration> 
        </execution> 
      </executions> 
    </plugin> 
    
    <plugin> 
      <artifactId>maven-war-plugin</artifactId> 
      <configuration> 
        <archive> 
          <addMavenDescriptor>false</addMavenDescriptor> 
          <manifestFile>${project.build.directory}/dependency/META-INF/MANIFEST.MF</manifestFile> 
        </archive> 
        <webResources> 
        </webResources> 
      </configuration> 
    </plugin>