Moving to another server

Contents...

Moving to another web-hosting server and preserving its URL

  1. Copy all files and directories of the framework and installed applications from the current server to the appropriate directory of the target server.
  2. Delete all contents of directory wa-cache/ on the target server.
  3. Upon transfer, set permissions for files and directories so that the operating system user running the web server process is allowed to overwrite them (it is necessary for correct installation of software updates).
  4. Copy the database:
    1. Using a database management tool in your current web-hosting account's control panel, export the framework's database and save it as a file.
    2. Create a new database in the target web-hosting account and import previously exported database dump file into this new database.
    3. Edit framework configuration file wa-config/db.php on the target server by specifying correct connection credentials valid for the newly created database.
  5. Set up a domain zone in target web-hosting account's control panel so that your domain name points to web server's document root directory.
  6. Enter addresses of DNS servers of the target web hosting in your domain name's settings (on the registrar's website). Upon update of DNS-related data for your domain name (it may take from several minutes to several hours) framework-based applications will become available on the target web-hosting server.

Moving framework from subdirectory to domain root

Method 1

  1. Change your domain name's DNS zone settings (in your web-hosting account's control panel) so that the domain names points to the subdirectory with installed Webasyst framework. It is not necessary to move framework files to domain root directory.
  2. In "Site" app settings remove subdirectory name in field "Site URL" by leaving only a domain name URL.

Method 2

  1. Move all files of the framework and installed applications from the subdirectory to the domain root directory. For correct functioning of the framework there should be no extra files in the root directory.
  2. Upon transfer, set permissions for files and directories so that the operating system user running the web server process is allowed to overwrite them.
  3. In "Site" app settings remove subdirectory name in field "Site URL".
To move framework files from the root directory to a subdirectory, use the same procedure.

Moving installed framework to another domain name

  1. Enter addresses of DNS servers of your web hosting in the target domain name's settings (on the registrar's website).
  2. In your web-hosting account's control panel, create a DNS zone for the target domain name so that it points to the directory where Webasyst framework is installed.
    If the target domain name points to a different web-hosting server, then copy framework files and database as described in section "Moving framework to another web-hosting server and preserving its URL" above.
  3. Log into the "Site" app's backend on the target domain name and change the domain name in the "Site URL" settings field.