Pointwise and RLM Help Guide

Thank you for coming to us with your questions and concerns. Many of our most commonly asked questions and solutions can be found here to help troubleshoot any issues you may encounter.

If you don't see the solution or answer you need, feel free to send us a description of the problem using the Ask for Help form or by calling us at 800-4PTWISE. One of our knowledgeable support engineers will help you get the answers you need.

Pointwise

The latest version of Pointwise can be downloaded from: http://www.pointwise.com/downloads.

On Windows platforms, you should install Pointwise as Administrator/root. If you have administrator privileges, you can right-click the Pointwise installer file and select Run as Administrator.

On Linux and Mac platforms, you can install as a user or as Administrator/root.

When Pointwise is installed on a client machine and started, it looks at the local area network to see if there is a Reprise License Manager (RLM) server currently “broadcasting” on that network that contains a valid Pointwise license. If there is, Pointwise automatically connects to that server.

In certain situations, you may wish to connect to a specific RLM server running Pointwise. To do so, use the following steps:

  1. Open Pointwise.
  2. File, License, Launch License Wizard
  3. Select Specify a License Server.
  4. Click Next.
  5. Enter the name of the license server and its RLM port.
  6. Click Next.
  7. Click Finish.

If Pointwise cannot find a license server in Step 1, the Pointwise License Wizard will launch automatically. Simply follow the remaining steps outlined above.

Yes, you can borrow processes from your main license server. This is most often necessary in the situation where you need to take a laptop with you while you are on a short-term trip. To borrow a process of Pointwise, use the following steps:

  1. On your laptop, connect to the same local area network (LAN) as your license server.
  2. Open Pointwise.
  3. File, License, Roam
  4. In the Roam License frame, enter the Number of Days you wish to borrow a process of Pointwise.
  5. OK
  6. You will see a message in the Messages window stating that a roaming license was obtained for Pointwise and will expire in the number of days you specified in Step 4.
  7. Disconnect your laptop from the LAN.
  8. Run Pointwise.

Note the maximum number of days that you can borrow a process is 30 days. In the Pointwise interface, this will be displayed as 31 days because each day is counted until midnight. For example, if you chose to borrow a process for 15 days, the first day would end at midnight on the day you borrowed the process.

For more information on how license roaming works for the Reprise License Manager (RLM), please refer to the RLM license administration documentation available at: http://www.reprisesoftware.com/RLM_License_Administration.pdf.

Returning your borrowed Pointwise process before it expires takes just a few simple steps:

  1. On your laptop, connect to the same Local Area Network (LAN) as your license server.
  2. Open Pointwise.
  3. File, License, Return
  4. You will see a message in the Messages window stating that a roaming license was returned early.

Note: When a license is borrowed (or roaming), it depends on the version of the license file on the license server remaining fixed. If that file is changed, it can prevent the early return of a borrowed process. For more information, please refer to the RLM license administration documentation available at: http://www.reprisesoftware.com/RLM_License_Administration.pdf.

Pointwise is currently unsupported for remote execution. Most remote execution approaches do not have the graphics support necessary for Pointwise to function properly. For best results, we recommend that you install Pointwise locally on your workstation and use your remote server only for licensing.

We have received reports of customers making Pointwise work through remote execution but typically it is at a large performance penalty. If you wish to attempt remote execution of Pointwise, here are some platform-specific recommendations that may help you.

Windows

If Pointwise was installed on a Windows machine and you are trying to execute it remotely from that machine there are two methods or tools that might work:

Remote Desktop Connection

  1. On your workstation, click Start.
  2. Type Remote Desktop Connection and enter the connection details for your remote Windows machine.
  3. Click Connect.
  4. On the remote Windows machine, click Start.
  5. Type cmd.
  6. When the cmd command and icon appear, right-click on the icon and select Run as Administrator.
  7. Type query session.
    • Note the ID for the console session. You will need it for the next command.
  8. Type tscon sessionID /dest:console where sessionID is the ID noted in the previous step.
  9. Type start $PointwiseHome\win64\bin\Pointwise.exe where $PointwiseHome is your installation directory for Pointwise.
    • This step may terminate your connection with the remote machine. However, Pointwise should be running when a new remote connection is established.

