3 The default Port Number is 9087, and the default Administrator Port Number is Note that these port numbers MUST be different from the port numbers used by the first license. Also, if there is a firewall, similar to the case in the first license, these ports must be open on the server computer, client computers, and at the gateway nodes. 6. Click on Next to proceed to the dialog window Destination Folder, as shown below: Choose the destination folder. The default folder is c:\psimlicensemanager. The PSIM License Manager Administration program PLSGUI.exe will be placed in c:\psimlicensemanager, and the other files will be placed in the sub-folder License1 for the first license. Proceed with the rest of the installation. 7. After the installation is completed, the PSIM License Manager Administration program will be launched automatically, as shown below. Information of the first license will be shown on the left, and information of the second license will be shown on the right. Powersim Inc. 3 of 10 powersimtech.com
5 8. Based on the server ID, Powersim will generate a server license file. After receiving the server license file, run the PSIM License Manager Administration program PLSGUI.exe again. Click on Update License File, and select the file received from Powersim. After the license file is updated successfully, the license information will appear in the dialog. Click on Start Service to start the License Manager service. The status should show Status:Service is running. If the service cannot start, please do the following for troubleshooting: - Start a Command Prompt window. In the window, Change to the folder c:\psimlicensemanager\license1 and run the command line version of the License Manager program PSIMLM.bat. If there is an error message, please send the error message to Powersim for further support. If there is no error message, it means that the command line version works and the problem is with running the service. - If PSIMLM.bat works, the likely cause is that the Windows environment variable for Java is not set properly. Follow the steps below to set up the environment variable: - In Windows Explorer, right click on Computer and go to Properties >> Advanced system settings >> Environment Variables - In the System variables section, click on New. Set the following: Variable name Variable value.; CLASSPATH - In the System variables section, find the Path variable. Click on Edit, and add the actual path of the Java bin folder to the beginning of the Path variable. For Java 8 update 60 (64-bit), for example, the folder is c:\program Files\Java\jre1.8.0_60\bin. - Close any Command Prompt windows, and run PLSGUI.exe again and try to start the service. 9. Run the License Manager Management to monitor the license usage and perform other administrative tasks. Installing on Unix/Linux Operating Systems: 1. Dedicate a computer as the server computer to run the PSIM License Manager. 2. Make sure that the server computer has the Java SE Runtime Environment 8 or later already installed. If not, install Java SE Runtime Environment before installing the License Manager. Note that if Java is reinstalled after the License Manager is installed, the License Manager must be reinstalled. To find out the Java version, go to Control Panel >> Java.In the Java tab, click on View. Note that on a 64-bit computer, you should install the 64-bit version of Java. 3. Copy all the files in the PSIMLicenseManager_Linux installation folder, except the files in the folder ext, to a destination folder on the server computer (for example, c:\psim_licensemanager ). This folder is the PSIM License Manager folder. Copy the files in the sub-folder ext from PSIMLicenseManager_Linux installation folder to the folder javaruntime-directory\lib\ext on the server computer. If these files are required in the future, they may be found at this link: 4. Open the file psimserver.ini in the License Manager folder with a text editor. Choose two unused ports for the Port number and MonitorPort number. Port is used for communication for PSIM license, and MonitorPort is used for communication for the PSIM License Monitor. The default Port number is 8087, and the default MonitorPort number is If there is a firewall on the server computer, manually open these two port numbers assigned to Port and MonitorPort for UDP communication. Some firewalls may require the process or program name. Specify Java.exe and Javaw.exe as the process or program names. In addition, if server and client computers are on different sub nodes, manually open the two ports at the gateway nodes for UDP communication. 5. From the License Manager folder, run the License Manager interface program with the following command: Powersim Inc. 5 of 10 powersimtech.com
6 java -jar PSLicenseManagerGUI.jar psimserver.ini Read the Server ID from the License Manager, and send the ID to Powersim. Note that if you see an error message Error on openconnection timed out: connect, ignore this message. Exit the License Manager. Based on the Server ID, Powersim will generate and send you the license file psimserver.license. Place this file in the License Manager folder (for example, c:\sim9_licensemanager ). 6. Run the License Manager with the following command: java -jar PSLicenseManager.jar psimserver.license psimserver.log psimserver.ini 7. Run the License Manager interface program with the following command: java -jar PSLicenseManagerGUI.jar psimserver.ini This concludes the installation of the PSIM License Manager. The License Manager interface program (License Monitor) should show the license number, available licenses, and total licenses. Installing the PSIM Software: Note: Before installing PSIM, you should have received the PSIM license file psim.lic from Powersim. If there is a firewall on this computer, the two port numbers assigned to Port and MonitorPort (Administrator Port) must be opened for UDP communication. Some firewalls may require the process or program name. Specify psim.exe as the process or program name. Also, if the PSIM license includes the SimCoupler module, add matlab.exe ; and if the PSIM license includes the SmartCtrl software, add SmartCtrl.exe. 1. On a client computer, in the file folder installed from the download, run setup.exe, and follow the installation instructions. PSIM can be installed either on the local drive, or on a network drive which can be accessed by other PC s on the network. 2. In the window Select License Type, choose 3 - Softkey version. Then click on the button Select psim.lic file... to select the license file "psim.lic" received from Powersim. Then click on Next. 3. On the page Local Server Configurations, set the Server Port Number and the Server Monitor Port Number. The Port Number and the Monitor Port Number must be the same as corresponding Port and MonitorPort (Administrator Port) numbers as set in the PSIM License Manager Administration program on the server or, in Unix/Linux servers, in psimserver.ini file in Step 5 of the PSIM License Manager installation procedure. If default numbers are used for Port and MonitorPort, set Port Number to 8087, and Monitor Port Number to Server IP Is optional however, for large Networks or if Server and Client are in two different Subnets, it is highly recommended to add Server IP Address. In addition, if UDP broadcast messages are restricted in your network, you must enter the IP address of the server. If UDP broadcast is allowed, you can leave the Server IP Address blank and allow the installation to detect the server IP automatically. If setup fails to find the PSIM License Manager and there is a firewall on this computer, disable the firewall temporarily on this computer and try again. 4. If the PSIM License Manager is found, the page Choose Destination Location will appear. Click on Next to proceed with the rest of the installation. If the License Manager is not found, make sure that: (a) the client computer is connected to the network; (b) PSIM License Manager is running; and (c) the port number is entered correctly. Then select the license file psim.lic again. On the page Softkey License Manager Settings, set not only the Port Number and the Monitor Port Number, but also the Server IP Address (the IP address of the server computer that runs the PSIM License Manager). If the License Manager still cannot be found, and if the computer is running a firewall (including Windows firewall), disable the firewall temporarily, and repeat the steps again. After the installation is completed, enable the firewall, and add the PSIM executable programs (PSIM.exe, Simview.exe, SmartCtrl.exe) to the firewall exception. 5. After the installation is complete, if your license does not include the MagCoupler or MagCoupler-RT Module, skip this step. Otherwise, in PSIM, go to Options >> Set Path and add JMAG folder to the PSIM search path. For Powersim Inc. 6 of 10 powersimtech.com
7 example, if JMAG is in c:\program files\jmag-designer13.0, add this folder to the PSIM search path. 6. If PSIM is installed on a network drive, PSIM online help will not work due to Windows securities. Please copy the file "PSIM.chm" from the network drive to a folder in the local drive, for example "c:\psim". Then launch PSIM, and in Options >> Settings >> Advanced, check the box "Use alternate PSIM help file path", and click on the button... to select the file "c:\psim\psim.chm". This concludes the installation of the PSIM software. For additional information on installing and running PSIM, please refer to the file readme.pdf which is located in the doc folder in the PSIM installation folder. Installing PSIM in the Silent Mode To install PSIM on client computers in the silent mode through a command line window, first make sure that the following 3 files are in the same folder: Setup executable file (for example, setup_x64.exe ) psim.lic psimclient.ini The file psimclient.ini defines the Port Number, Monitor Port Number, and the server IP address (if necessary). For example, the psimclient.ini file may contain the following: [CLIENT] Port=8087 MonitorPort=8088 ServerIP= Then launch a command line window. From the command line window, change the folder to the folder where the three files are located. Then type the following command: setup_x64.exe /verysilent /dir= c:\powersim\psimx64 This will run the setup setup_x64.exe, and install PSIM to the destination folder c:\powersim\psimx64. Instead of the option /verysilent, one can use the option /silent which will give error messages if there are errors in the installation process. Running License Monitor To monitor the license usage of the PSIM Softkey Network version, (including modules in use), run the License Monitor from the Start menu, or LicMonitor.exe from the PSIM folder. The link to download License Monitor is License Monitor displays the license number of the network version and also displays the following information: - User Name: name of the user - IP Address: IP address of the computers that are running PSIM - Usage Time: the total time that the license has been in use - Modules: modules in use Restricting License Access To restrict license access, modify the file Psimserver.ini located in \PSIMLicenseManager\License1 folder. To restrict by IP Address, add the key ValidClientIPs and list all valid IP addresses separated by a comma. that wild cards * are not allowed. To remove this restriction, remove or comment out ValidClientIPs. Please note To restrict by computer, run ComputerID.exe from the PSIM folder on each computer and add the Computer IDs to ValidMACs separated by a comma. To remove this restriction, remove or comment out ValidMACs. Powersim Inc. 7 of 10 powersimtech.com