ePages Patch Installation | → 6.17.48 | Created: 6.12.2; Updated: 6.17.36 |
Table of Contents
|
The patch 6.17.48 can only be applied to ePages 6.17.47.
The patch 6.17.48 works only on Linux, not on Windows.
The default MySQL database engine must be InnoDB. Check this by executing the SQL command 'SHOW ENGINES'.
In the MySQL configuration file (mostly /etc/my.cnf) option skip-networking must not be set to '1'. The default value is '0' so that you don't need to change a original configuration file.
If the ePages database server doesn't run, start it. Execute as Linux user root:
/etc/init.d/epages6 start_db
Stop all non-ePages applications (e.g. editors) that access files in directory $EPAGES.
IMPORTANT: Backup your data to be able to restore the initial state if the patch process fails or causes inconsistencies with customizations. The patch itself does not backup any data (neither databases nor files).
Patching requires internet connection to outside, at least HTTP and FTP clients must be able to download files from the internet.
Move all log files from $EPAGES_LOG/* to a backup directory.
If errors occur, stop the patch process, check the log file and contact ePages support. The log files are located in (HOSTNAME is the name of the machine):
$EPAGES_SHARED/Patches/var-patch_6_17_48/logs/HOSTNAME/*.log
In Linux execute the following steps as Linux user root.
Single server installations on Red Hat Linux may be patched by executing following commands:
rpm -hUv http://epages.com/repo/epages/yum/epages-release.noarch.rpm /var/epages/update-epages.sh --singlehost
Single server installations on Debian Linux may be patched by executing following commands:
curl -O http://www.epages.com/repo/epages/apt/epages-release_all.deb dpkg -i epages-release_all.deb apt-get -y update /var/epages/update-epages.sh --singlehost
A distributed ePages installation consists of multiple servers. Exactly one of them is the primary server (hereinafter called 'alpha server') and one or more secondary servers:
Execute the following steps as Linux user root.
On each server (one after the other, not parallel), run following commands for your operating system.
Run following commands:
rpm -hUv http://epages.com/repo/epages/yum/epages-release.noarch.rpm /var/epages/update-epages.sh --distributed
Run following commands:
curl -O http://www.epages.com/repo/epages/apt/epages-release_all.deb dpkg -i epages-release_all.deb apt-get -y update /var/epages/update-epages.sh --distributed
Run the following command on each secondary server:
echo "$(hostname)=beta" >> Conf/Hosts
Run the following commands on the alpha server:
echo "$(hostname)=alpha" >> Conf/Hosts ./patch.sh prepare
Run the following command on all secondary servers:
./patch.sh preinstall
Run the following command on the alpha server:
./patch.sh install
Run the following command on all secondary servers:
./patch.sh postinstall
Run following command on the alpha server:
./patch.sh reopen
The patch changes the configuration file $EPAGES_CONFIG/Scheduler.conf. Check after the patch if the changed values are correct for you.
You'll find the changes in following file:
Verify the log files of the patch process. The log files are located in (HOSTNAME is the name of the machine):
$EPAGES_SHARED/var-patch_6_17_48/logs/HOSTNAME/*.log
Beside the patch log files, the patch process writes errors as well into the ePages standard log files in $EPAGES_LOG/*. Verify log files in $EPAGES_LOG/* as well, especially file error.log. In error.log ignore following warning(s):
Can't connect to the MC at ..
The warning is written because the ePages service must not run while patch installation.
After successful installation of the patch, following outdated files exist:
./patch.sh cleanup
After patching a Multistore installation web services must be configured in the PBO.
Edit the PBO settings by replacing values in <brackets></brackets> as shown below:
Site - WebService URL: "http://<Domain>/epages/Site.soap" Site - WebserviceUser: "/Users/wsadmin" Site - WebservicePassword: "wsadmin" WebService URL: "http://<MasterShopDomain>/epages/MASTERSHOPNAME.soap" WebserviceUser: "/Shops/MASTERSHOPNAME/Users/admin" WebservicePassword: "admin"
WebService URL: "http://<SubShopDomain>/epages/SUBSHOPNAME.soap" WebserviceUser: "/Users/wsadmin" WebservicePassword: "wsadmin"