Installation

This page details pSeven system requirements and installation process.

Before Installation

Before you begin, check that the system where you intend to install pSeven satisfies the requirements. If an older version of pSeven is already installed on the target system, also see Upgrading from Older Versions.

System Requirements

pSeven is a cross-platform application. Supported platforms include:

  • Microsoft Windows 7 or later, 64-bit editions.
  • Various x86-64 (AMD64) Linux distributions.

Minimum hardware requirements for both the Windows and Linux versions are:

  • 2 GHz Intel or AMD processor.
  • 4 GB RAM.
  • 2 GB disk space.
  • 1280×1024 screen resolution.

Recommended hardware to run pSeven is:

  • 3 GHz Intel Core i7 CPU.
  • 32 GB RAM.
  • 10 GB disk space.
  • FullHD screen resolution.

Operating system requirements for the Windows version:

  • Microsoft Windows 7/8/8.1/10 (64-bit edition).
  • For the OpenGL mode only: OpenGL 2.1 support.

Corresponding server editions of Windows like Server 2008, Server 2012, and so on are not tested specifically, though should work as well. Versions prior to Windows 7 are not supported.

Operating system requirements for the Linux version:

  • Linux kernel 2.6.32 or newer.
  • GNU C library (glibc) 2.12 or newer.
  • GLib library (libglib2) 2.28.8 or newer.
  • For the graphical user interface:
    • X Window System (X11).
    • X protocol C-language Bindings (XCB) library (libxcb) 1.11 or newer.
    • libGL library (libGL) 11.0.7 or newer.
    • For the OpenGL mode only: OpenGL 2.0 support.
  • Linux Standard Base 3.0 or higher compliant distribution is recommended.

Linux version shall work in any Linux-based OS, provided that it satisfies the requirements above. Specifically tested distributions include CentOS 6.7 and Ubuntu 12.04 (64-bit versions).

LSB 3.0 or higher is recommended for the native support of the pSeven licensing modules. In most cases, however, pSeven works without it, using non-LSB system libraries for replacement. LSB support packages can be installed from system repositories, for example:

  • Red Hat family (CentOS, RHEL and others): sudo yum install redhat-lsb.i686.
  • SUSE Linux: sudo zypper install lsb.
  • Ubuntu family and other Debian-based distributions: sudo apt-get install lsb.

A command line version of pSeven (p7batch) can also run in a Linux system without graphical environment. This version does not support editing or creating projects but can be used to run existing workflows.

System Configuration Notes

Certain system configuration changes may be required in order to run pSeven. This section describes the cases that require you to apply such changes manually.

Network Licenses

If you are going to use a floating (network) license, the license server IP address and connection port have to be specified in the DATADVD_LICENSE_FILE environment variable. By default, this variable is set by the pSeven installer (see License Setup). If you skip this step during installation, you will need to set DATADVD_LICENSE_FILE manually: see section Client Configuration in Server License Registration for configuring pSeven to connect to a license server.

Note that setting DATADVD_LICENSE_FILE is not needed if you use a local license file: in this case, even after installation, you can simply copy the license file to the pSeven installation directory or the pSeven workspace directory, and it will be found automatically (see Standalone License Registration for details).

See also

Licensing System
More details on pSeven license types.

Windows Temporary Files Directory

In Windows, some pSeven components may have issues with temporary files they need to create, if the path to the user’s directory for temporary files contains local language characters (non-English characters). In many cases, problems are caused by an incorrectly configured system locale. However, some issues cannot be resolved even if the system locale is set correctly. Due to this, in mixed language Windows environments it is recommended to configure user temporary files directories in such a way that their paths include only English characters, which prevents possible issues. You can also apply these configuration changes after installing pSeven (there is no need for re-installation).

See also

Using pSeven in Localized Windows
Known issues with local language characters in paths used by pSeven.
FAQ: Why pSeven does not work properly in localized Windows?
Configuring localized Windows versions to run pSeven.

Antivirus and Firewalls

If pSeven is installed on a system protected with an antivirus or a firewall, you may need to add pSeven to the antivirus exclusion list or add firewall rules allowing connections to the pSeven’s license server.

See also

FAQ: Do antiviruses, firewalls, network or proxy settings affect pSeven?
Configuring antivirus and firewalls after pSeven installation.

Siemens NX integration

