LoginLogin About

Support » Knowledge Base » Installing and updating software »

Installation on a remote UNIX server

Detailed instructions on how to install WebAsyst on a remote web-hosting (or your own) server with UNIX/Linux/FreeBSD

Note: For successful installation and correct operation of WebAsyst the server configuration must satisfy the system requirements.

1. Preparing for installation

Installation of WebAsyst on a remote server will require the following:

  • a WebAsyst distribution archive;
  • virtual hosting or a private/dedicated server;
  • an archiver capable of extracting archive files of type TAR.GZ (e.g. WinRAR or 7-Zip);
  • an FTP client (e.g., FileZilla or CuteFTP);
  • FTP connection credentials (server name, user name, password), they can be obtained from the web-hosting company or set up in your web-hosting control panel.
  1. Download the WebAsyst distribution archive from your WebAsyst Customer Center. Use your email address and a password to log in — that information was automatically sent to you after the purchase of WebAsyst scripts. Upon login go to section "Download" and click the "Download" button. Then download a file named webasyst_setup.tar.gz to any folder on your computer. This is a double TAR.GZ archive which contains WebAsyst installation files.
  2. Unpack the webasyst_setup.tar.gz archive twice using any suitable archiver, e.g., 7zip or WinRAR. After unpacking a folder named webasyst_setup should appear on your computer, which will contain files install.php, wbs.tgz, as well as other files and subfolders.

2. Uploading files to server

Extracted files and subfolders must be uploaded to the remote server by means of an FTP client, e.g., FileZilla.

In order to upload files to the server of a web hosting provider it is necessary to obtain FTP connection credentials from the provider. Those credentials should be used to set up an FTP connection with your FTP client. For detailed instructions on setting up an FTP connection and uploading files to a remote server refer to the user manual of your FTP client.
Note: Some FTP clients use their default settings to convert the names of uploaded files to the lower case, i.e. instead of file FILE.php you may upload a file named file.php. For correct functioning of WebAsyst, the case of characters in the file names should not be changed! Before uploading files to a remote server, please ensure that this setting (if available in a particular FTP client) is disabled.

Determine the server directory where WebAsyst files should be uploaded. For that, you should know the path to the domain root directory. It is always server-specific and can be obtained from the server administrator. Below is provided a list of the most frequently encountered names of domain root directories:

  • htdocs
  • http
  • httpdocs
  • public_html
  • www

