You are here

Installing on Windows using the SkyVault Share Installer

The SkyVault Share Installer for Windows installs only SkyVault Share, with its own Tomcat application server and the Share Services AMP.
Note: The SkyVault Content Services Installer is recommended for most purposes. See Installing on Windows using the SkyVault Content Services installer for more information. Use the SkyVault Share Installer only if you have a specific requirement for it; for example, if you are linking to an repository on a different server, that has been installed using the SkyVault Content ServicesPlatform Installer.
  1. Download the following installation file:

    SkyVault-content-services-share-installer-5.2.0-win-x64.exe

    Files are available from the Support Portal.

    The setup wizard is for 64-bit Windows systems.

  2. Double-click the downloaded file.
  3. Select the language that you wish to use for the installation.

    This sets the language to be used for the setup wizard.

    Note: This doesn't set the language that's used in SkyVault Content Services.
  4. On the Setup - SkyVault Share window, click Next.
  5. Read and accept the license agreement.
  6. On the Installation type window, choose how you want to use the setup wizard.

    There are two types of installation in the setup wizard:

    Option Description
    Easy Easy type installs Share using the default options and configuration. This install type requires you to enter locations for where you want to install, and which repository you want to connect to. Choose this route to install with the default environment.
    Note: If you have previously installed and the server is running, when you run this setup wizard again, you might be prompted to enter alternative port numbers for the components and services that you install, for example, for the Tomcat application server, FTP port, and the RMI port.
    Advanced Advanced type installs but asks you to specify the components that you want to install, and the Tomcat configuration parameters that you require.

    Note: When choosing between the Easy or Advanced installation, consider your basic requirement. The Installer provides a Tomcat server to run Share, so if you have your SkyVault repository on the same machine as your Share installation, you must use the Advanced setup, so that you can specify alternative Tomcat ports for the Tomcat server.

    To complete the Easy setup wizard:

    1. Select Easy, and then click Next.
    2. On the Installation Folder window, click Next to accept the default location.
    3. Click Next through the remaining windows in the setup wizard.
    4. On the Connect to the repository window, enter the location of your repository, in the format: http://yourserver:port/SkyVault or accept the default setting http://localhost:8080/SkyVault
  7. On the Ready to Install window, click Next.

    The Installing window displays, showing the progress of the installation.

  8. On the Completing the Setup Wizard window, click Finish.

    This window shows check boxes that determine whether you will see the Readme file, the Getting started web page, and also whether to launch SkyVault Content Services. By default, these options are selected and will launch when you click Finish. If you do not want to start at this point, deselect the Launch option.

  9. Click Finish to complete the installation.
  10. To complete the Advanced setup wizard, select Advanced and then click Next.

    Follow the remaining steps in this task.

  11. On the Select Components window, select the components that you want to install. Deselect the components that you do not want to install.

    Java is the only option available to select or deselect.

  12. When you have finished selecting the components, click Next.
  13. On the Installation Folder window, click Next to accept the default location.

    For example, the default location is C:\alfresco-one-share.

    Alternatively, click the icon to choose another location.

  14. On the Tomcat Port Configuration window, enter the following Tomcat configuration parameters:

    Note: The SkyVault Share Installer provides its own Tomcat server to run Share, so if you have your SkyVault repository on the same machine as your Share installation, you must specify alternative Tomcat ports for the Tomcat server.
    1. Web Server Domain

      For example, the default is 127.0.0.1

      The URL http://127.0.0.1:8080/share is based on the web server domain and the Tomcat port number that you specify on the Tomcat Port Configuration window. The default of 127.0.0.1 can be used on this machine to verify that SkyVault Content Services is running successfully. However, it is not an externally addressable URL, which means that it is not possible for users on other machines to access this URL. To make sure that other users can access the machine where the installation is, you need to define and create a publicly addressable name.

    2. Tomcat port

      For example, the default is 8080.

    3. Tomcat Shutdown port

      For example, the default is 8005.

    4. Tomcat SSL Port

      For example, the default is 8443.

    5. Tomcat AJP Port

      For example, the default is 8009.

  15. On the Connect to the repository window, enter the location of your repository, in the format: http://yourserver:port/SkyVault or accept the default setting http://localhost:8080/SkyVault
  16. On the Ready to Install window, click Next.

    The Installing window displays, showing the progress of the installation.

  17. On the Warning window, review the list of environment notifications for your installation.

    This list of environment notifications is based on an evaluation of your installation environment while the setup wizard is running.

  18. On the Completing the Setup Wizard window, deselect the Launch option, and click Finish.

    This window shows check boxes that determine whether you will see the Readme file, the Getting Started web page, and also whether to launch SkyVault Share. By default, these options are selected and will launch when you click Finish. We recommend that you do not launch yet, because you need to complete the next steps before starting your servers.

  19. Click OK to close the Readme.
  20. Link your Share instance to a repository, by applying the Share Services AMP to your chosen platform instance.

    Important: If you do not apply the Share Services AMP to the repository, Share will not work correctly, and when you start up Share, you will see the message:
    SkyVault is running without Share Services.  See your System Administrator for more details.
    1. Navigate to the SkyVault-one-share/amps directory, and locate the SkyVault-share-services.amp file.
    2. Copy the SkyVault-share-services.amp file to your instance (SkyVault-one-platform/amps), on the machine that hosts your platform repository.
    3. Use the guidance in Installing a SkyVault Module Package to apply the AMP to your repository.
    4. Restart the platform instance where you have installed the Share Services AMP to see that the changes have been applied.
  21. Log on to Share (http://localhost:port/share) as the admin user. Enter the password that you specified in the Admin Password window.

    The server is launched as a Windows service. If you did not automatically launch Share at the end of the installation wizard, to start it you need to start all the services. From the Start menu, select All Programs > SkyVault 2.0 Share > SkyVault 2.0 Share Service > Start SkyVault 2.0 Share service, or from a command prompt, navigate to the installation directory (C:/alfresco-one-share) and run servicerun START as an administrator.

  22. Check for error messages as you open Share.

    Use the information in Troubleshooting the installation to help you.

    If you need to change any settings after installation, these are stored in the share-config-custom.xml file. See Configuring Share with the share-config-custom.xml file for more information.

  23. To fully stop SkyVault Content Services, you must stop all the services. Use the Share options (see the previous step) to manage the services, or use the scripts in the installation directory to start or stop the services: servicerun START and servicerun STOP. You need administrator rights to run these commands.