Removing EDM license and EDM_HOME_
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 variables
Appendices
EDM6ServerConsole system
EDM6ServerConsole 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: EDM6ServerConsole configuration
Installing 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".
Figure 21. Starting the command prompt as an administrator
This will open the administrator command window.
Figure 22. Administrator command prompt
Go 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 installation
This 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.
Starting the EDM6ServerConsole
Start 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.
Figure 24. Error from EDM6ServerConsole
The 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:
EDMSix server and application server executables
EDMserver runtime configurations
EDM database configuration.
Through this application you can create, delete, start, and stop solutions based on EDMsix server and application servers.
EDM6ServerConsole GUI
For configuring the EDM6ServerConsole open the "Tools" → "Application settings" menu item.
Figure 25. EDM6ServerConsole main window
Note: 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.
Common settings
Figure 26. Common settings
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.
Console settings
Figure 27. Console setting
The console setting allows the user to adjust how the EDM6ServerConsole behaves.
Application settings
This tab will allow you to configure the behaviour of the EDM6ServerConsole GUI.
Appearance
This 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).
Service crash settings
The service settings are explained below.
Auto restart setting
The 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.
Figure 28. Auto restart solution
Email notification
EDM6Service 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 notification
Start Solution
A 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 solution
Backup
Database 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. Backup
Memory usage check
This option should be switched off.
Figure 32. Memory usage check
Solution configuration
A 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.
Figure 33. Database drop down list
After setting the above details, the solution can be started manually by clicking the "Start" button.
Notes:
It is not possible to edit or remove components of a solution when the solution is running. The corresponding menu item is displayed in grey if the user cannot do this action.
Each configuration of a component is identified by a user defined name.
Server tab
The server tab lists all available servers (see Figure 34).
Figure 34. List of all available server configurations
In 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.
Figure 35. Server tab popup menu item
Adding a new EDMserver executable
To create a new configuration, click on "Add new edmserver" (see Figure 36).
Figure 36. Add new EDMserver
Give 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.
Editing EDMserver executables
To 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.
Figure 37. "Edit edmserver" configuration
Deleting EDMserver executables
To delete a configuration, select the configuration item and click on the "Delete EDMserver executables" menu item.
Configuration tab
The configuration tab lists all the available runtime settings for the EDMserver and EDMappservers; see Figure 38.
Figure 38. Configuration tab
To 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.
Figure 39. Configuration tab menu
Add new EDMserver configuration
To 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.
Figure 40. New EDMserver configuration
Name: Name of the configuration
Port: EDMserver port number
Make sure that the firewall on your system has the correct inbound and outbound rules for the edmserver.exe and edmappserver.exe applications and their ports.
The ports used for EDM depend on the given port number. The edmserver.exe application will use the given port number and the edmappserver.exe will use the subsequent port numbers. E.g., if you enter port number 9090, edmserver.exe will use this port number and the first edmappserver.exe will use port number 9091, the second will use 9092 etc.
Application server count: The number of running EDMappservers.
We recommend to set the number to be 4 or 5 application servers.
App server tmp directory: Temporary folder for all EDMappservers.
EDM logon method: Different methods for login into the EDM system.
Server client files path: Path for client files on EDMsixServer side.
User creation method: How EDMserver will create EDM users.
Extended name character set: Additional legal characters that can be used inside an EDMserver database.
Backup first start time: Defines day of week and time when the first backup will be done. Blank day of week means "today".
Backup interval: Defines backup interval in days, hours and minutes between the start of two backup processes (this interval does not count the time spent on backup).
Additional argument: Providing additional EDM configuration statements.
The given string will be added to the EDMsixServer command line arguments without any modifications. As an example: "-ae EDM_SERVER_CLIENTS_FILES_PATH_UTF8_ENCODED=path".
Appserver additional arguments: Add arguments specifically for the appserver.
The given string will be added to the EDMsixAppServer command line arguments without any modifications.
Editing an EDMserver configuration
To 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.
Figure 41. Edit EDMserver configuration
Deleting an EDMserver configuration
To delete a configuration, select the configuration item and click on the "Delete EDMserver configuration" menu item.
Database tab
The database tab lists all available EDM databases, see Figure 42.
Figure 42. Database configurations
The "Database" menu item or the Database tab context menu allows to create, add, remove (from EDM6ServerConsole) and delete (from disk) databases.
Figure 43. Database menu items