This section reviews solutions to other replication problems.

If the issue you are experiencing is not listed in this documentation, search the SharePlex Knowledge Base at:

https://support.quest.com.

The Knowledge Base provides filtering options and links to other resources that can help you use and troubleshoot SharePlex.

SharePlex does not run on a Windows system

SharePlex uses the MKS Toolkit® (also known as NuTCRACKER) operating environment from Parametric Technology Corporation (PTC) to run on Windows systems. If the NuTCRACKER service is stopped or disabled, or if the NuTCRACKER files have been removed or relocated, there will be errors when you try to run SharePlex.

Solution:

1. Run the Windows Task Manager, then click the Processes tab.
2. Check to see if the NuTCRACKER service is running. The process name is nutsrvx, where x is the version of the NuTCRACKER software.

3. If the process is not running, start the NuTCRACKER service by using the Services panel of the Administrative Tools Control Panel.

   • If you do not see the NuTCRACKER service, re-install SharePlex.

   • If the NuTCRACKER service started, but SharePlex still returns errors, check to see if the NuTCRACKER files were relocated. To determine the correct installed location, look at the following in the Windows Registry:

     HKEY_LOCAL_MACHINE\SOFTWARE\Data Focus\Runtime

   • The InstallDir string in the right pane of the Runtime node shows the correct location for the files. Search for the MKS Toolkit folder and restore the files to the location specified in the InstallDir entry.

If you cannot locate the files or cannot restore them to the correct location, do the following:

1. Stop the SharePlex and NuTCRACKER services, if running.

2. Run regedit to open the Registry Editor.

3. Delete the Data Focus and Mortice Kern Systems registry folders under HKEY_LOCAL_MACHINE\SOFTWARE\.
4. Close the Registry Editor.
5. Restart the system.
6. Reinstall SharePlex. Make certain to reinstall SharePlex in the same location, and make certain to install the NuTCRACKER component when prompted.
7. Restart the system to make the new NuTCRACKER environment effective.

A “Can’t unlink file” error occurs on Windows systems

A nuisance error similar to the ones below sometimes occur on Windows systems. The files eventually unlink.

Or...

Common connection errors

The following are solutions to common errors when starting sp_ctrl, or with forming a connection with the host, port or [on host] commands in sp_ctrl.

Explanation of connection error messages

Error	Cause	Solution
Host unknown: cannot form connection	Appears when either the host command or [on host] option is issued.	Verify that the system to which you want to connect is running and that you are using the correct system name.
Network unreachable	The network is down.	Find out how long the network administrator expects it to last. If the downtime could cause the SharePlex queues to exceed their disk space, take measures to avoid having to resynchronize the data. For more information, see How to resolve disk space shortage.
Export cannot connect to import on hostname: timeout waiting for ack	Export cannot connect to the target because its connection was timed out by the network configuration. This can occur when there is little replication activity and the network has a timeout setting.	Set the SP_XPT_KEEPALIVE parameter to 1. This setting tells the Export process to send a "hello" message to Import at regular intervals to prevent the TCP timeouts.
User is not authorized as a SharePlex user -- check /etc/group	You do not have user permissions to execute the operation.	SharePlex users must be listed in the /etc/group file (Unix and Linux) or in the Users list (Windows) under one of the SharePlex user groups: SharePlex Admin, spoper, spview.
unauthorized connection attempt from host hostname. net	A connection from a remote machine was denied because its name is not listed in the auth_hosts file.	See the error message for the name of the system. To allow that system to connect to the sp_cop on the local system, add its name to the auth_hosts file.

Common command errors

Error	Cause	Solution
Deactivate/flush a nonactive datasource	You are attempting to flush a configuration that is not active.	None required.
Bad routing specification	The syntax in the routing map is incorrect.	For more information, see Routing specifications in a configuration file.
Status db file is corrupt.	The Status Database has been damaged.	Shut down SharePlex and remove the statusdb file, which resides in the data subdirectory of the SharePlex variable-data directory. SharePlex will create another one when you start sp_cop again.
Parameter does not exist in database.	You tried to set a parameter, and you entered the wrong name or the parameter is deprecated for your SharePlex version.	Use the list param command to view the SharePlex parameters for your version and to verify the spelling.
Parameter type checking failed - look in param - defaults file.	You might have entered the wrong data type for the parameter.	Use the list param command to determine the valid data type.
Unknown service specified. or... No such module. or... Service may be only one of: post, read, import, export, capture, all.	Valid service (process) names are capture, read, export, import, post.	Issue the command again with the correct name.
Command was called with an invalid argument. or… Unknown keyword used in command.	The command contains invalid input.	Issue the help command to view valid input for the command.
Permission denied for command - check your authorization level.	You are not a member of the user group that can issue this command.	Issue the authlevel command to view your authorization level.
Default host is not defined: use the ‘host’ command or [on host] option.	SharePlex cannot to determine which system you want the command to affect.	Either establish a default host with the host command or use the [on host] option with the command that you want to issue (if available).