Tutorial installation for P4 Server

This page describes the procedure for installing the Perforce IPLM tutorial database and a Perforce server with matching file level data. The tutorial database can be used for training or for evaluation of Perforce IPLM.

The tutorial install (install_all.bash script) will:

  1. Create a new Perforce server and import tutorial data.
  2. Import tutorial IP data into Perforce IPLM.
  3. Install VersIC.
  4. Generate an 'mdx.bash' file that contains environment settings.

The main install script is located at: /usr/share/mdx/products/piextras/install_scripts/server/install_all.bash (after installing PiExtras)

  • Note that installing the tutorial should be done as root, not sudo. Environment variables do not survive the sudo shell and will lead to breakage.
  • We recommend a single machine for both Perforce and Perforce servers for most deployments. To use separate machines, contact Perforce support for details.

  • The tutorial should be installed on the Perforce IPLM dedicated machine.  Attempting to install alongside other applications may cause tool conflicts or performance degradation.

Prerequisites

Prior to tutorial installation, complete the following steps:

  1. Using the instructions for your Linux distribution at IPLM package installation, install PiServer, PiClient, PiCache, and PiExtras.

  2. Create the Linux service user account "mdx" to run perforce.

    root> adduser mdx -p <PASSWORD>

  3. Load the Perforce IPLM license (more details here).

    root> pi login admin
Password:
Successfully logged in as 'admin'.
root> pi lic load <my_license_file>

Installation procedure

  1. Change directory to the installation script directory

    root> cd /usr/share/mdx/products/piextras/install_scripts/server

  2. Edit the configure.txt file, which contains all the settings used by the install scripts.

    1. Set 'PISERVERNAME' to the fully qualified hostname of the server

    2. Set 'P4SERVERPORT' to the port number to use for the new perforce server (default is 1666)

    3. Set 'P4D_SVC_USER' to the linux service user account you wish to use to start perforce

    4. Set 'USERNAMEMDX' and 'PASSWORDMDX' to the values provided by Perforce to access the MDX download site.

    5. If you are performing an offline install, you need to set the SET_OFFLINE_INSTALL to YES. In this case you will need to edit the configure_offline.txt file to point to the pre-downloaded versic installation tar ball. Instructions on downloading the tarball can be found in configure_offline.txt file. If you are performing the standard installation this step should be skipped.

  3. Execute the install script

    root> export PATH=$PATH:/usr/local/bin

    root> /usr/share/mdx/products/piextras/install_scripts/server/install_all.bash

    After the script completes, you will have installations of Perforce IPLM and Perforce loaded with tutorial data, and can log in to Perforce IPLM and begin to build local mode workspaces.

  4. Install a Perforce License for the Perforce Server.

  5. (optional) Enable PiCache - note this requires a Perforce License to have been installed

    1. Edit the '/usr/share/mdx/config/mdx.bash' file

    2. Uncomment the 'MDX_PICACHE_SERVER=<myserver>' line

    3. Source the /usr/share/mdx/config/mdx.bash file to configure the environment to use PiCache.

Getting started with Perforce IPLM

  1. Log in as the mdx user.

    root> su - mdx

  2. Setup your shell variables.

    mdx> source /usr/share/mdx/config/mdx.bash

  3. Log into Perforce IPLM as the admin user.

    mdx> pi login admin

  4. Load a workspace.

    mdx> pi ip load tutorial.tutorial /tmp/ws1

  5. Change directory to the workspace.

    mdx> cd /tmp/ws1

  6. Check the workspace status

    mdx> pi ws st -v

Now that we've verified we can build workspaces we can begin working through the Perforce IPLM training, located on the Perforce IPLM Training page.

To install Edge servers that replicate this Perforce server, contact Perforce support.