VNC Server

VNC Servers typically provide sufficient resources to run Pointwise remotely. TightVNC has been used successfully to run Pointwise remotely on Windows.

Linux/Mac

VirtualGL

In general, remote display of Pointwise from a Linux workstation is impossible without VirtualGL or similar software that gives Linux remote display software the ability to run OpenGL applications with full 3D hardware acceleration.

Instructions on how to download, install, and configuration of VirtualGL is available on the VirtualGL documentation page.

If you install VirtualGL and still experience issues running Pointwise remotely, check the below list of potential issues and solutions to see if they solve your problem:

  • Out of Date GPU Drivers: We recommend you first have the latest proprietary drivers for your GPU installed.
  • Running Headless: If your host machine is running headless (without a monitor), you may need to configure your drivers to run in a headless mode for VirtualGL to properly connect. The instructions below are for Linux machines running with NVIDIA graphics hardware and proprietary drivers. If you are using a graphics card from a different manufacturer, please consult their documentation for the relevant steps.
    1. sudo nvidia-xconfig -a --use-display-device=None --virtual=1280x1024
      • -a Configure an X screen on every GPU in the system.
      • --use-display-device=None Force the X driver to use the display device "None"
    2. sudo init 3
    3. sudo init 5
  • Shader Issues: Your graphics card could be having issues with the display of shaders. You can try running Pointwise with no shaders: ./pointwise –noshaders

If none of these suggestions have resolved your issue, it may require further debugging. Please run Pointwise with the following arguments and send the output to support@pointwise.com.

./pointwise –m -vgl

Pointwise supports the most popular desktop workstations in use today by CAE engineers. The application supports each platform's native look-and-feel and provides 3D graphics through the OpenGL industry standard. Pointwise's native project file is portable across all supported platforms.

Pointwise currently supports Windows, Linux, and Mac OS X 64-bit systems. For more information about the minimum requirements for each of those platforms, please see our Supported Platforms page.

Reprise License Manager (RLM)

This RLM troubleshooting guide provides a quick reference to common questions Pointwise has received from our customers about our new license manager. This resource should not be seen as a comprehensive guide to using the Reprise License Manager. If you need detailed information about how to administer RLM on your server, you should use the RLM License Administration guide provided by Reprise Software.

The version of RLM used by Pointwise can be downloaded from: http://www.pointwise.com/downloads

On Windows platforms, you should install Pointwise as Administrator/root. If you have administrator privileges, you can right-click the RLM installer file and select Run as Administrator.

On Linux and Mac platforms, we recommend that you do not install as Administrator/root.

An activation key is a 16-digit numeric string that the Reprise License Manager (RLM) installed on your machine will use to contact Pointwise. The expiration date and number of processes of Pointwise for your license server are encoded in this key.

Once an activation key is entered during the RLM installation process, your workstation sends its Host Name and Host ID to the Pointwise license server. A text-based license file is generated based on your workstation information, expiration date, and number of processes of Pointwise for your site. It is sent back to your workstation, installed, and the Pointwise license server started automatically for you.

Caution should be exercised when using your activation key. Install RLM and enter the activation key only on the machine that you intend to be your license server.

