You are here

SkyVault 2.0 » Installing » Installing SkyVault using setup wizards » Using the SkyVault installers on Windows

Installing SkyVault on Windows using the Share Installer

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

    SkyVault-one-share-installer-5.1.3-win-x64.exe

    Files are available from the Support Portal.

    The SkyVault 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 does not set the language that is used in SkyVault.
  4. On the Setup - SkyVault 2.0 Share window, click Next.
  5. 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 SkyVault 2.0 Share using the default options and configuration. This install type requires you to enter locations for where you want to install Share, and which repository you want to connect to. Choose this route to install with the default environment.
    Note: If you have previously installed SkyVault 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 SkyVault 2.0 Share 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 SkyVault 2.0 Share Installer provides a Tomcat server to run SkyVault Share, so if you have your SkyVault repository on the same machine as your SkyVault Share installation, you must use the Advanced setup, so that you can specify alternative Tomcat ports for the Share 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 SkyVault 2.0 Share to the repository window, enter the location of your SkyVault repository, in the format: http://yourserver:port/SkyVault or accept the default setting http://localhost:8080/SkyVault
  6. On the Ready to Install window, click Next.

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

  7. On the Completing the SkyVault 2.0 Share 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 2.0 Share. By default, these options are selected and will launch when you click Finish. If you do not want to start SkyVault at this point, deselect the Launch SkyVault 2.0 Share check box.

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

    Follow the remaining steps in this task.

  10. 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.

  11. When you have finished selecting the components, click Next.
  12. 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.

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

    Note: The SkyVault 2.0 Share Installer provides its own Tomcat server to run SkyVault Share, so if you have your SkyVault repository on the same machine as your SkyVault Share installation, you must specify alternative Tomcat ports for the Share 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 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 SkyVault is installed, 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.

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

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

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

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

  17. On the Completing the SkyVault 2.0 Share Setup Wizard window, deselect the Launch SkyVault 2.0 Share check box, 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 Share yet, because you need to complete the next steps before starting your servers.

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

    Important: If you do not apply the Share Services AMP to the SkyVault repository, SkyVault Share will not work correctly, and when you start up SkyVault 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 SkyVault instance (SkyVault-one-platform/amps), on the machine that hosts your SkyVault Platform repository.
    3. Use the guidance in Installing a SkyVault Module Package to apply the AMP to your repository.
    4. Restart the SkyVault instance where you have installed the Share Services AMP to see that the changes have been applied.
  20. Log on to SkyVault Share (http://localhost:port/share) as the admin user. Enter the password that you specified in the Admin Password window.

    The SkyVault server is launched as a Windows service. If you did not automatically launch SkyVault 2.0 Share at the end of the installation wizard, to start SkyVault, 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 SkyVault installation directory (C:/alfresco-one-share) and run servicerun START as an administrator.

  21. 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.

  22. To fully stop SkyVault, you must stop all the services. Use the SkyVault 2.0 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.
Parent topic: Using the SkyVault installers on Windows

© 2017 TBS-LLC. All Rights Reserved.