How to migrate from one server to another
AXS has been designed to work as a platform-independent, path-independent script. In the vast majority of cases, you can simply make an ASCII FTP transfer of the "axs" folder from one server to the next, and everything will continue working. This should be true even if you transfer between Unix and Windows, or between different versions of Perl.
The following items may need to be changed:
-
Possible Changes to CGI File Extension
Some web servers require the "pl" extension; others require the "cgi" extension. Nice web servers allow either.
If you have the bad luck to transfer from a pl-only server to a cgi-only server, then you will have to rename the scripts to the appropriate extension. Files requiring the CGI file extension are:
- axs/ax.pl
- axs/ax-admin.pl
- axs/convert.pl
- axs/find_replace.pl
-
Possible Changes to Perl Path
Similarly, some servers require a specific Perl path on the first line of the script. The default, "#!/usr/bin/perl", should work for 99% of web servers.
If your old and new providers have different required paths, then you will need to update the first line of the scripts. Files requiring the Perl path are:
- axs/ax.pl
- axs/ax-admin.pl
- axs/convert.pl
- axs/find_replace.pl
-
File Permissions
Many web servers will require that you set the executable permissions on "ax.pl" and "ax-admin.pl", and that you set the writable permissions on the "axs.dat" and "log.txt" files.
Quick ways to do this are:
-
If you have shell access, run the "setperms.bat" file on Windows, or the "./setperms.sh" or "/bin/sh setperms.sh" commands on Unix. They should take care of everything.
-
Perform an Automated Install on the new server. The automatic install will reset all permissions to their proper values, without overwriting any of your existing customized data.
The slow way to reset permissions is to manually step from file to file with a chmod-capable FTP client and reset each file or folder as appropriate. The install document contains information on what permissions go with each file.
-
-
Updated Tracking Tags on All Pages
If AXS is installed at the same place on your new server -- like http://mysite.tld/axs/ax.pl -- then you will not need to change the AXS tracking tags in all of your HTML pages.
However, if you need to change the folder or file extensions when you migrate hosts, then you will need to update the AXS tracking tags in all HTML pages. This could happen if your new host requires a different extension, like ".cgi" instead of ".pl", or if your new host requires you to run all scripts from a "cgi-bin" folder.
"How to migrate from one server to another"
http://www.xav.com/scripts/axs/help/1023.html