# 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, 64-bit editions.
• Various x86-64 (AMD64) Linux distributions.

Common requirements for both Windows and Linux versions are:

• Intel or AMD processor with SSE2 support.
• 2 GB RAM (4 GB or more recommended).
• 2 GB disk space.
• 1280x800 minimum screen resolution.

For Windows version:

• Microsoft Windows Vista/7/8/8.1/10.
• For the graphical user interface:
• 32 bit color depth.

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 Vista are not supported.

For 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.
• Linux Standard Base 3.0 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). A system without graphical environment can also run pSeven from the command line using p7batch, so the graphics requirements are optional.

LSB 3.0 is recommended for the native support of pSeven licensing modules. In most cases, however, pSeven works without it, using non-LSB system libraries as a 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

### Important Notes¶

Using pSeven may require certain system configuration changes. This section lists some cases in which you will need to apply such changes manually.

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 the Licensing System section for details on license types.

• Antivirus and firewalls. If pSeven is installed on a system protected with an antivirus or firewall, you may need to add pSeven to the antivirus exclusion list or add firewall rules allowing pSeven connections to license server (or other network resources).

For more details, see FAQ: Can pSeven be blocked by antiviruses or firewalls?.

• Siemens NX integration. If you install pSeven on a Linux system and intend to use the Siemens NX integration block NX, then it is required to append the Siemens NX library path to LD_LIBRARY_PATH. By default this path is NX_dir/ugii, where NX_dir is the Siemens NX installation directory.

For more details, see section Known Issues on the NX block page.

• PTC Creo integration. If you intend to use the PTC Creo integration block Creo, note that it requires PTC Creo installed with Visual Basic API support. This component is found under API Toolkits in 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.

For more details, see 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.

## 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.

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 downloads page. Note that downloads are available only to registered users, so you will be required to to login. 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.11-windows-x64-installer.exe for Windows and pSeven-6.11-linux-x64-installer.run for Linux. When launched, it starts a setup wizard.

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


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: Can pSeven be blocked by antiviruses or firewalls?

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

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

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

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

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 to continue.

If there is another version of pSeven currently installed, click 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.

Note

In Windows, installing pSeven into “Program Files” (default location) requires administrative rights. If installing under a standard user account, select another folder that allows write access for this account.

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

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

Note

When installing pSeven for Windows, ensure that the path to the installation directory contains only characters that are supported by the current system locale. Otherwise pSeven will not run because it will not be able to start the built-in Python interpreter.

For example, if your system is set to use a non-English locale, the path may include symbols from the character set for your local language, but not for other local (non-English) languages.

Note that the system locale can be different from the display language seen in menus and dialog boxes. You can find your system locale in Control PanelRegion and Language, Administrative tab, “Language for non-Unicode programs”.

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.

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 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.

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

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 , the installer will automatically revert all changes made to your system and then close.

### Installation Complete¶

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

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 — 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.11\ in Windows and ~/DATADVANCE/pSeven-6.11/ in Linux.

• The workspace directory named pSeven is created in your documents directory. The workspace is the default location for new projects. Also this directory stores pSeven examples, logs, configuration and license 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.11) 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.11\ in Windows, ~/DATADVANCE/pSeven-6.11/ in Linux).
• --license-location <license-location> — specify the path to your license file or the license server in your network. If omitted in the unattnded 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.11-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