Read the installation requirements if you're installing ProTop for the first time.
1. Open a Remote Desktop session on the Windows Server hosting the databases.
2. Download ProTop from wss.com or your local ProTop web portal (see the Intro Page).
3. Create the ProTop installation directory, for example, "C:\protop."
4. Extract the downloaded zip file directly into this directory.
5. Find the "proenv" shortcut for your OpenEdge installation and run it as administrator.
6. From the proenv command line, change directories to the ProTop installation directory.
7. Launch pt3inst.
8. Select the installation type by using the up/down arrow keys to highlight the correct line, then spacebar to select the highlighted option:
- If this is your first time installing ProTop, you wish to trend data on our web portal, select "Create a new custId"
- If you already have an account on the web portal and are reinstalling ProTop, or installing ProTop on a new server, select "Use an existing custId" and enter it on the next screen
- If you prefer only to use the locally-installed Real-Time Monitor and not send data to the web portal, select "Local install (no portal)."
9. If you selected "Create a new custId" in the previous step, you will be prompted to enter an email address and company name. ProTop will send your new ProTop web portal login credentials to this email address.
10. Enter a comma-separated list of directories containing databases you wish ProTop to discover, or leave blank to skip this step. Only running databases will be auto-discovered.
NOTE: Drive letters are case-sensitive!
11. Select the databases you want ProTop to monitor:
- Use the Up/Down arrows to scroll through the list
- Space Bar to toggle the Keep value
- To complete the automatic database discovery process, use F1 or Ctrl-x to save your selections and exit.
- Use F4 to quit without saving.
If you selected "Create a new custId" as the installation type, you would see your new custId in the confirmation message:
If you selected "Local install (no portal) as the installation type, please proceed to the Starting ProTop Real-Time help page to get started.
Web Portal Trend Data Configuration
Now that you have installed the basic ProTop package, please perform the following configuration steps to gather your metrics and send them to the ProTop Portal for trending and graphic presentation.
If you need to use SSL between your ProTop installation and the ProTop Portal, see SSL / Secure Socket Layer for ProTop before proceeding.
12. From the Windows Services screen, verify that the "ProTop3 DB Monitor" Service has been installed and started. If it is stopped or paused, restart it.
13. If you did not configure any databases or wish to add more, see Adding More Databases for detailed instructions.
Access the Portal
14. Check your email. You should have received an email with your login credentials and your ProTop web portal URL. (No, we do not use "password" as the default password!)
15. Click on the link in the email to log in to the ProTop web portal
You will start seeing data in the web portal in about 5-10 minutes.
Problems?
If you do not see data in the portal or have any problems or questions, there are multiple ways to get help:
- Our Troubleshooting Guide covers the most common issues, such as proxies and firewalls.
- The ProTop Community is a great place to ask questions about using ProTop and how to interpret the data.
- And of course, you can send us an email at any time, and we'll do our best to respond within one business day.
Uninstall ProTop from Windows (may require elevated privileges)
1. Stop the "Protop3 DB Monitor" service by opening the Windows Services app, find the "ProTop3 DB Monitor", right-click it, and select Stop.
2. Open a command window (cmd.exe) as Administrator.
3. Navigate to your ProTop installation "ubin" directory
For Example:
c:\> cd c:\protop\ubin
4. Run the nssm64.exe provided with ProTop
c:\protop\ubin> nssm64.exe remove "ProTop3 DB Monitor" <return>
5. Click Yes.
6. Now, remove your ProTop installation folder. For ProTop installed in c:\protop, this command will remove the directory and all of its contents:
c:\> rmdir /s/q c:\protop
If you get a warning that the folder cannot be deleted because it is in use by another process, first verify you have shut down the ProTop3 DB Monitor service. It is possible to run the "nssm64 remove" command above successfully with the process still running. Once you stop the process the open files in your ProTop installation should be released. If the service is indeed shut down, use the Windows process explorer to find what is holding files open in your installation folder. If you do not have procexp.exe installed, run the version provided by ProTop from another folder, e.g.:
cd c:\temp
c:\protop\ubin\procexp.exe
Search (binoculars icon) for protop to see which processes are holding files open in your ProTop installation folder and end those processes, then the rmdir command above should succeed.
7. To finish up, remove any other ProTop-related files and folders you may have created outside the ProTop installation folder, and you are done.