If you install pSeven on a Linux system and intend to use the NX block for Siemens NX integration, the Siemens NX library path must be added to LD_LIBRARY_PATH. In Siemens NX versions supported by pSeven, this path is:

  • NX_dir/ugii for Siemens NX 10, and
  • NX_dir/nxbin for Siemens NX 11,

where NX_dir is the Siemens NX installation directory.

See also

NX: Known Issues
Known issues with the NX block.

PTC Creo integration

If you intend to use the PTC Creo integration block, note that it requires PTC Creo installed with Visual Basic API support. This component is found under API Toolkits in the PTC Creo setup. Also, the PRO_COMM_MSG_EXE environment variable must contain a correct path to the Creo environment file, pro_comm_msg.exe.

See also

Creo
The Creo block page.

Upgrading from Older Versions

It is recommended to remove the currently installed version of pSeven prior to upgrading to a new version. Default uninstaller included in pSeven package does not remove user files and settings, so the data will be available after completing the upgrade.

The uninstaller is started by a shortcut in the system menu created during installation.

Version Compatibility

pSeven keeps backward compatibility for projects. Project compatibility means if you are working in a recent version of pSeven, you can open and edit projects created in older versions, and the projects will keep their data and settings.

When you open an older project for the first time, it is automatically updated to the new version format. This process is called a project upgrade. You can also run the upgrade manually using the File ‣ Upgrade project… menu command. Manual upgrade does not require you to open the project.

Please note that there is no forward compatibility support: a project created in a newer version of pSeven can not be opened with an older one. It also means that an upgraded project becomes incompatible with its original (older) version of pSeven.

It is always recommended to create backup copies of your projects before an upgrade, especially if you are not very familiar with maintaining projects from different versions, or you are unsure about the consequences of the upgrade.

Installation Guide

This section provides a walkthrough to download and install pSeven. If you are installing pSeven for the first time, see section System Requirements first to verify that your system supports pSeven. If you are updating pSeven from an older version, check section Upgrading from Older Versions.

Download

pSeven comes as an executable installer both for Linux and Windows platforms. After you launch the executable, a setup wizard will guide you through the process, installing pSeven in a specified directory.

To get the installer, visit the download page. Note that downloads are available only to registered users, so you will be required to log in first. If you do not have an account at DATADVANCE yet, please register.

The DATADVANCE downloads page will automatically determine your platform and redirect you to a corresponding download section. Download the installer and save it to a temporary location. All files required to install pSeven are packed into the installer executable, so Internet connection is not required at the time of installation.

Setup

The installer is named pSeven-6.16.2-windows-x64-installer.exe for Windows and pSeven-6.16.2-linux-x64-installer.run for Linux. When launched, it starts a setup wizard.

Note

If you install pSeven for Windows and the installer does not start, see FAQ: Why installation does not start in localized Windows?

Note

Windows antiviruses with real-time protection can significantly slow down pSeven installation. It is recommended to temporary disable on-access scanning while you are installing pSeven. See also FAQ: Do antiviruses, firewalls, network or proxy settings affect pSeven?

Note

Linux users may need to set execute permission for the downloaded installer before launch. Open a terminal from the directory where the download is saved and use the following command:

$ chmod +x pSeven-*-installer.run
../_images/page_support_install_01_start.png

The setup wizard shows a welcome screen first. Click b_system_next to continue to the license agreement.

License Agreement

To continue with the installation, you have to accept the license agreement.

../_images/page_support_install_02_eula.png

If you agree with the terms, select “I accept the agreement” and click b_system_next to continue.

Upgrade Notice

Prior to copying files, the installer asks you to verify that there are no existing pSeven installations.

../_images/page_support_install_03_upgnotice.png

It is recommended to remove previous version installations before an upgrade. Note that there is no need to remove user files (projects) and pSeven settings. However, removing license files is required to avoid license conflicts. These files are located in the pSeven workspace directory shown in the setup dialog (C:\Users\User\pSeven\ in the example above). Previous version licenses should be removed from this directory (so pSeven does not find them when it starts), but you can keep their copies elsewhere.

If there are no previous pSeven versions installed, and you have removed license files from the pSeven workspace directory, select “There are no existing pSeven installations on this computer.” and click b_system_next to continue.

If there is another version of pSeven currently installed, click b_system_cancel to abort installation, complete the uninstallation steps and restart the pSeven installer after rebooting the computer.

