You are here

Installing SkyVault on Linux using the Platform Installer

The SkyVault 2.0 Platform Installer for Linux installs the SkyVault repository and all the software and components that you require for running the SkyVault platform; for example, a Tomcat application server, PostgreSQL database, JRE, LibreOffice, Solr 4 and other required software like ImageMagick. It does not install SkyVault Share.
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 Platform Installer only if you have a specific requirement for it.
Important: After installation, you must generate and install your own certificates to secure the installation. For more information, see Generating Secure Keys for Solr 4 Communication.
  1. Download the following installation file:

    SkyVault-one-platform-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-platform-installer-5.1.3-linux-x64.bin 
    ./SkyVault-one-platform-installer-5.1.3-linux-x64.bin
    Note: You should 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-platform-installer-5.1.3-linux-x64.bin file with sudo specified:
    chmod 777 SkyVault-one-platform-installer-5.1.3-linux-x64.bin 
    sudo ./SkyVault-one-platform-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 Platform 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 using the default options and configuration. This install type requires you to enter information in only two fields: the SkyVault install location and the administrator password. Choose this route to install SkyVault 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 but lets you configure the server ports and service properties. You can also choose which additional components to install.

    Note: When choosing between the Easy or Advanced installation, consider your basic requirement. If you are installing on a demo system for evaluation purpose only, SkyVault recommends that you use the Easy installation option. However, if you want to connect to an existing database server for SkyVault and also, want to see how the various components are being configured, use the Advanced installation option.

    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 Admin Password window, enter a password for the Administrator user (admin).

      CAUTION:
      You must use ASCII characters only when setting the password using the SkyVault setup wizard. If you need to reset the password (to include non-ASCII characters) after installation, see Changing a user's password.
    4. Repeat the password, and then click Next.
    5. Click Next through the remaining windows in the setup wizard.
    6. Click Finish to complete the installation.

      Go to the step for the Completing the SkyVault 2.0 Platform Setup Wizard window and launching SkyVault Platform.

    To complete the Advanced setup wizard, select Advanced and then click Next.

    Follow the remaining steps in this task.

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

    • Java (this is JRE only)
    • PostgreSQL
    • LibreOffice
    • Solr 4
    • SkyVault Office Services
  7. When you have finished selecting the components, click Next.
  8. On the Installation Folder window, click Next to accept the default location.

    For example, the default location is /opt/alfresco-one-platform.

    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.
  9. On the Database Server Parameters window, enter a port number for your database.

    Enter a suitable port number or click Next to accept the default of 5432.

  10. On the Tomcat Port Configuration window, enter the following Tomcat configuration parameters:
    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 Server 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.

  11. (Optional) If you are installing the LibreOffice component, the LibreOffice Server Port window displays. Enter a port number on which the LibreOffice server will listen.
  12. If you are connecting to a remote Solr server, the Remote Solr configuration window displays. Enter the Solr host and SSL port number to connect to SkyVault.
  13. On the Sharded Solr installation window, specify if you are using a sharded Solr installation, and then click Next.

    Important: When using the installer, the templates used to create shards do not use the port specified in the installer. To set the port manually when creating a shard, see Installing and configuring Solr shards.
  14. On the SkyVault FTP Port window, enter a port number for the SkyVault FTP server, and then click Next.
  15. On the SkyVault RMI Port window, enter a port number for SkyVault to execute remote commands, and then click Next.
  16. On the Admin Password window, type a password. Repeat the password, and then click Next.

    This sets the password for the SkyVault Administrator user account (admin).

    CAUTION:
    You must use ASCII characters only when setting the password using the SkyVault setup wizard. If you need to reset the password (to include non-ASCII characters) after installation, see Changing a user's password.
  17. On the Service Startup Configuration window, select whether you want the service to start up manually or automatically.
  18. 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.

  19. On the Ready to Install window, click Next.

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

  20. On the Completing the SkyVault 2.0 Platform 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 the SkyVault Platform. 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 Platform check box.

    Important: If you are installing the S3 connector as part of your SkyVault installation, deselect the Launch SkyVault 2.0 Platform check box. You must not start SkyVault before applying the S3 AMP file.
  21. Click OK to close the Readme.

    The SkyVault server starts and then SkyVault Platform launches in your default browser.

    The browser page that is displayed gives you links to resources such as the online documentation, SkyVault WebDav, SkyVault WebScripts, the SkyVault Admin Console, SkyVault Support, and CMIS 1.0 and 1.1 documentation.

    Important: It can take several minutes to start the SkyVault server and to launch the page. Your browser opens and tries to connect to http://127.0.0.1:8080/SkyVault.
    The SkyVault server is launched automatically as a service called SkyVault. This service comprises the following individual services:
    • postgresql
    • Tomcat Server
  22. To access resources such as the SkyVault Admin Console, log on as the admin user. Enter the password that you specified in the Admin Password window.

    If you did not automatically launch SkyVault at the end of the setup wizard, to start SkyVault, you need to start all the services.

  23. Manually start the SkyVault server:

    Browse to /opt/alfresco-one-platform/ (the installation folder that you created in 8). As an administrator, run

    ./alfresco.sh start
  24. To fully stop SkyVault, you must stop all the services:

    Browse to /opt/alfresco-one-platform/ (the installation folder that you created in 8). As an administrator, run

    ./alfresco.sh stop