SharePlex 12.2 - Installation and Setup guide

Remove SharePlex from Windows

Remove SharePlex from Windows

Remove SharePlex from the system

Perform these tasks in the order shown.

Remove the SharePlex service

Before you remove the SharePlex software from the system, follow these steps to stop and remove each SharePlex service on the system. If you remove SharePlex first, you cannot use SpUtils to stop and remove the service and must do so from the Services utility of the Windows Control Panel.

1. Double-click the SpUtils desktop icon.
2. Click the SharePlex Services tab.
3. Select the port number for the SharePlex instance that you want to remove. The Current State field displays the status of SharePlex on that port.
4. If the service is running, click Stop. Make certain the status shows Stopped.
5. Click Remove.
6. Stop and remove other SharePlex services as needed.
7. Close the SpUtils dialog box.

Remove the SharePlex software

SharePlex uninstallation program provides three options.

• Automatic (Recommended): Complete removal of all SharePlex components.

• Custom: Removes only the components you select.

• Repair: Restores missing core files and keeps existing configuration.

Automatic (Recommended method of uninstallation)

1. From Start menu, click Programs, then navigate to the SharePlex program folder and right click the SharePlex icon and click Uninstall/Change.

   You can also use the Windows Control Panel as you normally would to remove software.

   Alternatively, you can also click on Uninstall.exe.

2. In the SharePlex Maintenance dialog box, select Automatic (Remove SharePlex) to remove everything listed in Remove SharePlex from Windows. This is the recommended procedure because it is the cleanest way to remove SharePlex from the system.

3. Click Finish to execute the uninstallation.

Custom

Note: This option should be used only by users who are familiar with its operation. Please read instructions carefully before using this options.

Select this option to remove specific files/folder groups while keeping others.

1. From Start menu, click Programs, then navigate to the SharePlex program folder and right click the SharePlex icon and click Uninstall/Change.

   You can also use the Windows Control Panel as you normally would to remove software.

   Alternatively, you can also click on Uninstall.exe.

2. In the SharePlex Maintenance dialog box, select an uninstall option.

3. On the Custom Uninstall - Files window, select the files/folder groups you want to remove.

   

Refer to the table below to check which component removes what.

4. Click Next.

5. Select the registry entries that you want to delete and click Next.

   

   NOTE: Changing and removing Windows Registry components may be harmful to the system. Contact your System Administrator for assistance if needed.

6. Click Next.

7. Click Uninstall.

   System displays a notification after successful uninstallation: SharePlex is uninstalled successfully from your computer.

8. Click Finish.

Repair

1. From Start menu, click Programs, then navigate to the SharePlex program folder and right click the SharePlex icon and click Uninstall/Change.

   You can also use the Windows Control Panel as you normally would to remove software.

   Alternatively, you can also click on Uninstall.exe.

2. In the SharePlex Maintenance dialog box, select Repair (Reinstall core files and keep configuration) to restore missing core files or update Registry entries.

3. Click Finish to execute the uninstallation.

Remove the SharePlex user and database objects

This uninstaller does not remove the SharePlex database objects. All SharePlex objects are installed in the SharePlex schema or database that was specified when the Database Setup portion of the installation was performed.

Advanced installer options

The use of additional command line options when installing SharePlex is usually not necessary. These options are typically employed when working with Support to resolve specific issues.

Note: This option is not valid for the Windows operating system.

The installer command line options and their descriptions follow:

Install SharePlex as root

You can install SharePlex as a root user. When you install as a root user, the installer prompts you to select whether or not to create the SharePlex user groups. When the installer creates the groups, it adds the SharePlex Administrator user to the spadmin group. For more information about these groups, see Assign SharePlex Users to Security Groups.

In a cluster, the installer adds the SharePlex groups to the primary node, but you must add them to the other nodes yourself.

Additionally, see Network checklist for instructions on adding the groups to a nameserver.

To install as root:

1. Log in to the system as a root user.

2. Copy the SharePlex installer file to a temporary directory where you have write permissions. The installer file has a naming format of:

   SharePlex-release#-platform.tpm

3. Change the permissions of the file as follows:

   # chmod 555 SharePlex-release#-platform.tpm

4. Run the installer as directed in Install SharePlex .

SharePlex installed items

The following describes the items that are installed during the SharePlex setup process.

SharePlex directories

SharePlex uses two main directories:

The product directory: This is the SharePlex installation directory, where the SharePlex programs and libraries are stored.

The variable-data directory: This is the SharePlex working directory, where the queue files, log files and other components that comprise the current replication environment are stored.

Note: These directories are often referred to as productdir and vardir, respectively.

Do not remove, rename or edit any files or directories installed by SharePlex. Some directories contain hidden files that are essential for replication. Some files appear empty but must exist under their original names because they are referenced by one or more SharePlex processes. Some items in the directories are for use only under the supervision of Quest Technical Support.

Programs meant for general use in a production environment are documented in the published SharePlex documentation. If you do not find documentation for a program in a SharePlex directory, do not attempt to run it. Contact Quest Technical Support first.

The directory structure and files within the two main SharePlex directories differs slightly between the UNIX and Windows platforms. Files and directories can vary from version to version of SharePlex, but the basic structure appears as follows.

SharePlex product directory

SharePlex variable-data directory

SharePlex installed objects

Much of the replication process is controlled and tracked through a series of internal objects that are installed into the source or target database during the installation of SharePlex. They are essential for SharePlex to operate, so do not alter them in any way.

NOTE: Not all objects are used for all databases. Most are used for Oracle databases. If you do not see an object in your database, it is not relevant to the database, or the information is stored internally within the SharePlex configuration. If you see an object that is in your database but not in this list, it is not being used in the current release.