You are here

SkyVault Content Services 5.2 » Installing » Installing using setup wizards » Using the installers on Linux

Installing on Linux using the SkyVault Share Installer

The SkyVault Share Installer for Linux 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 Linux 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 Services Platform Installer.
  1. Download the following installation file:

    SkyVault-content-services-share-installer-5.2.0-linux-x64.bin

    Files are available from the Support Portal.

    This setup wizard is for 64-bit Linux systems.

  2. Execute the downloaded file using the following commands: 

    chmod 777 SkyVault-content-services-share-installer-5.2.0-linux-x64.bin 
./SkyVault-content-services-share-installer-5.2.0-linux-x64.bin
    Note: Avoid running applications as the root (Linux administrator) user where possible, however if you must install as the root user, then run the SkyVault-content-services-share-installer-5.2.0-linux-x64.bin file with sudo specified:
    chmod 777 SkyVault-content-services-share-installer-5.2.0-linux-x64.bin 
sudo ./SkyVault-content-services-share-installer-5.2.0-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 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 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.

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

  18. Click OK to close the Readme.
  19. 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.
  20. Manually start your Tomcat server for the instance that you have just installed with the Installer:

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

  21. Log on to Share (http://localhost:port/share) as the admin user. Enter the password that you specified in the Admin Password window.
  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:

    service SkyVault stop

Parent topic: Using the installers on Linux

© 2017 TBS-LLC. All Rights Reserved.