The Portal service on Window servers
PcmPortal is a Windows service named XyEnterprise Contenta Server. The service is installed when Contenta Server software is installed. If the service is not automatically started, start it in the Services window. To check if the service is running:
- Press the Ctrl+Alt+Del keys and select Task Manager from the resulting window.
- Click on the Processes tab.
- Look for the process PcmPortal.exe in the list of processes.
Executing the XyEnterprise Contenta Server service
If you do not see the PcmPortal.exe processes, use the Start button in the Services window to start the processes. You must have administrator permissions to start and stop processes.
Executing the XyEnterprise Contenta Server service in Debug Mode
There are several methods of running the XyEnterprise Contenta Server service (portal) in debug mode on Window servers.
- If the Contenta client is installed on the server, follow the steps in the section Executing the Service on Servers with Client Software.
- To execute the service in debug mode on a server that does not have the Contenta client software installed, follow the steps in the section Executing the Service on Servers without Client Software.
- To execute the service, or several instances of the service, in debug mode from a command line, follow the steps in the section Executing PcmPortal in Debug Mode from a Command Line.
Executing the Service on Servers with Client Software
- Log in to the Contenta Explorer on the server as sysadmin.
- Display the Tools Options window. Click
- Click on the Registry Settings tab.
- Under HKEY_LOCAL_MACHINE folder in the left pane of the window, open the Contenta Server folder then click on the folder named for the Contenta version number that is installed.
- Select XYE_PRTL_DEBUG in the right pane of the window.
- Click Modify Value on the bottom-right of the window to display the Edit Value window.
- Change the Value Data for XYE_PRTL_DEBUG to
1. - Click OK.
- Note the directory path and filename for the XYE_PRTL_LOG_DIR in the Registry Settings window. Errors are logged to this directory and file when debug is turned on.
- Click OK to exit the Registry Settings window.
- Stop and restart the Portal (XyEnterprise Contenta Server service) in the Services window. (Access the Services window through the Control Panel.)
Executing the Service on Servers without Client Software
- Log in to the server as the Administrator user.
- Click Start, and then click Run.
- In the resulting Run window’s Open field, enter: regedit.
- Click OK to display the Registry Editor window.
- In the Registry Editor window, select:
HKEY_LOCAL_MACHINE > SOFTWARE > XyEnterprise > Contenta Server > number - Double-click XYE_PRTL_DEBUG.
An Edit DWORD Value window appears.
- Change the Value data for XYE_PRTL_DEBUG to
1. - Click OK.
- Note the directory path and filename for the XYE_PRTL_LOG_DIR in the Registry Editor window. Errors are logged to the log file in the directory specified when debug is turned on.
- Exit the Registry Editor, click: .
- Stop and restart the Portal (XyEnterprise Contenta Server service) in the Services window.
- At a command prompt, go to the .
- At the command prompt, enter:
where portal_number is a unique number for the portal—for example:PcmPortal -debug -s -Sportal_number -d1PcmPortal -debug -s -S6055 -d1See PcmPortal Debug Mode for valid debug values to use with the-dswitch. To view errors and messages, execute the Contenta Explorer using the portal number you started in debug mode.
You specify the portal number for the Contenta Explorer by clicking Options in the Login window. Note the following about executing the portal from a command line:
When the portal is executed in debug mode from the command line, it does not run as a service. Only one portal can be installed as a service.
See Executing the Service on Servers with Client Software or Executing the Service on Servers without Client Software for details about executing the service in debug mode.
-
You can run multiple portals in debug mode. Use unique portal numbers for each. For example:
PcmPortal -debug -s -S6055 -d1 PcmPortal -debug -s -S6056 -d1 PcmPortal -debug -s -S6057 -d1Start one portal with this command per Contenta Explorer (CE) application. The portal does not work for each CE session executed with this portal (as it does on Linux systems).
- The debug messages are displayed on the server in the window where the command was issued. (It does not write to a log file; no log file is maintained.)
Date and time stamp for output is in the form of
mm dd yyyy HH:MM:SS:ms(month, day, year, hour, minute, second, microsecond).