If the WebAsyst installation URL contains only the domain name (e.g., http://domain.com/), then WebAsyst should be installed in the domain root directory (e.g., public_html/).

If the WebAsyst installation URL should contain the name of a subdirectory (e.g., http://domain.com/new/), then create a subdirectory in the domain root directory (e.g., new/) and install WebAsyst in that subdirectory (in this example public_html/new/).

Assign the maximum allowed permissions for the directory where WebAsyst would be installed. The permission values that are usually sufficient for correct installation of WebAsyst are 777, 775 or 755. The maximum permission value allowed for your server can be obtained from the server administrator prior to the installation or determined experimentally during the installation process.

Permissions for the installation directory can be changed either by means of an FTP client or using a control panel file manager. Please refer to the user manual of your FTP client for detailed instruction on changing permissions of server directories. In case of using the control panel file manager use the web hosting provider knowledge base or contact the provider's support team.

The WebAsyst installation directory should be emptied before installation to avoid conflict with previously installed web applications.

Upload the contents of the unpacked archive webasyst_setup.tar.gz to the WebAsyst installation directory via FTP.

3. WebAsyst installation wizard (install.php)

Once all files have been uploaded enter the URL of file install.php in your browser to start the WebAsyst installation wizard as described below:

  • If the contents of distribution archive were uploaded in the domain root directory, then the URL of file install.php should have the form http://YOUR_DOMAIN/install.php, e.g., http://domain.com/install.php.
  • If the contents of distribution archive were uploaded into a subdirectory inside the domain root directory, then the URL of file install.php should have the form http://YOUR_DOMAIN/SUBDIRECTORY/install.php, e.g., http://domain.com/new/install.php.
  1. After you have entered the URL of file install.php the browser will open the starting page of the WebAsyst installation wizard titled "License Agreement" with the text of the license agreement. Read the agreement carefully. If you agree with its terms and conditions, check the "I understand and accept terms and conditions of this License Agreement." option and click on "Continue >>". The installation wizard will go to page "System requirements".
  2. Page "System requirements" contains diagnostic information on compliance of the server configuration with the system requirements which must be satisfied for the installation of WebAsyst.

    If some of the obligatory requirements are not satisfied, change the configuration of the server accordingly and refresh the currently open page of the installation wizard (alternatively, you may re-run file install.php from step 1).

    If all system requirements are satisfied, click on the "Continue >>" button. The installation wizard will go to page "Extract WebAsyst files".

  3. On page "Extract WebAsyst files" you will be offered to choose the installation method: automatic or manual. Choose automatic installation and click on "Continue >>". The installation wizard will go to page "Extracting files...".
    In most cases it is recommended to perform automatic installation. This is a standard installation method recommended by the developers of WebAsyst. Should the automatic installation fail on the file extraction step due to server performance limitations, WebAsyst still can be installed manually as described at the end of this installation guide.
  4. Page "Extracting files..." contains a files extraction process indicator which displays the degree of extraction in percents. At this step archive file wbs.tgz is automatically unpacked. The extraction of files takes from 1 to 5 minutes depending on the performance of the server and the size of the distribution archive (i.e. the number of WebAsyst applications being installed). Upon completion of files extraction the installation wizard will go to page "Creating Database".
  5. On page "Creating Database" it is necessary to specify MySQL connection details and other parameters.

    MySQL parameters

    MySQL Host: this value should be obtained from the web hosting provider or the server administrator. Quite often default value localhost is used.
    MySQL User Name and Password: these values are either provided by the web hosting provider or configurable in the web hosting control panel.

    Choose the database for WebAsyst data

    Use existing database (recommended option). Before setting up the connection to the MySQL server using this option, create a database on the server and grant a MySQL user all privileges to that database. A MySQL user can be configured by means of the web hosting control panel.
    Create new database: using this option is recommended to experienced users only as the installation might fail should the MySQL user have insufficient privileges for creation of new databases.

    System Settings

    Relative path to WebAsyst installation dir: this field contains an automatically generated relative path to the WebAsyst installation directory.

    The relative path to the installation directory contains the names of the subdirectories added to the domain name to form the full URL of WebAsyst as explained below:

    • if WebAsyst is being installed into the domain root directory, this field should contain a single slash character /;
    • if the WebAsyst installation URL contains the name of a subdirectory and has the form http://domain.com/new/, then field "Relative path to WebAsyst installation dir" should contain a value of kind /new/.
    Note: manually changing this value is only necessary if it was incorrectly generated. Otherwise it should be left unchanged.

    Main user

    Enter the main user's details in text fields:

    Login: only Latin letters, digits, hyphen and underscore characters are allowed.
    Password: the password should be at least 4 characters long, any characters are allowed.
    Email: enter a valid email address where WebAsyst will send system notification, e.g. installation notification or password reminders.
    First Name, Last Name, Company: Latin letters and digits are allowed.

    Upon entering all data check if they are correct and click on "Continue >>". If you have entered correct data, the installation wizard will go to the final page titled "Success!".

  6. Page "Success!" contains a summary of the access information to the WebAsyst account and the WebAsyst Installer. It is recommended to print out this page to save the access information for further reference. To complete the installation, enter the WebAsyst account on behalf of the main user. Click on the hyperlink at the page top labeled "This is a main form to login to your WebAsyst account".
  7. On the WebAsyst login page you need to enter the main user's login and password and click on "Login". Upon successful login to the account the installation of WebAsyst is considered completed. To begin using WebAsyst applications, log in to the main user's account.

4. Protecting WebAsyst after installation

After the installation WebAsyst should be protected from unauthorized access. Such a protection involves the following actions:

  1. Remove the following files and directories from the server upon completion of the installation. They are not required for further operation of WebAsyst.
    • help/
    • i2/
    • includes/
    • .state.tar.tmp
    • .state.tar.tmp.log
    • access
    • ajaxhandler.php
    • domxml-php4-to-php5.php
    • install.css
    • install.js
    • install.log
    • install.php
    • license.txt
    • readme.txt
    • settings.xml
    • setupguide.htm
    • showdblist.php
    • showmucontent.php
    • update.xml
    • wbs.tgz
  2. Protect WebAsyst Installer with a password. To do so, go to a URL of the form http://WEBASYST_INSTALLATION_URL/installer/ (e.g., http://domain.com/installer/), enter desired values in fields "Login", "Password" and "Confirm password" and click on the confirmation button.

    Fields "Password" and "Confirm password" must contain equal values, otherwise protection will not be installed. In case of successful protection setup the login and password fields on red background will disappear from the main page of WebAsyst Installer.

    Entering a login name and a password will be required for subsequent logons to WebAsyst Installer. Remember those data and keep them in secret.
  3. Additionally protect directory published/wbsadmin/ (WebAsyst Installer) using a .htpasswd file.

  4. The contents of the directories listed below should be protected from direct access via the HTTP protocol (i.e. using a browser):
    • data/
    • dblist/
    • kernel/
    • system/
    • temp/
    Limiting access to server directories should be performed by means of the web server. In case of using Apache as the web server those directories should contain a .htaccess file with the following directive:
    Deny from all
  5. Assign permissions to WebAsyst files and directories that should allow only authorized users of the operating system to access and modify their contents. Exact permission values depend on the current server configuration and the purpose of each specific file or directory. For correct permissions setup apply to your system administrator. Below are provided common recommendations on setting up access permissions.
    • The web server should be allowed to rewrite contents of the following directories (and the files contained in them):
      • data/ (and subdirectories)
      • dblist/
      • kernel/
      • kernel/includes/smarty/compiled/ (and subdirectories)
      • published/publicdata/ (and subdirectories)
      • published/.../localization/ (ellipsis stands here for the names of the directories containing subdirectory named /localization)
      • temp/
    • Access by the web server to all other files and directories is sufficient in the read-only mode.
    • Should you need to modify files through FTP, the FTP user should be granted corresponding access rights.
    • Automated software update using WebAsyst Installer requires that the web server must have full rights to all WebAsyst files and directories. Upon completion of the update permission values can be restored to their normal values described above in this section.

Manual installation

Note: WebAsyst should be installed manually only if automatic installation routine fails.
  1. Download the WebAsyst distribution archive from your WebAsyst Customer Center and unpack it as described above in section "Preparing for installation". After the unpacking a folder named webasyst_setup containing files install.php, wbs.tgz and other files and subfolders should appear on your computer.
  2. Unpack archive wbs.tgz, too. After the unpacking additional subdirectories should appear in the directory with WebAsyst files, e.g. kernel, published, system and others.
  3. Upload all files and directories extracted from archives webasyst_setup.tar.gz and wbs.tgz to the remote server via FTP as described above in section "Uploading files to the server".
    In case of manual installation it is not necessary to upload file wbs.tgz.
  4. Enter the URL of file install.php to start the WebAsyst installation wizard as described above in section "WebAsyst installation wizard (install.php)" and follow the instructions of the wizard till step "Extract WebAsyst files".
  5. On step "Extract WebAsyst files" choose "Manual installation" and click on "Continue >>". The installation wizard will display a page with instructions on manual installation.
  6. Carry out all items of the instructions and click on "Continue >>". The installation wizard will check whether all instructions have been fulfilled correctly and go to page "Creating Database" if everything was done as required.
  7. On page "Creating Database" you need to enter MySQL connection details and other parameters as well as complete the installation as described above in section "WebAsyst installation wizard (install.php)".

After manual installation WebAsyst should be protected from unauthorized access in the same manner as described above in section "Protecting WebAsyst after installation".