Troubleshooting the Administration tool
The following table lists some pcmadmin execution error messages and how to resolve them.
| Error | When executed | Do this |
|---|---|---|
| Error: Can’t open display: 0.0 | from the command line on a Windows workstation | Check that there is an XWindows emulation software running. |
| Error: Can't open display: | from a Linux command line | Make certain the DISPLAY variable is set properly (to display on your system). |
| Unable to Open DLL | on a Windows system | Check that your path variable contains the system directory under the Contenta_home directory. For example: C:\Program Files (x86)\\Contenta\system |
| Unable to Open message file pcm.cat | Ignore this message. | |
| XY_SQLCODE ::0 | Ignore this message. | |
| FixUsers failed to decrypted. Reencrypting | message appears in the terminal window after the pcmadmin GUI appears | Ignore this message. |
| Error | When executed | Do this |
|---|---|---|
| Open of dbname@DSN failed: database in singleuser mode. Sorry can’t open —or— Open of dbname@DSN failed: Can’t attach in singleuser mode. There are n users registered as active. where dbname is the name of your database and n is a whole number. | from the command line (this error message is not seen unless the command is issued from the command line) | Check that there are no other instances of pcmadmin running or that users are not connected to the database. Use pcmsessions to check user sessions. |
| The pcmadmin login window does not display and there is no error message. | from a command line | Set the license variable, sdlxysoft _LICENSE 5053@nodename. Do this on the command line before you issue the pcmadmin command. |
| Error | When executed | Do this |
|---|---|---|
| system error core file generated | Oracle/workstation | Confirm that the tnsnames.ora file contains an entry for the Oracle server where the Contenta database resides. The file is located in the Oracle_home/network/ admin directory Use the OracleNet Configuration tool to edit the tnsnames.ora file. |
| pcmadmin: Command not found. | from a command line | Verify that the Contenta /bin directory is defined in the PATH variable —or— Issue the command from the Contenta /bin directory —or— Include the full Contenta /bin directory path when issuing the command. |
| Changes made in pcmadmin are not reflected are not seen) in the Contenta Explorer interface. | on a client workstation | Verify that the Contenta Administration software was installed on the client by checking that the pcmadmin.exe file is in the Contenta_home/bin directory on the client. |
| in Contenta Explorer user interface | Log out of Contenta Explorer, restart the Portal (PcmPortal) and then log in to Contenta Explorer again. |