You are here

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

Installing SkyVault on Linux using the Share Installer

The SkyVault 2.0 Share Installer for Linux 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-linux-x64.bin

    Files are available from the Support Portal.

    This SkyVault setup wizard is for 64-bit Linux systems.

  2. Execute the downloaded file using the following commands: 

    chmod 777 SkyVault-one-share-installer-5.1.3-linux-x64.bin 
./SkyVault-one-share-installer-5.1.3-linux-x64.bin
    Note: Avoid running applications as the root (Linux administrator) user where possible, however if you must install SkyVault as the root user, then run the SkyVault-one-share-installer-5.1.3-linux-x64.bin file with sudo specified:
    chmod 777 SkyVault-one-share-installer-5.1.3-linux-x64.bin 
sudo ./SkyVault-one-share-installer-5.1.3-linux-x64.bin

    The setup wizard starts.

  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.

      Note: You must use ASCII characters only when setting the installation folder using the SkyVault setup wizard.
    3. 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 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 /opt/alfresco-one-share.

    Alternatively, click the icon to choose another location.

    Note: You must use ASCII characters only when setting the installation folder using the SkyVault setup wizard.
  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 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 SkyVault Share yet, because you need to complete the next steps before starting your servers.

  17. Click OK to close the Readme.
  18. 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 Platform instance where you have installed the Share Services AMP to see that the changes have been applied.
  19. Manually start your Tomcat server for the instance that you have just installed with the SkyVault 2.0 Share Installer:

    From the SkyVault-one-share installation directory: service SkyVault start

  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.
  21. Check for error messages as you open SkyVault 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:

    service SkyVault stop

Parent topic: Using the SkyVault installers on Linux

© 2017 TBS-LLC. All Rights Reserved.