A license file is a text-based file that contains the following:

  • License server host name
  • License server host ID (ethernet address)
  • ISV for the license (Pointwise's ISV is PWID)
  • Product and Product Version
  • Process expiration date
  • Number of processes
  • Customer ID
  • License signature

When you install RLM on a machine and enter your activation key, it contacts the Pointwise Activation Key server and requests a license file. This license file is then installed in your RLM server and the server started automatically.

For customers who complete the Pointwise license request form, Pointwise will send a license file instead of an activation key. This will be necessary for customers with a secure network or a workstation that has no internet connection.

You can request an activation key by completing the license request form at: http://www.pointwise.com/licenses.

You can request a license file if you have a machine without an internet connection or if you are on a secure network that will not allow activation keys.

  • Go to the license request form at: www.pointwise.com/licenses.
  • Enter your activation key (if you were sent one), hostname and host ID of your license server machine.
  • Finish completing the form and submit it.
  • Pointwise will send you a license file within 24 hours of your submission.

The Reprise License Manager (RLM) is installed with a license administration webpage that will assist you in finding your server information.

  1. Install RLM from: http://www.pointwise.com/downloads/rlm.html.
  2. Go to the RLM License Administration webpage in your favorite web browser:
    • Windows: Start, All Apps, Pointwise, RLM License Administration.
    • Linux/Mac: Enter the URL http://localhost:5054/ where localhost is your existing license server machine name.
  3. Click System Info on the left toolbar.
  4. Record the host name displayed at the top of the page.

    Example: RLM Info for System: MyHostName
  5. Record the Ethernet address listed under Hostids. If there are multiple Ethernet addresses, only record the first one.

Please see our instructions on how to update an activation key below under the Pointwise and RLM Installation Help heading.

Please see our instructions on how to update a license file below under the Pointwise and RLM Installation Help heading.

There are a several reasons why your activation key may not be working:

  • You may not be connected to the internet. Open a browser to www.pointwise.com to check your internet access.
  • You may be entering your activation key in the wrong location. Your activation key should be entered in one of two places:
    • When you are installing RLM, you'll enter it on the Configure Pointwise RLM License Server screen, or
    • When you are updating your RLM server, you'll run the Pointwise License Wizard and enter the activation key.
  • You may have a firewall blocking the port (80) used by the activation key server to send your license file.
    1. Cancel the RLM installation.
    2. Open port 80 in your firewall.
    3. Install RLM with your activation key.
  • You may have a proxy server that is interfering with the activation process.
    • On Windows systems, proxy server settings are automatically detected and used by the RLM installer during activation.
    • On Linux and Mac workstations, there is an environment variable for a proxy server that will need to be set for activation to work properly.
      • HTTP_PROXY = MyProxyHost:1234

        where MyProxyHost and 1234 are your Proxy Server name and port.
    • Additionally, if your proxy server uses authentication, you will have to set an additional environment variable to pass the credentials to the proxy server. Please note that RLM activation only supports the BASIC authentication type for proxy servers.
      • HTTP_PROXY_CREDENTIALS = ProxyUsername: ProxyUser_Password

        where ProxyUsername and ProxyUser_Password are your username and password for the proxy server.
  • If these solutions do not work for you, please complete the license request form. Provide us with your server's host name and host ID and an alternative license type will be sent to you in place of your activation key.

  1. Go to the RLM License Administration webpage in your favorite web browser:
    • Windows: Start, All Apps, Pointwise, RLM License Administration.
    • Linux/Mac: Enter the URL http://localhost:5054/ where localhost is your existing license server machine name.
  2. Click Shutdown on the left toolbar.
  3. In the ISV pull-down, select PWID.
  4. Click SHUTDOWN.

The RLM server is automatically started for you at the end of the RLM installation process. If the RLM server is shut down for some reason, you may need to be able to start it up again yourself. Follow these steps for your platform to restart it:

Linux

  1. Navigate to $RLM_Installation_Directory/linux_x86_64/.
  2. Enter ./rlm_control.sh start (Starts the RLM license server.)
  3. Enter ./rlm_control.sh status (Checks if the license server is running.)

Mac

  1. Navigate to $RLM_Installation_Directory/macosx/.
  2. Enter ./rlm_control.sh start (Starts the RLM license server.)
  3. Enter ./rlm_control.sh status (Checks if the license server is running.)

Windows

  1. Go to Start, Run.
  2. Enter services.msc.
  3. Right-click Pointwise RLM License Server in the list of services.
  4. Select Start.

Note: If you did not find Pointwise RLM License Server in the list of services on your Windows machine, it may have not been started because of a failed or aborted installation. In this situation, try uninstalling and reinstalling RLM. If that does not work, please contact support@pointwise.com for further assistance.

Please see our instructions on how to set up redundant servers for RLM below.

The activation key uses an internet connection to contact Pointwise's servers and request a license file based on your workstation's host name and host ID (Ethernet address). If your system does not have an internet connection or is on a very secure network, you will be unable to use an activation key.

In these situations, Pointwise will provide you with a text-based license file which you can install on the license server. You can request one of these license files by completing our license request form. You will be asked to provide your activation key (if you were provided one), host name and host ID for the license server at that time.

Pointwise V18 will only run with the Reprise License Manager (RLM). If you are moving to Pointwise V18 from V17, you will need to download and install the new RLM server to run the latest Pointwise. This RLM server will not run versions of Pointwise prior to V18.

Instructions on how to install RLM and Pointwise V18 can be found at: www.pointwise.com/downloads.

Pointwise V17 will only run with the FlexNet license manager. This version of Pointwise cannot be served a license from the Reprise License Manager (RLM).

Gridgen V15.18 will only run with the FlexNet license manager. Gridgen cannot be served a license from the Reprise License Manager (RLM).

Here is a list of the ports that the Reprise License Manager (RLM) uses:

  • Port 5054 – RLM License Administration webpage
  • Port 5053 – RLM server
  • Port 80 – RLM Key Activation
  • One additional port will be randomly chosen at launch for each ISV you are running with RLM.

If you need to explicitly set your ISV port number you can do so by modifying your license file in the RLM License Administration webpage. Additionally, you can also modify your RLM port number. The additional port number flags for the RLM server and ISV are colored below in green and red respectively:

   

SERVER myservername 685b35cb4866 5053
      ISV pwid port=9876

   

LICENSE pwid pointwise 18.0 30-apr-2016 1 customer=PWI-55-55
      issued=17-mar-2016 _ck=26d6c7a734 sig="60PG452H5GXE62VQJ27BVMC6KB5M
      AYACC4H8U2G22M0CKNA4N549UTFD9BB417J7NMAGASHYHMP0"

Pointwise and RLM Installation Help

  1. Download Reprise License Manager (RLM). Complete RLM installation files can be downloaded from our downloads page.
  2. Install the RLM license manager.
  3. Run RLM installer.
    1. IMPORTANT: Install Pointwise as Administrator/root on Windows machines.
    2. Accept the Right-to-Use license and use all defaults for the installation.
    3. If you have an Activation Key, copy and paste it into the Activation Key field when you reach the Configure Pointwise RLM License Server screen.
    4. If your Activation Key does not work or you need an Activation Key, please contact support@pointwise.com.
  4. Review the status of your RLM license manager.
    1. Start your web browser and open http://localhost:5054/ where localhost is your computer's name. This is the Reprise License Manager (RLM) user interface page.
    2. On the left side of the web page, click on the Status button.
    3. You should now see an ISV (Independent Software Vendor) program name PWID listed as running.
    4. If you do not, please contact support@pointwise.com
  5. Download Pointwise. The current production release of Pointwise can be downloaded from our downloads page.
  6. Install Pointwise.
  7. Run the Pointwise installer.
    1. IMPORTANT: Install Pointwise as Administrator/root on Windows machines.
    2. Accept the Right-to-Use license and use all defaults for the installation.
    3. Pointwise should launch after you click Finish.
    4. If Pointwise cannot find the RLM license server automatically, the Pointwise License Wizard will appear.
    5. Select Specify a License Server and enter the name of your server.
    6. Click Next then Finish.

Workstations that do not have an internet connection or are on a network which blocks access to the Pointwise RLM Activation Server may need a license file to start the RLM license server. These steps will walk you through the process needed to do a first-time installation of the license server and Pointwise in this scenario:

  1. Go to www.pointwise.com/downloads/pointwise-and-rlm.html.
  2. Download and run the RLM installer in Step 1.
  3. At the Configure Pointwise RLM License Server screen, make sure the Activate Pointwise License option is unchecked. Without an internet connection or on a secure network, an activation key cannot be used.
  4. Click Next then Finish.
  5. The RLM License Administration page should open in your web browser. If it does not open automatically, please go to: http://localhost:5054/.
  6. Click on System Info on the left toolbar.
  7. At the top of the page, record the host name of your workstation that is listed.

    Example: RLM Info for System: MyWorkstationHostName

    If you need to get the host name from a command line, please use the command hostname.
  8. Record the Ethernet address listed for your workstation under the Hostids header.

    For systems with multiple host IDs, note the first host ID listed. This host ID may differ from the one used for FlexNet (or other license managers). Please record the host ID reported in the RLM License Administration webpage.

    If you need to get the host ID from a command line, use one of the following commands:

    Windows

    Navigate to $Pointwise_Install_Directory/win64 and enter the command:

    rlmutil.exe rlmhostid –ether

    Linux/Mac

    Navigate to:

    $Pointwise_Install_Directory/linux_x86_64 (Linux)

    $Pointwise_Install_Directory/macosx (Mac)

    Enter the command: ./rlmutil rlmhostid –ether
  9. You should have already received a license file from Pointwise. If you have not, go to https://www.pointwise.com/licenses and complete the form.
    1. Enter the host name and host ID you recorded in Steps 7 and 8 respectively.
    2. Submit the completed form.
    3. You should receive an email from Pointwise within 24 hours with a license file attached.
  10. Go to the RLM License Administration webpage (http://localhost:5054/).
  11. Click Edit License File on the left toolbar.
  12. Click Edit License File.
  13. Press Enter after typing pointwise_license.lic into License File to create or edit.
  14. Paste the contents of the license file you received from Pointwise into the text box.
  15. Click Update License File.
  16. Click Reread/Restart Servers.
  17. Push the Reread/Restart button.
  18. Click Status on the left toolbar to ensure that the Pointwise license server is now running.
  19. Download and install Pointwise using Steps 4-5 at www.pointwise.com/downloads/pointwise-rlm.html.
  20. Run Pointwise.

These instructions are for workstations that have an internet connection or are on a network with internet access that already have the Reprise License Manager (RLM) and Pointwise V18 installed. These steps will walk you through the process needed to activate or update a license:

Windows

  1. If you do not already have an activation key, please go to www.pointwise.com/licenses/ and request one. You will receive an activation key from Pointwise within 24 hours that will be of the form: 1234-1234-1234-1234.
  2. From the Start menu, choose All Apps, Pointwise, RLM Update Activation Key. Please note you will need administrator privileges to use this tool.
  3. Enter the activation key in the Pointwise Activate License wizard and click Activate.
  4. You should receive a message that says:
  5. Click Finish.

Mac

  1. If you do not already have an activation key, please go to www.pointwise.com/licenses/ and request one. You will receive an activation key from Pointwise within 24 hours that will be of the form: 1234-1234-1234-1234.
  2. Navigate to $RLM_Install_Directory/Pointwise/RepriseLicenseManager/macosx and double-click the Pointwise Activate Wizard icon.
  3. Enter the activation key in the Pointwise Activate License wizard and click Activate.
  4. You should receive a message that informs you of successful key activation.
  5. Click Finish.

Linux

  1. If you do not already have an activation key, please go to www.pointwise.com/licenses/ and request one. You will receive an activation key from Pointwise within 24 hours that will be of the form: 1234-1234-1234-1234.
  2. Navigate to $RLM_Install_Directory/Pointwise/RepriseLicenseManager/linux_x86_64 and double-click the Pointwise Activate Wizard icon.
  3. Enter the activation key in the Pointwise Activate License wizard and click Activate.
  4. You should receive a message that informs you of successful key activation.
  5. Click Finish.

These instructions are for workstations that do not have an internet connection or are on a network with limited internet access that already have the Reprise License Manager (RLM) and Pointwise V18 installed. These steps will walk you through the process needed to update your license file:

  1. Go to the RLM License Administration webpage in your favorite web browser:
    • Windows: Start, All Apps, Pointwise, RLM License Administration.
    • Linux/Mac: Enter the URL http://localhost:5054/ where localhost is your existing license server machine name.
  2. Click Edit License Files on the left toolbar.
  3. Select your existing Pointwise license file from the License File to Edit pull-down.
  4. Click Edit License File.
  5. Open the new license file you received from Pointwise in a text editor.
  6. Copy the contents of the new license file.
  7. In the Edit license file webpage, replace the existing Pointwise license file text with the new license file text you copied.
  8. Click Update License File.
  9. Click Reread/Restart Servers on the left toolbar.
  10. In the ISV pull-down, select PWID.
  11. Click REREAD/RESTART.
  12. Your license file has now been updated and the server restarted based on it.

A redundant server configuration allows you to have a failover (or secondary) license server in the event that your primary license server fails. These steps will walk you through the process needed to install and start RLM on a redundant server configuration.

Request License Files

If you do not have license files for your primary and secondary servers, use the below steps to request them. If you already have both of your license files, please skip ahead to Installation..

  1. Go to www.pointwise.com/downloads/pointwise-and-rlm.html.
  2. Download and run the RLM installer in Step 1. Important: Install RLM as Administrator/root on Windows machines.
  3. At the Configure Pointwise RLM License Server screen, make sure the Activate Pointwise License option is unchecked. For a redundant configuration, you will need to install a license file on each server instead of an activation key.
  4. Click Next then Finish.
  5. The RLM License Administration page should open in your web browser. If it does not open automatically, please go to: http://localhost:5054/.
  6. Click on System Info on the left toolbar.
  7. At the top of the page, record the host name of your workstation that is listed.

    Example: RLM Info for System: MyWorkstationHostName.

    If you need to get the host name from a command line, please use the command hostname.
  8. Record the Ethernet address listed for your workstation under the Hostids header.

    For systems with multiple host IDs, note the first host ID listed. This host ID may differ from the one used for FlexNet (or other license managers). Please record the host ID reported in the RLM License Administration webpage.

    If you need to get the host ID from a command line, use one of the following commands:

    Windows

    Navigate to:

    $Pointwise_Install_Directory/win64

    Enter the command: rlmutil.exe rlmhostid –ether

    Linux/Mac

    Navigate to:

    $Pointwise_Install_Directory/linux_x86_64 (Linux)

    $Pointwise_Install_Directory/macosx (Mac)

    Enter the command: ./rlmutil rlmhostid –ether
  9. Go to www.pointwise.com/licenses and complete the form for the primary and secondary servers.
    1. Enter the host name and host ID you recorded in Steps 7 and 8 for the primary and secondary servers.
    2. Submit the completed form.
    3. You should receive an email from Pointwise within 24 hours with a license file attached.

Installation

When you have the license files for your primary and secondary servers, use these steps to install them:

  1. Open the license file for your secondary server with a text editor.
  2. Find this text in the license file:

    _primary_server=5053@localhost

    Replace it with this text:

    _primary_server=5053@MYSERVER

    where MYSERVER is the name of your primary server.
  3. Save the secondary server license file.
  4. Place a copy of both the primary and secondary license files in

    $RLM_Install_Directory/licenses on both servers.
  5. In $RLM_Install_Directory, start RLM on the primary and secondary servers using the following command:

    ./rlm_control.sh start
  6. On all Pointwise client computers, users must copy the two license files into the $Pointwise_Install_Directory/<platform>/bin folder. If you do not wish to place the full license files on each client computer, simplified license files can be used instead:

    Example
    File: my_primary_server.lic
    Contents: HOST NameOfMyPrimaryServer

    File: my_secondary_server.lic
    Contents: HOST NameOfMySecondaryServer

Ask for Help

In addition to the offer cited above, by submitting this form, you are giving Pointwise, Inc., 213 S. Jennings Avenue, Fort Worth, Texas, 76110, U.S.A. (www.pointwise.com) permission to add you to our mailing list. You will receive This Week at Pointwise and other emails about Pointwise activities and other CFD events like webinars, user group meetings, training courses, etc. You may revoke your permission at any time by emailing unsubscribe@pointwise.com with your request.