Identify Staging Problems
To troubleshoot issues with replicating from a staging environment to a production or development environment, follow this process.
When staging problems occur, isolating problem causes can help formulate a solution.
This example covers staging from the Staging environment to Production, but the same steps apply to any staging process running from staging to development.
-
Monitor the job status of the data replication process on the Staging instance.
-
If it fails, look at the staging logs for failure messages.
-
Look at the staging logs of the Staging instance first.
-
Look at the most recent staging log file. A single staging log often contains several days' worth of staging events in one file.
This only works with Firefox. Microsoft Internet Explorer isn't supported.
-
Look for the beginning of the replication process in the logs. It will have a similar timestamp to the data replication task you started. (individual tasks created in Business Manager)
-
Scroll down through the log file. You will see the job go through steps such as gathering stats for all tables:
-
Next you will see the rsynch running which gets the actual file system directories ready for copying to the target instance
-
The final step on the Staging instance should be a handoff to the target (Production server). Its staging log entry resembles the following line.
-
If you don't see this success message, look for errors such as the following and follow the recommended steps.
If you identify a staging problem, follow this process.
-
Stop and restart the staging and target instance via Control Center.
-
Repeat the failed staging process with the same parameters.
-
If the staging environment log shows no errors, look at the production staging log.
-
Production staging logs will start with a message that looks like this.
-
Depending on what you are staging, you will see the database table copy begin.
-
After copying, we switch from temp to source tables $2 to $1.
-
If it finishes successfully, you will see the following message at the end of the logs.