Troubleshooting Commerce Server Staging
The following are troubleshooting tips for Commerce Server Staging (CSS).
Note To help in the troubleshooting process we recommend that you have all events logged to the NT log file.
When using Commerce Server 2009 Web Parts, applying changes directly on the production site might have non-expected effects. The best practice is to build a staging version of the site and changes can be made on that site, once approved, the changes can be pushed to production by using SharePoint Content Deployment. For more details about how to use Content Deployment to stage a SharePoint implementation with Commerce Server, see the Commerce Server 2009 Installation and Configuration Guide at http://go.microsoft.com/fwlink/?LinkId=139462.
The source staging server credentials are not recognized by the remote CSS server. Check accounts, credentials, and user rights. Make sure that the account you use to authenticate with the remote server has the correct rights on the destination directory. Make sure that the user is a member of the “CSS Operators” or “CSS Administrators” Windows security group.
If you can list projects but cannot create or edit projects, you are may be using an account that has operator rights rather than administrator rights. Verify that the account is a member of CSS Administrators group. If it is not, add the account to CSS Administrators group or change to an account that has administrative rights and try again.
You can assign administrator/operator privileges on a per project basis. For information about assigning privileges, see How Are Permissions Granted to CSS Authentication Accounts?
If you cannot access projects, you are may be using a user account that has no rights to Commerce Server Staging.
Verify that the account has operator/administrator permissions. Change the account rights for your account or change to an account that has administrative rights, and then try again. For information about changing account rights, see How to Add Users to a CSS Security Group.
Make sure that the CSS authentication account has at least operator privilege on the project at the remote server. The CSS authentication account that is used to authenticate the receipt of data must be defined on the resident CSS server which receives the data. For more information about CSS authentication accounts, see How Are CSS Authentication Accounts Defined and Managed?
If you have a large content tree with thousands of files, staging could take a long time to scan and synchronize these file with the remote server. Break large content trees into smaller projects. This will reduce the full synchronization scan time.
Change the project to replicate in incremental or automatic mode so that only changes are replicated.
Staging will try to recover from a network communication failure for up to 30 minutes. This gives the impression of a hung condition. Ping the target to check the communications or issue a nondestructive content deployment command on it. Wait for staging to recover.
Check the Performance Monitor to see if files are being sent or are in a recovery state.
Check the event reports from MMC for detailed information.
The appropriate project may not be installed on the end point server. Make sure that you have a corresponding project on the end point server. The project names must be identical on all servers.
The project or route may not have the failed end point server as a target. Check the project definition on the staging server to make sure that all end points are included. Make sure that you are using the correct server name or IP address.
A server with missing content could have problems with account permissions. Make sure that the account being used by all servers has at least operator permission on the project.
Network problems, insufficient disk space, or bad project information may be involved. Check the communications by pinging the end point or issue a nondestructive content deployment command on it. Make sure that the end point has enough disk space to store the replicated content.
The CSS service on the end point server might not be running. Make sure that the service is running. If not, restart it.
Too many temporary files or expired rollback files are stored on the server. Stop the service.
Clean all files out of the %Commerce Server Root%\Staging\Packages directory, and then delete all files in the CSSTemp directories on the root of each drive. You will be unable to perform any rollbacks after you delete these files.
Restart the service and run the replication again.
CSS was unable to export the business data to the source folder you specified for the project. Make sure that the service account for CSS has sufficient database permissions to export the data. For information about granting accounts access to the database, see How to Grant Staging Accounts Access to the Databases. For information about what database access permissions to grant, see What Database Access Permissions Must You Grant to CSS Authentication Accounts?
Make sure that the source folder where you want to put the exported files exists.
Make sure that the service account has sufficient database permissions to import the data. For information about granting accounts access to the database, see How to Grant Staging Accounts Access to the Databases. For information about what database access permissions to grant, see What Database Access Permissions Must You Grant to CSS Authentication Accounts?