Open the "Environment variable" form by going to the "Control panel" and, then "System" and then "Advanced system settings" (Control Panel\System and Security\System). Click on the "Environment variables" button. Remove the "EDM_LIC_xxx_xxxx" item from the system variables list; xxx is your license number. Afterwards, remove "%EDM_HOME%\bin" from the path variable by selecting the Path variable from the system variables and clicking on the edit button; see Figure 20, below.
Figure 20. Remove System variablesAppendices | Anchor |
|---|
| _Toc372890531 |
|---|
| _Toc372890531 |
|---|
|
| Anchor |
|---|
| _Ref373491277 |
|---|
| _Ref373491277 |
|---|
|
| Anchor |
|---|
| _Ref373491282 |
|---|
| _Ref373491282 |
|---|
|
| Anchor |
|---|
| _Toc374368575 |
|---|
| _Toc374368575 |
|---|
|
| Anchor |
|---|
| _Toc389828961 |
|---|
| _Toc389828961 |
|---|
|
| Anchor |
|---|
| _Toc389829497 |
|---|
| _Toc389829497 |
|---|
|
| Anchor |
|---|
| _Ref399950303 |
|---|
| _Ref399950303 |
|---|
|
| Anchor |
|---|
| _Ref399950310 |
|---|
| _Ref399950310 |
|---|
|
| Anchor |
|---|
| _Ref399950318 |
|---|
| _Ref399950318 |
|---|
|
| Anchor |
|---|
| _Toc402435764 |
|---|
| _Toc402435764 |
|---|
|
| Anchor |
|---|
| _Toc402451608 |
|---|
| _Toc402451608 |
|---|
|
| Anchor |
|---|
| _Toc402458719 |
|---|
| _Toc402458719 |
|---|
|
| Anchor |
|---|
| _Toc416769099 |
|---|
| _Toc416769099 |
|---|
|
| Anchor |
|---|
| _Toc429402815 |
|---|
| _Toc429402815 |
|---|
|
EDM6ServerConsole systemEDM6ServerConsole is a separate application that is delivered alongside of EDMtruePLM. Through this software you can manage different EDMserver solutions and start and stop them as MS Windows services. The software has two separate components
- EDMservice: This is a Windows service that will monitor EDM solutions and make sure that they are running.
- EDM6ServerConsole: This is the GUI console that can manage the EDMserver and setup solutions.
Reference: [https://conwik.jotne.com/display/EDM/EDM6ServerConsole+guide
| Anchor |
|---|
_Toc389828962 | _Toc389828962 | | Anchor |
|---|
_Toc389829498 | _Toc389829498 | | Anchor |
|---|
_Toc402435765 | _Toc402435765 | | Anchor |
|---|
_Toc402451609 | _Toc402451609 | | Anchor |
|---|
_Toc402458720 | _Toc402458720 | | Anchor |
|---|
_Toc416769100 | _Toc416769100 | | Anchor |
|---|
_Toc429402816 | _Toc429402816 | |https://jotne.atlassian.net/wiki/spaces/EDM/pages/3438477401/Installation+guide+3.2#inlineExtensionAppendices]| Anchor |
|---|
_Ref89950037 | _Ref89950037 | | Anchor |
|---|
_Toc90043792 | _Toc90043792 EDM6ServerConsole configurationInstalling and starting the EDMservice
Before using the system, EDMservice must be installed and started as a Windows service.
Windows services can only be installed by using the "Windows Administration role".
| Anchor |
|---|
| _Ref383761484 |
|---|
| _Ref383761484 |
|---|
|
| Anchor |
|---|
| _Toc389829528 |
|---|
| _Toc389829528 |
|---|
|
| Anchor |
|---|
| _Toc400693579 |
|---|
| _Toc400693579 |
|---|
|
| Anchor |
|---|
| _Toc402458821 |
|---|
| _Toc402458821 |
|---|
|
| Anchor |
|---|
| _Toc416769262 |
|---|
| _Toc416769262 |
|---|
|
| Anchor |
|---|
| _Toc429402857 |
|---|
| _Toc429402857 |
|---|
|
Figure 21. Starting the command prompt as an administratorThis will open the administrator command window.
| Anchor |
|---|
| _Ref383761512 |
|---|
| _Ref383761512 |
|---|
|
| Anchor |
|---|
| _Toc389829529 |
|---|
| _Toc389829529 |
|---|
|
| Anchor |
|---|
| _Toc400693580 |
|---|
| _Toc400693580 |
|---|
|
| Anchor |
|---|
| _Toc402458822 |
|---|
| _Toc402458822 |
|---|
|
| Anchor |
|---|
| _Toc416769263 |
|---|
| _Toc416769263 |
|---|
|
| Anchor |
|---|
| _Toc429402858 |
|---|
| _Toc429402858 |
|---|
|
Figure 22. Administrator command promptGo to the bin directory (C:\Program Files\Jotne\EDMmodelServer_plcs\edmcore-v602.212.98\bin) of the EDMsix installation and execute the following command:
EDM6Service.exe -i
Figure 23. EDMservice as a Windows installationThis will install the EDMservice as a Windows service on your system. To start the service run the command without any arguments.
EDM6Service.exe EDMservice shall automatically start after a Windows reboot.
| Anchor |
|---|
| _Toc389828963 |
|---|
| _Toc389828963 |
|---|
|
| Anchor |
|---|
| _Toc389829499 |
|---|
| _Toc389829499 |
|---|
|
| Anchor |
|---|
| _Toc402435766 |
|---|
| _Toc402435766 |
|---|
|
| Anchor |
|---|
| _Toc402451610 |
|---|
| _Toc402451610 |
|---|
|
| Anchor |
|---|
| _Toc402458721 |
|---|
| _Toc402458721 |
|---|
|
| Anchor |
|---|
| _Toc416769101 |
|---|
| _Toc416769101 |
|---|
|
| Anchor |
|---|
| _Toc429402817 |
|---|
| _Toc429402817 |
|---|
|
Starting the EDM6ServerConsoleStart the EDM6ServerConsole by running the EDM6serverConsole.exe either from the command window or from the shortcut placed on the desktop. If the EDMservice is not yet started, the following error message will be displayed.
| Anchor |
|---|
| _Toc389829532 |
|---|
| _Toc389829532 |
|---|
|
| Anchor |
|---|
| _Toc400693583 |
|---|
| _Toc400693583 |
|---|
|
| Anchor |
|---|
| _Toc402458825 |
|---|
| _Toc402458825 |
|---|
|
| Anchor |
|---|
| _Toc416769266 |
|---|
| _Toc416769266 |
|---|
|
| Anchor |
|---|
| _Toc429402861 |
|---|
| _Toc429402861 |
|---|
|
Figure 24. Error from EDM6ServerConsoleThe EDM6ServerConsole is the GUI management tool for the EDMserver and applications based on EDMserver, like EDMtruePLM. An EDMserver solution is a combination of the following settings:
...
Through this application you can create, delete, start, and stop solutions based on EDMsix server and application servers.
| Anchor |
|---|
| _Toc389828964 |
|---|
| _Toc389828964 |
|---|
|
| Anchor |
|---|
| _Toc389829500 |
|---|
| _Toc389829500 |
|---|
|
| Anchor |
|---|
| _Toc402435767 |
|---|
| _Toc402435767 |
|---|
|
| Anchor |
|---|
| _Toc402451611 |
|---|
| _Toc402451611 |
|---|
|
| Anchor |
|---|
| _Toc402458722 |
|---|
| _Toc402458722 |
|---|
|
| Anchor |
|---|
| _Toc416769102 |
|---|
| _Toc416769102 |
|---|
|
| Anchor |
|---|
| _Toc429402818 |
|---|
| _Toc429402818 |
|---|
|
EDM6ServerConsole GUIFor configuring the EDM6ServerConsole open the "Tools" → "Application settings" menu item.
| Anchor |
|---|
| _Toc389829533 |
|---|
| _Toc389829533 |
|---|
|
| Anchor |
|---|
| _Toc400693584 |
|---|
| _Toc400693584 |
|---|
|
| Anchor |
|---|
| _Toc402458826 |
|---|
| _Toc402458826 |
|---|
|
| Anchor |
|---|
| _Toc416769267 |
|---|
| _Toc416769267 |
|---|
|
| Anchor |
|---|
| _Toc429402862 |
|---|
| _Toc429402862 |
|---|
|
Figure 25. EDM6ServerConsole main windowNote: In above figure, 10007 is the EDM license number. Your computer may use a different license number.
The following sections will go through the different options within the EDM6ServerConsole setting panel.
| Anchor |
|---|
| _Toc389828965 |
|---|
| _Toc389828965 |
|---|
|
| Anchor |
|---|
| _Toc389829501 |
|---|
| _Toc389829501 |
|---|
|
| Anchor |
|---|
| _Toc402435768 |
|---|
| _Toc402435768 |
|---|
|
| Anchor |
|---|
| _Toc402451612 |
|---|
| _Toc402451612 |
|---|
|
| Anchor |
|---|
| _Toc402458723 |
|---|
| _Toc402458723 |
|---|
|
| Anchor |
|---|
| _Toc416769103 |
|---|
| _Toc416769103 |
|---|
|
| Anchor |
|---|
| _Toc429402819 |
|---|
| _Toc429402819 |
|---|
|
Common settings
| Anchor |
|---|
| _Toc389829534 |
|---|
| _Toc389829534 |
|---|
|
| Anchor |
|---|
| _Toc400693585 |
|---|
| _Toc400693585 |
|---|
|
| Anchor |
|---|
| _Toc402458827 |
|---|
| _Toc402458827 |
|---|
|
| Anchor |
|---|
| _Toc416769268 |
|---|
| _Toc416769268 |
|---|
|
| Anchor |
|---|
| _Toc429402863 |
|---|
| _Toc429402863 |
|---|
|
Figure 26. Common settings| Anchor |
|---|
| _Toc389828966 |
|---|
| _Toc389828966 |
|---|
|
| Anchor |
|---|
| _Toc389829502 |
|---|
| _Toc389829502 |
|---|
|
| Anchor |
|---|
| _Toc402435769 |
|---|
| _Toc402435769 |
|---|
|
| Anchor |
|---|
| _Toc402451613 |
|---|
| _Toc402451613 |
|---|
|
| Anchor |
|---|
| _Toc402458724 |
|---|
| _Toc402458724 |
|---|
|
The common setting panel allows a user to setup the path for the internal EDM6ServerConsole configuration file, solution database location, and the port it uses to communicate with the EDMservice, EDM6Service port. To change the port, you must first change the port here and then restart the EDMservice. This will update the EDMservice port number.
Important:The port number must not be blocked or used by any other application.
| Anchor |
|---|
| _Toc416769104 |
|---|
| _Toc416769104 |
|---|
|
| Anchor |
|---|
| _Toc429402820 |
|---|
| _Toc429402820 |
|---|
|
Console settings
| Anchor |
|---|
| _Toc389829535 |
|---|
| _Toc389829535 |
|---|
|
| Anchor |
|---|
| _Toc400693586 |
|---|
| _Toc400693586 |
|---|
|
| Anchor |
|---|
| _Toc402458828 |
|---|
| _Toc402458828 |
|---|
|
| Anchor |
|---|
| _Toc416769269 |
|---|
| _Toc416769269 |
|---|
|
| Anchor |
|---|
| _Toc429402864 |
|---|
| _Toc429402864 |
|---|
|
Figure 27. Console settingThe console setting allows the user to adjust how the EDM6ServerConsole behaves.
| Anchor |
|---|
| _Toc416769105 |
|---|
| _Toc416769105 |
|---|
|
...
Application settingsThis tab will allow you to configure the behaviour of the EDM6ServerConsole GUI.
| Anchor |
|---|
| _Toc416769106 |
|---|
| _Toc416769106 |
|---|
|
...
AppearanceThis tab allows you to configure the event log window and the EDMserver and EDMappserver logs; see section A.3.4 for details of application servers (EDMappserver).
| Anchor |
|---|
| _Toc389828967 |
|---|
| _Toc389828967 |
|---|
|
| Anchor |
|---|
| _Toc389829503 |
|---|
| _Toc389829503 |
|---|
|
| Anchor |
|---|
| _Toc402435770 |
|---|
| _Toc402435770 |
|---|
|
| Anchor |
|---|
| _Toc402451614 |
|---|
| _Toc402451614 |
|---|
|
| Anchor |
|---|
| _Toc402458725 |
|---|
| _Toc402458725 |
|---|
|
| Anchor |
|---|
| _Toc416769107 |
|---|
| _Toc416769107 |
|---|
|
| Anchor |
|---|
| _Toc429402821 |
|---|
| _Toc429402821 |
|---|
|
Service crash settingsThe service settings are explained below.
| Anchor |
|---|
| _Toc389828968 |
|---|
| _Toc389828968 |
|---|
|
| Anchor |
|---|
| _Toc389829504 |
|---|
| _Toc389829504 |
|---|
|
| Anchor |
|---|
| _Toc402435771 |
|---|
| _Toc402435771 |
|---|
|
| Anchor |
|---|
| _Toc402451615 |
|---|
| _Toc402451615 |
|---|
|
| Anchor |
|---|
| _Toc402458726 |
|---|
| _Toc402458726 |
|---|
|
| Anchor |
|---|
| _Toc416769108 |
|---|
| _Toc416769108 |
|---|
|
Auto restart settingThe auto restart setting allows a user to configure how the EDMservice should react if the EDMserver has crashed. By default, the EDMservice restarts the EDMserver after each crash. If the EDMserver has crashed for the maximum number of counts within the time period, "Reset restart count after", the EDMservice will not restart the EDMserver, if it crashes again. After the time period, the counter will reset to zero. This will also happen if the Windows system is rebooted or the EDMservice is restarted.
| Anchor |
|---|
| _Toc389829536 |
|---|
| _Toc389829536 |
|---|
|
| Anchor |
|---|
| _Toc400693587 |
|---|
| _Toc400693587 |
|---|
|
| Anchor |
|---|
| _Toc402458829 |
|---|
| _Toc402458829 |
|---|
|
| Anchor |
|---|
| _Toc416769270 |
|---|
| _Toc416769270 |
|---|
|
| Anchor |
|---|
| _Toc429402865 |
|---|
| _Toc429402865 |
|---|
|
Figure 28. Auto restart solutionEmail notificationEDM6Service can send e-mail notifications in case of EDMserver crash or similar issues.
E-mails are sent via a dedicated SMTP server. You need to select this option to enable email notifications and complete the form with necessary information.
Figure 29. Email notificationStart SolutionA solution (EDMserver + one or multiple app servers + optionally Tomcat) can be started and stopped manually. There is an option to start/restart solutions automatically.
Figure 30. Start solutionBackupDatabase backup procedure can be scheduled once a day. During backup, the corresponding solution is stopped. The EDM database is copied to a defined folder as a ZIP package. The solution is restarted automatically after backup.
Figure 31. BackupMemory usage checkThis option should be switched off.
Figure 32. Memory usage check| Anchor |
|---|
| _Toc389828970 |
|---|
| _Toc389828970 |
|---|
|
| Anchor |
|---|
| _Toc389829506 |
|---|
| _Toc389829506 |
|---|
|
| Anchor |
|---|
| _Toc402435773 |
|---|
| _Toc402435773 |
|---|
|
| Anchor |
|---|
| _Toc402451617 |
|---|
| _Toc402451617 |
|---|
|
| Anchor |
|---|
| _Toc402458728 |
|---|
| _Toc402458728 |
|---|
|
| Anchor |
|---|
| _Toc416769111 |
|---|
| _Toc416769111 |
|---|
|
| Anchor |
|---|
| _Toc429402822 |
|---|
| _Toc429402822 |
|---|
|
Solution configurationA solution is a setting to start one EDMserver and one or multiple application servers, also called appservers.
Before starting a solution, its components must be configured. To manage a component configuration, either use the menu item for that component or use the component tab. In addition, the component tab shows the list of different configurations for the component.
All components are configured automatically during installation of the EDMtruePLM server.
Simple user actions are needed to complete the solution configuration.
We assume here that the EDM license was installed before the installation of the EDMservice. In this case the "Solution" tab (see Figure 33) has at least one row with a license number at the first column.
Drop down lists in column 2 (Server), 3 (Configuration) and 4 (Database) should offer selections. More details are given in the sections, below.
It is recommended to set a tick to the check box in the column before "Start/Stop" button. In this case the solution will be started automatically when Windows is restarted.
Image Modified
Figure 33. Database drop down listAfter setting the above details, the solution can be started manually by clicking the "Start" button.
Notes:...
Server tabThe server tab lists all available servers (see Figure 34).
| Anchor |
|---|
| _Ref384021175 |
|---|
| _Ref384021175 |
|---|
|
| Anchor |
|---|
| _Toc389829538 |
|---|
| _Toc389829538 |
|---|
|
| Anchor |
|---|
| _Toc400693589 |
|---|
| _Toc400693589 |
|---|
|
| Anchor |
|---|
| _Toc402458831 |
|---|
| _Toc402458831 |
|---|
|
| Anchor |
|---|
| _Toc416769273 |
|---|
| _Toc416769273 |
|---|
|
| Anchor |
|---|
| _Toc429402867 |
|---|
| _Toc429402867 |
|---|
|
Figure 34. List of all available server configurationsIn addition, through the server tab one can create, delete or edit a server configuration. To create a server configuration either right click in the tab area or use the Server menu item.
| Anchor |
|---|
| _Toc389829539 |
|---|
| _Toc389829539 |
|---|
|
| Anchor |
|---|
| _Toc400693590 |
|---|
| _Toc400693590 |
|---|
|
| Anchor |
|---|
| _Toc402458832 |
|---|
| _Toc402458832 |
|---|
|
| Anchor |
|---|
| _Toc416769274 |
|---|
| _Toc416769274 |
|---|
|
| Anchor |
|---|
| _Toc429402868 |
|---|
| _Toc429402868 |
|---|
|
Figure 35. Server tab popup menu item| Anchor |
|---|
| _Toc389828972 |
|---|
| _Toc389828972 |
|---|
|
| Anchor |
|---|
| _Toc389829508 |
|---|
| _Toc389829508 |
|---|
|
| Anchor |
|---|
| _Toc402435775 |
|---|
| _Toc402435775 |
|---|
|
| Anchor |
|---|
| _Toc402451619 |
|---|
| _Toc402451619 |
|---|
|
| Anchor |
|---|
| _Toc402458730 |
|---|
| _Toc402458730 |
|---|
|
| Anchor |
|---|
| _Toc416769113 |
|---|
| _Toc416769113 |
|---|
|
Adding a new EDMserver executableTo create a new configuration, click on "Add new edmserver" (see Figure 36).
| Anchor |
|---|
| _Ref383781593 |
|---|
| _Ref383781593 |
|---|
|
| Anchor |
|---|
| _Ref383781575 |
|---|
| _Ref383781575 |
|---|
|
| Anchor |
|---|
| _Toc389829540 |
|---|
| _Toc389829540 |
|---|
|
| Anchor |
|---|
| _Toc400693591 |
|---|
| _Toc400693591 |
|---|
|
| Anchor |
|---|
| _Toc402458833 |
|---|
| _Toc402458833 |
|---|
|
| Anchor |
|---|
| _Toc416769275 |
|---|
| _Toc416769275 |
|---|
|
| Anchor |
|---|
| _Toc429402869 |
|---|
| _Toc429402869 |
|---|
|
Figure 36.| Anchor |
|---|
| _Ref383781580 |
|---|
| _Ref383781580 |
|---|
|
Add new EDMserverGive a name to the configuration and make sure that the system is correctly pointing to the EDM version you want to use and press the "OK" button. The default binary files point to the last EDM installation.
| Anchor |
|---|
| _Toc389828973 |
|---|
| _Toc389828973 |
|---|
|
| Anchor |
|---|
| _Toc389829509 |
|---|
| _Toc389829509 |
|---|
|
| Anchor |
|---|
| _Toc402435776 |
|---|
| _Toc402435776 |
|---|
|
| Anchor |
|---|
| _Toc402451620 |
|---|
| _Toc402451620 |
|---|
|
| Anchor |
|---|
| _Toc402458731 |
|---|
| _Toc402458731 |
|---|
|
| Anchor |
|---|
| _Toc416769114 |
|---|
| _Toc416769114 |
|---|
|
Editing EDMserver executablesTo edit an existing EDMserver configuration, select the configuration from the list and click on the "Edit edmserver" menu item, this will open the "Edit EDMserver executable", see Figure 37.
| Anchor |
|---|
| _Ref384021554 |
|---|
| _Ref384021554 |
|---|
|
| Anchor |
|---|
| _Toc389829541 |
|---|
| _Toc389829541 |
|---|
|
| Anchor |
|---|
| _Toc400693592 |
|---|
| _Toc400693592 |
|---|
|
| Anchor |
|---|
| _Toc402458834 |
|---|
| _Toc402458834 |
|---|
|
| Anchor |
|---|
| _Toc416769276 |
|---|
| _Toc416769276 |
|---|
|
| Anchor |
|---|
| _Toc429402870 |
|---|
| _Toc429402870 |
|---|
|
Figure 37. "Edit edmserver" configuration| Anchor |
|---|
| _Toc389828974 |
|---|
| _Toc389828974 |
|---|
|
| Anchor |
|---|
| _Toc389829510 |
|---|
| _Toc389829510 |
|---|
|
| Anchor |
|---|
| _Toc402435777 |
|---|
| _Toc402435777 |
|---|
|
| Anchor |
|---|
| _Toc402451621 |
|---|
| _Toc402451621 |
|---|
|
| Anchor |
|---|
| _Toc402458732 |
|---|
| _Toc402458732 |
|---|
|
| Anchor |
|---|
| _Toc416769115 |
|---|
| _Toc416769115 |
|---|
|
Deleting EDMserver executablesTo delete a configuration, select the configuration item and click on the "Delete EDMserver executables" menu item.
| Anchor |
|---|
| _Toc389828975 |
|---|
| _Toc389828975 |
|---|
|
| Anchor |
|---|
| _Toc389829511 |
|---|
| _Toc389829511 |
|---|
|
| Anchor |
|---|
| _Ref402258002 |
|---|
| _Ref402258002 |
|---|
|
| Anchor |
|---|
| _Toc402435778 |
|---|
| _Toc402435778 |
|---|
|
| Anchor |
|---|
| _Toc402451622 |
|---|
| _Toc402451622 |
|---|
|
| Anchor |
|---|
| _Toc402458733 |
|---|
| _Toc402458733 |
|---|
|
| Anchor |
|---|
| _Toc416769116 |
|---|
| _Toc416769116 |
|---|
|
| Anchor |
|---|
| _Toc429402823 |
|---|
| _Toc429402823 |
|---|
|
Configuration tabThe configuration tab lists all the available runtime settings for the EDMserver and EDMappservers; see Figure 38.
| Anchor |
|---|
| _Ref383782037 |
|---|
| _Ref383782037 |
|---|
|
| Anchor |
|---|
| _Toc389829542 |
|---|
| _Toc389829542 |
|---|
|
| Anchor |
|---|
| _Toc400693593 |
|---|
| _Toc400693593 |
|---|
|
| Anchor |
|---|
| _Toc402458835 |
|---|
| _Toc402458835 |
|---|
|
| Anchor |
|---|
| _Toc416769277 |
|---|
| _Toc416769277 |
|---|
|
| Anchor |
|---|
| _Toc429402871 |
|---|
| _Toc429402871 |
|---|
|
Figure 38. Configuration tabTo manage the
EDMserver configuration use the "Configuration" menu item or right click in the "Configuration" tab to either add, edit or delete a server configuration, see Figure 39.
| Anchor |
|---|
| _Ref383782935 |
|---|
| _Ref383782935 |
|---|
|
| Anchor |
|---|
| _Toc389829543 |
|---|
| _Toc389829543 |
|---|
|
| Anchor |
|---|
| _Toc400693594 |
|---|
| _Toc400693594 |
|---|
|
| Anchor |
|---|
| _Toc402458836 |
|---|
| _Toc402458836 |
|---|
|
| Anchor |
|---|
| _Toc416769278 |
|---|
| _Toc416769278 |
|---|
|
| Anchor |
|---|
| _Toc429402872 |
|---|
| _Toc429402872 |
|---|
|
Figure 39. Configuration tab menu| Anchor |
|---|
| _Toc389828976 |
|---|
| _Toc389828976 |
|---|
|
| Anchor |
|---|
| _Toc389829512 |
|---|
| _Toc389829512 |
|---|
|
| Anchor |
|---|
| _Toc402435779 |
|---|
| _Toc402435779 |
|---|
|
| Anchor |
|---|
| _Toc402451623 |
|---|
| _Toc402451623 |
|---|
|
| Anchor |
|---|
| _Toc402458734 |
|---|
| _Toc402458734 |
|---|
|
| Anchor |
|---|
| _Toc416769117 |
|---|
| _Toc416769117 |
|---|
|
Add new EDMserver configurationTo add a new runtime server configuration, click on the "Add new server configuration", this will open the "New runtime configuration" dialog (see Figure 40).
For a full description of each item within the "New runtime configuration" dialog refer to the EDM help manual. Below you can find a brief description of each item.
| Anchor |
|---|
| _Ref383783014 |
|---|
| _Ref383783014 |
|---|
|
| Anchor |
|---|
| _Toc389829544 |
|---|
| _Toc389829544 |
|---|
|
| Anchor |
|---|
| _Toc400693595 |
|---|
| _Toc400693595 |
|---|
|
| Anchor |
|---|
| _Toc402458837 |
|---|
| _Toc402458837 |
|---|
|
| Anchor |
|---|
| _Toc416769279 |
|---|
| _Toc416769279 |
|---|
|
| Anchor |
|---|
| _Toc429402873 |
|---|
| _Toc429402873 |
|---|
|
Figure 40. New EDMserver configuration...
| Anchor |
|---|
| _Toc389828977 |
|---|
| _Toc389828977 |
|---|
|
| Anchor |
|---|
| _Toc389829513 |
|---|
| _Toc389829513 |
|---|
|
| Anchor |
|---|
| _Toc402435780 |
|---|
| _Toc402435780 |
|---|
|
| Anchor |
|---|
| _Toc402451624 |
|---|
| _Toc402451624 |
|---|
|
| Anchor |
|---|
| _Toc402458735 |
|---|
| _Toc402458735 |
|---|
|
| Anchor |
|---|
| _Toc416769118 |
|---|
| _Toc416769118 |
|---|
|
Editing an EDMserver configurationTo edit an existing EDMserver configuration, select the configuration from the list and click on the "Edit EDMserver configuration" menu item, this will open the "Edit EDMserver configuration", see Figure 41.
| Anchor |
|---|
| _Ref384025574 |
|---|
| _Ref384025574 |
|---|
|
| Anchor |
|---|
| _Toc389829545 |
|---|
| _Toc389829545 |
|---|
|
| Anchor |
|---|
| _Toc400693596 |
|---|
| _Toc400693596 |
|---|
|
| Anchor |
|---|
| _Toc402458838 |
|---|
| _Toc402458838 |
|---|
|
| Anchor |
|---|
| _Toc416769280 |
|---|
| _Toc416769280 |
|---|
|
| Anchor |
|---|
| _Toc429402874 |
|---|
| _Toc429402874 |
|---|
|
Figure 41. Edit EDMserver configuration| Anchor |
|---|
| _Toc389828978 |
|---|
| _Toc389828978 |
|---|
|
| Anchor |
|---|
| _Toc389829514 |
|---|
| _Toc389829514 |
|---|
|
| Anchor |
|---|
| _Toc402435781 |
|---|
| _Toc402435781 |
|---|
|
| Anchor |
|---|
| _Toc402451625 |
|---|
| _Toc402451625 |
|---|
|
| Anchor |
|---|
| _Toc402458736 |
|---|
| _Toc402458736 |
|---|
|
| Anchor |
|---|
| _Toc416769119 |
|---|
| _Toc416769119 |
|---|
|
Deleting an EDMserver configurationTo delete a configuration, select the configuration item and click on the "Delete EDMserver configuration" menu item.
| Anchor |
|---|
| _Toc389828979 |
|---|
| _Toc389828979 |
|---|
|
| Anchor |
|---|
| _Toc389829515 |
|---|
| _Toc389829515 |
|---|
|
| Anchor |
|---|
| _Toc402435782 |
|---|
| _Toc402435782 |
|---|
|
| Anchor |
|---|
| _Toc402451626 |
|---|
| _Toc402451626 |
|---|
|
| Anchor |
|---|
| _Toc402458737 |
|---|
| _Toc402458737 |
|---|
|
| Anchor |
|---|
| _Toc416769120 |
|---|
| _Toc416769120 |
|---|
|
| Anchor |
|---|
| _Toc429402824 |
|---|
| _Toc429402824 |
|---|
|
Database tabThe database tab lists all available EDM databases, see Figure 42.
| Anchor |
|---|
| _Ref383784977 |
|---|
| _Ref383784977 |
|---|
|
| Anchor |
|---|
| _Toc389829546 |
|---|
| _Toc389829546 |
|---|
|
| Anchor |
|---|
| _Toc400693597 |
|---|
| _Toc400693597 |
|---|
|
| Anchor |
|---|
| _Toc402458839 |
|---|
| _Toc402458839 |
|---|
|
| Anchor |
|---|
| _Toc416769281 |
|---|
| _Toc416769281 |
|---|
|
| Anchor |
|---|
| _Toc429402875 |
|---|
| _Toc429402875 |
|---|
|
Figure 42. Database configurationsThe "Database" menu item or the Database tab context menu allows to create, add, remove (from EDM6ServerConsole) and delete (from disk) databases.
| Anchor |
|---|
| _Toc389829547 |
|---|
| _Toc389829547 |
|---|
|
| Anchor |
|---|
| _Toc400693598 |
|---|
| _Toc400693598 |
|---|
|
| Anchor |
|---|
| _Toc402458840 |
|---|
| _Toc402458840 |
|---|
|
| Anchor |
|---|
| _Toc416769282 |
|---|
| _Toc416769282 |
|---|
|
| Anchor |
|---|
| _Toc429402876 |
|---|
| _Toc429402876 |
|---|
|
Figure 43. Database menu items| Anchor |
|---|
| _Toc389828980 |
|---|
| _Toc389828980 |
|---|
|
| Anchor |
|---|
| _Toc389829516 |
|---|
| _Toc389829516 |
|---|
|
| Anchor |
|---|
| _Toc402435783 |
|---|
| _Toc402435783 |
|---|
|
| Anchor |
|---|
| _Toc402451627 |
|---|
| _Toc402451627 |
|---|
|
| Anchor |
|---|
| _Toc402458738 |
|---|
| _Toc402458738 |
|---|
|
| Anchor |
|---|
| _Toc416769121 |
|---|
| _Toc416769121 |
|---|
|
Create new databaseThe "Database"->"Create new EDM database" menu item opens the "Create new EDM database" window.
Figure 44: Create new databaseSelect an EDMsixServer executable from the list of available EDMsixServers, and provide the database path, the database name and the database password.
Notes:
...
| Anchor |
|---|
| _Toc389828981 |
|---|
| _Toc389828981 |
|---|
|
| Anchor |
|---|
| _Toc389829517 |
|---|
| _Toc389829517 |
|---|
|
| Anchor |
|---|
| _Toc402435784 |
|---|
| _Toc402435784 |
|---|
|
| Anchor |
|---|
| _Toc402451628 |
|---|
| _Toc402451628 |
|---|
|
| Anchor |
|---|
| _Toc402458739 |
|---|
| _Toc402458739 |
|---|
|
| Anchor |
|---|
| _Toc416769122 |
|---|
| _Toc416769122 |
|---|
|
Add existing databaseTo add an existing database to the list, use the "Add existing EDM database" menu item, which will bring up Figure 45. To add the database to the list provide a name and the location of the database "db.EDM" file. To enable the EDMserver backup check the "Enable backup" check box and enter the backup destination location and the number of backup versions.
| Anchor |
|---|
| _Ref384030907 |
|---|
| _Ref384030907 |
|---|
|
| Anchor |
|---|
| _Toc389829549 |
|---|
| _Toc389829549 |
|---|
|
| Anchor |
|---|
| _Toc400693600 |
|---|
| _Toc400693600 |
|---|
|
| Anchor |
|---|
| _Toc402458842 |
|---|
| _Toc402458842 |
|---|
|
| Anchor |
|---|
| _Toc416769284 |
|---|
| _Toc416769284 |
|---|
|
| Anchor |
|---|
| _Toc429402878 |
|---|
| _Toc429402878 |
|---|
|
Figure 45. Add existing database| Anchor |
|---|
| _Toc389828982 |
|---|
| _Toc389828982 |
|---|
|
| Anchor |
|---|
| _Toc389829518 |
|---|
| _Toc389829518 |
|---|
|
| Anchor |
|---|
| _Toc402435785 |
|---|
| _Toc402435785 |
|---|
|
| Anchor |
|---|
| _Toc402451629 |
|---|
| _Toc402451629 |
|---|
|
| Anchor |
|---|
| _Toc402458740 |
|---|
| _Toc402458740 |
|---|
|
| Anchor |
|---|
| _Toc416769123 |
|---|
| _Toc416769123 |
|---|
|
Restore EDM database from backup created by EDMserverRestoring backup package can be done manually by the following steps:
...
Edit database settingsSelect the item from the list and click on the "Edit EDM database" menu item.
| Anchor |
|---|
| _Toc389829550 |
|---|
| _Toc389829550 |
|---|
|
| Anchor |
|---|
| _Toc400693601 |
|---|
| _Toc400693601 |
|---|
|
| Anchor |
|---|
| _Toc402458843 |
|---|
| _Toc402458843 |
|---|
|
| Anchor |
|---|
| _Toc416769285 |
|---|
| _Toc416769285 |
|---|
|
| Anchor |
|---|
| _Toc429402879 |
|---|
| _Toc429402879 |
|---|
|
Figure 46. Edit EDM database| Anchor |
|---|
| _Toc389828983 |
|---|
| _Toc389828983 |
|---|
|
| Anchor |
|---|
| _Toc389829519 |
|---|
| _Toc389829519 |
|---|
|
| Anchor |
|---|
| _Toc402435786 |
|---|
| _Toc402435786 |
|---|
|
| Anchor |
|---|
| _Toc402451630 |
|---|
| _Toc402451630 |
|---|
|
| Anchor |
|---|
| _Toc402458741 |
|---|
| _Toc402458741 |
|---|
|
| Anchor |
|---|
| _Toc416769124 |
|---|
| _Toc416769124 |
|---|
|
Remove EDM database from listTo remove the EDM database from the database list, select the database and click on the "Remove information about EDM database".
Note: This will only remove the item from the list and will not delete the actual database files from the hard drive.
| Anchor |
|---|
| _Toc389828984 |
|---|
| _Toc389828984 |
|---|
|
| Anchor |
|---|
| _Toc389829520 |
|---|
| _Toc389829520 |
|---|
|
| Anchor |
|---|
| _Toc402435787 |
|---|
| _Toc402435787 |
|---|
|
| Anchor |
|---|
| _Toc402451631 |
|---|
| _Toc402451631 |
|---|
|
| Anchor |
|---|
| _Toc402458742 |
|---|
| _Toc402458742 |
|---|
|
| Anchor |
|---|
| _Toc416769125 |
|---|
| _Toc416769125 |
|---|
|
Delete EDM database from diskTo delete the EDM database files from the hard drive, select the database and click on the "Delete EDM database from disk". This will remove the selected database from the disk.
Note: No warning will be given when the user clicks on the "Delete EDM database from disk".
| Anchor |
|---|
| _Toc389828989 |
|---|
| _Toc389828989 |
|---|
|
| Anchor |
|---|
| _Toc389829525 |
|---|
| _Toc389829525 |
|---|
|
| Anchor |
|---|
| _Toc402435788 |
|---|
| _Toc402435788 |
|---|
|
| Anchor |
|---|
| _Toc402451632 |
|---|
| _Toc402451632 |
|---|
|
| Anchor |
|---|
| _Toc402458743 |
|---|
| _Toc402458743 |
|---|
|
| Anchor |
|---|
| _Toc416769126 |
|---|
| _Toc416769126 |
|---|
|
| Anchor |
|---|
| _Toc429402825 |
|---|
| _Toc429402825 |
|---|
|
Solution tabThe solution tab lists available EDMserver licenses for which the user can create an EDM solution based on the items from the other tabs.
| Anchor |
|---|
| _Toc389829555 |
|---|
| _Toc389829555 |
|---|
|
| Anchor |
|---|
| _Toc400693602 |
|---|
| _Toc400693602 |
|---|
|
| Anchor |
|---|
| _Toc402458844 |
|---|
| _Toc402458844 |
|---|
|
| Anchor |
|---|
| _Toc416769286 |
|---|
| _Toc416769286 |
|---|
|
| Anchor |
|---|
| _Toc429402880 |
|---|
| _Toc429402880 |
|---|
|
Figure 47. List of solutionsSelect the configurations that you want from the dropdown lists and press the "Start" button, under the last column, to start the solution. The "auto start" check box identifies if you wish the solution to automatically start when the EDMservice is restarted.
Important: The EDMtruePLM does not use the Tomcat section shown in Figure 47.
If the EDM6ServerConsole cannot connect to the EDMservice, the last column will show a start button that will allow the user to try to reconnect to the EDMservice (see Figure 48).
| Anchor |
|---|
| _Ref389827264 |
|---|
| _Ref389827264 |
|---|
|
| Anchor |
|---|
| _Toc389829556 |
|---|
| _Toc389829556 |
|---|
|
| Anchor |
|---|
| _Toc400693603 |
|---|
| _Toc400693603 |
|---|
|
| Anchor |
|---|
| _Toc402458845 |
|---|
| _Toc402458845 |
|---|
|
| Anchor |
|---|
| _Toc416769287 |
|---|
| _Toc416769287 |
|---|
|
| Anchor |
|---|
| _Toc429402881 |
|---|
| _Toc429402881 |
|---|
|
Figure 48. Disconnected from the EDMservice stateYou can also create a new configuration of each item directly from their respective dropdown lists, see Figure 49.
| Anchor |
|---|
| _Ref383781643 |
|---|
| _Ref383781643 |
|---|
|
| Anchor |
|---|
| _Toc389829557 |
|---|
| _Toc389829557 |
|---|
|
| Anchor |
|---|
| _Toc400693604 |
|---|
| _Toc400693604 |
|---|
|
| Anchor |
|---|
| _Toc402458846 |
|---|
| _Toc402458846 |
|---|
|
| Anchor |
|---|
| _Toc416769288 |
|---|
| _Toc416769288 |
|---|
|
| Anchor |
|---|
| _Toc429402882 |
|---|
| _Toc429402882 |
|---|
|
Figure 49. Shortcut in the component dropdown listTo stop a solution, click on the "Stop" button, see Figure 50.
| Anchor |
|---|
| _Ref384039514 |
|---|
| _Ref384039514 |
|---|
|
| Anchor |
|---|
| _Toc389829558 |
|---|
| _Toc389829558 |
|---|
|
| Anchor |
|---|
| _Toc400693605 |
|---|
| _Toc400693605 |
|---|
|
| Anchor |
|---|
| _Toc402458847 |
|---|
| _Toc402458847 |
|---|
|
| Anchor |
|---|
| _Toc416769289 |
|---|
| _Toc416769289 |
|---|
|
| Anchor |
|---|
| _Toc429402883 |
|---|
| _Toc429402883 |
|---|
|
Figure 50. Stopping the solution| Anchor |
|---|
| _Toc389828990 |
|---|
| _Toc389828990 |
|---|
|
| Anchor |
|---|
| _Toc389829526 |
|---|
| _Toc389829526 |
|---|
|
| Anchor |
|---|
| _Toc402435789 |
|---|
| _Toc402435789 |
|---|
|
| Anchor |
|---|
| _Toc402451633 |
|---|
| _Toc402451633 |
|---|
|
| Anchor |
|---|
| _Toc402458744 |
|---|
| _Toc402458744 |
|---|
|
| Anchor |
|---|
| _Toc416769127 |
|---|
| _Toc416769127 |
|---|
|
| Anchor |
|---|
| _Toc429402826 |
|---|
| _Toc429402826 |
|---|
|
The Log WindowsThe log windows show the events of the EDMservice and of the EDMserver. Each time a solution is started, a new tab will be created with the name of the solution license, if the tab has not already been created.
| Anchor |
|---|
| _Toc389829559 |
|---|
| _Toc389829559 |
|---|
|
| Anchor |
|---|
| _Toc400693606 |
|---|
| _Toc400693606 |
|---|
|
| Anchor |
|---|
| _Toc402458848 |
|---|
| _Toc402458848 |
|---|
|
| Anchor |
|---|
| _Toc416769290 |
|---|
| _Toc416769290 |
|---|
|
| Anchor |
|---|
| _Toc429402884 |
|---|
| _Toc429402884 |
|---|
|
Figure 51. Log windowsEDM6ServerConsole logThe "Log" tab displays the
EDMservice events logs from all solutions in chronological order. The three columns show the time of the log, the license for the solution and a description of the event.
Solution logsEach solution will have its own log tab. The tab contains the EDMserver start up command and EDMserver standard output.
Note: It is possible to increase the EDMserver log by providing the "-t" as an additional argument in the runtime configuration.
Cleaning the log tabsTo clean the log tabs right click in the log window and click on the "Clean log" popup button.
| Anchor |
|---|
| _Toc389828991 |
|---|
| _Toc389828991 |
|---|
|
| Anchor |
|---|
| _Toc389829527 |
|---|
| _Toc389829527 |
|---|
|
| Anchor |
|---|
| _Toc402435790 |
|---|
| _Toc402435790 |
|---|
|
| Anchor |
|---|
| _Toc402451634 |
|---|
| _Toc402451634 |
|---|
|
| Anchor |
|---|
| _Toc402458745 |
|---|
| _Toc402458745 |
|---|
|
| Anchor |
|---|
| _Toc416769128 |
|---|
| _Toc416769128 |
|---|
|
| Anchor |
|---|
| _Toc429402827 |
|---|
| _Toc429402827 |
|---|
|
Hiding or exiting the EDM6ServerConsole
The EDM6ServerConsole can be hidden to the system tray by clicking on the dialog box close button or by choosing the "Hide" menu item in the "File" menu, see Figure 52.
| Anchor |
|---|
| _Ref384040543 |
|---|
| _Ref384040543 |
|---|
|
| Anchor |
|---|
| _Toc389829560 |
|---|
| _Toc389829560 |
|---|
|
| Anchor |
|---|
| _Toc400693607 |
|---|
| _Toc400693607 |
|---|
|
| Anchor |
|---|
| _Toc402458849 |
|---|
| _Toc402458849 |
|---|
|
| Anchor |
|---|
| _Toc416769291 |
|---|
| _Toc416769291 |
|---|
|
| Anchor |
|---|
| _Toc429402885 |
|---|
| _Toc429402885 |
|---|
|
Figure 52. Minimizing the applicationThe minimised application is shown in the system tray as an icon. Either double click on the icon or select "Restore" in the tray icon context menu to show the
EDM6ServerConsole window, see Figure 53.
| Anchor |
|---|
| _Ref389828252 |
|---|
| _Ref389828252 |
|---|
|
| Anchor |
|---|
| _Toc389829561 |
|---|
| _Toc389829561 |
|---|
|
| Anchor |
|---|
| _Toc400693608 |
|---|
| _Toc400693608 |
|---|
|
| Anchor |
|---|
| _Toc402458850 |
|---|
| _Toc402458850 |
|---|
|
| Anchor |
|---|
| _Toc416769292 |
|---|
| _Toc416769292 |
|---|
|
| Anchor |
|---|
| _Toc429402886 |
|---|
| _Toc429402886 |
|---|
|
Figure 53. Opening the EDM6ServerConsole from the system tray | Anchor |
|---|
| _Changing_system_admin |
|---|
| _Changing_system_admin |
|---|
|
Changing database passwordFollow the steps below to change the superuser and database passwords.
Important:
...
Step 1. Launch the EDMSupervisor (edms.exe) (C:\Program Files\Jotne\EDMmodelServer_plcs\edmcore-v602.212.98\bin)
Figure 54. EDM supervisorStep 2. Go to "Remote Systems" "Server context" "Define Context" as shown in Figure 55, below.
Figure 55. EDMsupervisor tabFill in the form: enter server context name, user, group, old password, and server details as shown in Figure 56, below.
Figure 56. Define Server context formStep 3. Go to "Remote Systems" "System Adm." "Change password" (Figure 57) and provide a strong new password.
Figure 57. System admin password change tabStep 4. Repeat step 2 with this new superuser password and then Go to "Remote Systems" Database "Change database password" and enter the same password.
Note: The database password must be the same as the superuser password.
Figure 58. Database password change tabStep 5. Launch EDM6ServerConsole.exe and stop the solution
Figure 59. EDM6ServerConsoleStep 6. Update the new database password in the EDM6ServerConsole as shown in Figure 60 and Figure 61, below.
Figure 60. EDM database password update
Figure 61. Update with new database passwordStep 7. Start the "Solution".
How to Install SSL/TLS certificateEnsure that your internal servers, Intranets, and Virtual Private Networks (VPN) are secured.
SSL/TLS certificates are what enable websites to move from HTTP to HTTPS, which is more secure. An SSL/TLS certificate is a data file hosted in a website's origin server (EDMtruePLM server, for instance). SSL certificates make SSL/TLS encryption possible, and they contain the website's public key and the website's identity, along with related information. Devices attempting to communicate with the origin server will reference this file to obtain the public key and verify the server's identity. The private key is kept secret and secure.
Below we describe how to get SSL/TLS certificate issued by an external certificate authority.
Alternatively, you may use your own local certificate authority.
Self-signed SSL certificate is not recommended option.
Create a Certificate Signing Request (CSR)This step can be optional. Certificate authority may generate CSR automatically. Or they may have GUI wizard to simplify CSR creation.
Keytool is utility that can be used to generate CSR. The utility is part of JDK installation.
You can run this utility wherever you have the keytool command available - most likely on your server, but you can also run it on your own computer if you have installed Java locally. Just make sure you keep track of your keystore file after you create your CSR, because you'll need that file because it will contain your private key, and it will be required to install your certificate.
This is the command that should be executed.
Note: there are sample parameters there. Change values according to your need.
keytool -genkey -alias plm -keyalg RSA -keysize 2048 -keystore trueplm_org.jks -dname "CN=trueplm.org,OU=EPM Tech, O=Jotne, L=Oslo, ST=Norway, C=Oslo" && keytool -certreq -alias plm -file trueplm_org.csr -keystore trueplm_org.jks
trueplm_org.jks and trueplm_org.csr are files that will be created by that commands. We suggest using full path to specify those files.
trueplm.org is sample web server domain name.
You need to use the command prompt to execute the command. CD into your JDK bin folder.
As an example, the utility can be found in the folder like the following.
C:\Program Files\Java\jdk-11.0.5\bin
Figure 62. Keystore detailsThe Java
keytool utility creates both your private key and your certificate signing request, and saves them to two files:
trueplm_org.jks, and
trueplm_org.csr. Those files are needed to order SSL/TLS certificate.
Importing the CertificateWe assume trueplm_org.p7b is the certificate file you ordered from a certificate authority.
You must install the SSL/TLS Certificate file to the same keystore file and under the same alias name (e.g., "plm") that you used to generate your CSR.
Run the command below to import the certificate into your keystore.
keytool -import -alias plm -file trueplm_org.p7b -keystore trueplm_org.jks
You should get a confirmation that the "Certificate reply was installed in keystore".
Edit the Tomcat Configuration FileThe final step is to configure the Connectors in the server.xml file that can be found in the following folder.
C:\ProgramData\Jotne EPM Technology AS\TruePLM_base\conf\
To configure a SSL/TLS connector, you will need to remove the comments and edit the item with port "8443" to look like this.
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="150" SSLEnabled="true" scheme="https" secure="true"
clientAuth="false" sslProtocol="TLS" keyAlias="plm"
keystoreFile="path/to/trueplm_org.jks" keystorePass="*******" />
Where keystoreFile is path to keystore file made in section B.2 and keystorePass is password specified in section B.1.
Port 8443 can be changed if it is needed. You may use value 443. It is default SSL/TLS port.
Configure EDMtruePLM web applicationWeb application can be configured by the system administrator via the following configuration file.
C:\ProgramData\Jotne\TruePLM_base\conf\EDMtruePLM\application.properties
Note, any changes in the configuration file require web application to be restarted (restart Tomcat) to apply changes.
SessionA user session is automatically closed after a certain time, if the system is idle without any activity. This period is default set to be 15 minutes.
session.timeout=15
But the value can be increased up to 720 minutes.