Installation Directory

Select install location or leave it default. pSeven application files are unpacked to this directory.

../_images/page_support_install_04_path.png

Note

In Windows, installing pSeven into the Program Files directory (default location) requires administrative rights. If installing under a standard user account, select another location, which allows write access for the current user.

Warning

When installing pSeven for Windows, verify that the path to the installation directory and the paths to temporary files directories of all users who will run pSeven contain only characters which can be represented in the current system locale. Otherwise pSeven may be unable to start or errors may occur when running.

For more stability, even if the system locale is properly configured, it is recommended to select the pSeven installation directory and user temporary files directories in such a way that their paths include only English characters. See Windows Temporary Files Directory and Using pSeven in Localized Windows for more details.

Click b_system_next to continue. If the specified installation directory does not exist, the installer notifies you that a new directory will be created.

../_images/page_support_install_05_path_confirmation.png

Confirm installation into a new directory to continue to the license setup.

License Setup

pSeven requires a license. It can run in the standalone licensing mode (use a local license file) or the server licensing mode (receive the license from a network server).

Note

You can skip this step if you intend to register the license later — for example, if you do not have the license file yet, or a license server is not configured. See Standalone License Registration or Server License Registration for details.

Note the host ID reported by the installer. Save this string and keep it: the host ID is needed for license requests. If the installer fails to determine the host ID, you can find it manually after installation — see section Host ID for instructions.

../_images/page_support_install_06_license.png

If you already have a license file, it can be registered automatically during installation. Click the browse button and point the installer to the license file, or input license file path in the field.

If there is a license server on your network, specify its IP address in the input field — for example, @10.7.18.142 (note the leading @). If the server is configured to use a non-default port, specify the port number in front of the IP address — for example, 27009@10.7.18.142. Request the exact IP and port from your network administrator.

Click b_system_next to proceed with the installation.

Ready for Installation

Before starting the installation process, the setup wizard shows a ready dialog. Note this is the last step that allows to change previous settings without canceling the installation.

../_images/page_support_install_07_ready.png

If you wish to review settings, use the b_system_back button. If all settings are correct, click b_system_next to begin copying files.

../_images/page_support_install_08_installing.png

Please wait until the installer finishes copying files and configuring your system. Note you can still cancel the installation at this step: if you click b_system_cancel, the installer will automatically revert all changes made to your system and then close.

Installation Complete

pSeven is now installed to your system. Click b_system_finish to close the installer. If you wish to view the readme file, the installer can open it automatically after it exits.

../_images/page_support_install_09_finished.png

Note

If you have skipped the License Setup step, please remember that a license will have to be registered later: see Standalone License Registration or Server License Registration.

A summary of changes made to your system by the pSeven installer:

  • The installer creates a shortcut to run pSeven on your desktop. Additional shortcuts are added to the system menu. In Windows, they are found in All Programs ‣ pSeven; in Linux the placement depends on the installed desktop environment. These shortcuts include:

    • License Management — a submenu with various license management functions.
      • Open pSeven License File Location — if you have a license file, use this shortcut to open the directory where it should be copied.
      • Restart pSeven License Server — for troubleshooting only: restarts the local server process which provides a license to pSeven when it runs in the standalone licensing mode. For more details, see Licensing System and FAQ: What licensing options are available for pSeven?
      • Start pSeven License Server — for troubleshooting only: manually starts the local license server (normally it is started automatically by pSeven).
      • Stop pSeven License Server — for troubleshooting only: manually stops the local license server.
    • pSeven Logs — opens the directory where pSeven log files are stored.
    • pSeven Manual — opens this manual in your default browser.
    • pSeven Manual - Russian — opens the Russian version of this manual.
    • pSeven Readme — opens the readme file.
    • pSeven Runner — starts pSeven in the limited Runner mode that can only run existing workflows but does not require a full license (see section pSeven Runner for details).
    • pSeven Runner + Post-Processing — starts pSeven in the limited Runner + Post-Processing mode. This mode is similar to pSeven Runner but it allows to view and process results.
    • pSeven — starts the full version of pSeven (the same as the desktop shortcut).
    • Uninstall pSeven — removes pSeven from the system. Settings and user files (projects) are not deleted.
  • pSeven application files are unpacked to the directory specified at the Installation Directory step. By default, it is C:\Program Files\DATADVANCE\pSeven-6.16.2\ in Windows and ~/DATADVANCE/pSeven-6.16.2/ in Linux.

  • The workspace directory named pSeven is created in your documents directory. The workspace is one of the locations where a standalone pSeven installation searches for license files. New projects are created in the workspace directory by default. This directory also stores pSeven examples, logs, default block icons, and configuration files.

    The documents directory, by default, is %USERPROFILE%\Documents\ in Windows and ~/Documents/ in Linux. For Linux, if ~/Documents/ does not exist, the pSeven directory is created in the user’s home directory.

  • If you have specified a license file path at the License Setup step, this file is copied to the pSeven installation directory and the pSeven documents directory (both locations for redundancy). Note that if you intend to register a standalone license later, you can simply copy the license file to one of these locations manually. For more details, see Standalone License Registration.

    If you have specified a license server IP address, it is saved to license manager settings. In Windows they are usually stored in registry under HKEY_CURRENT_USER\Software\FLEXlm License Manager. In Linux, see ~/.flexlmrc. The installer also sets the DATADVD_LICENSE_FILE environment variable that stores the server’s address.

  • On the first launch pSeven will also create a directory with examples (named Examples-6.16.2) inside the pSeven documents directory. This directory contains a number of example projects (see section Examples).

Unattended Installation

pSeven can be installed in unattended mode, using an installer option file or specifying parameters in the installer command line. This is an advanced installation mode that can be used to automate pSeven updates or network deployment.

To start unattended installation from the command line, run the installer with the --mode unattended option. Other options can be specified to control the installation, for example:

pSeven-6.7-windows-x64-installer.exe --mode unattended --unattendedmodeui minimal --prefix <install_path>

Available options are:

  • --help — display the list of options and their possible values. Note that for some options valid values in Windows and Linux are different.
  • --version — show release information.
  • --mode <mode> — select the installation mode. All modes are functionally equivalent.
    • --mode win32 — graphical installer, for Windows only. Default mode in Windows.
    • --mode qt — graphical installer using Qt, supported both in Windows and Linux. Default mode in Linux.
    • --mode gtk — graphical installer using GTK, supported in Linux only.
    • --mode xwindow — graphical installer using XWindow, supported in Linux only.
    • --mode text — interactive text-only installer, supported in Linux only.
    • --mode unattended — unattended (silent) mode, can use an option file (see --optionfile). Supported both in Windows and Linux.
  • --unattendedmodeui <mode> — interface mode for unattended installation.
    • --unattendedmodeui none — no interaction required, options must be specified in the command line or using an option file.
    • --unattendedmodeui minimal — the same as above but shows an installation progress dialog.
    • --unattendedmodeui minimalWithDialogs — currently the same as minimal, reserved for future versions.
  • --installer-language <language> — select installer language. See --help for the list of language codes.
  • --prefix <install_path> — specify installation directory. If omitted in the unattended mode, pSeven will be installed to the default location (C:\Program Files\DATADVANCE\pSeven-6.16.2\ in Windows, ~/DATADVANCE/pSeven-6.16.2/ in Linux).
  • --license-location <license-location> — specify the path to your license file or the license server in your network. If omitted in the unattended mode, the license will have to be configured manually.
  • --debuglevel <level> — set debug information verbosity. The level can be from 0 to 4, default is 2.
  • --debugtrace <filename> — redirect error debug output to a file.
  • --optionfile <filename> — read option values from an option file.
  • --install-scope — specify installation scope. Select “user” option value to install pSeven only for the current user. Select “allusers” option value to install pSeven for all users. To install pSeven for all users on this computer, run the installer as a privileged user.

A convenient way to configure unattended installation is by using an option file. The option file can be specified by --optionfile or loaded automatically. To read an option file automatically, place it in the same directory as the installer executable; the name of the option file must be the same as the name of the installer with an added .options suffix — for example, pSeven-6.16.2-windows-x64-installer.exe.options. In this case, you do not need to specify any options when starting the installer.

The option file is a simple text file containing option names and values, for example:

mode=unattended
unattendedmodeui=minimal
prefix=C:\My pSeven
license-location=pSeven license\12345.lic

Note that paths specified in the option file must not be enclosed in quotes even if they contain whitespaces. A relative path will be interpreted as a path from the current working directory.