Naming Conventions and Requirements

PI API Installation on a Linux Power TG machine

Please check with Siemens to confirm the user that the PI API and interface should be owner and run as. It should be the same user as the Siemens software uses to generate the input data files.

These instructions assume that the owner the PI API and interface is powertglocal and the PI API will be installed in the /opt/piapi directory. If the user is not to be powertglocal, then substitute for the correct user name where required.

1. 
   As root, create the PI API directory and change the ownership to the user that will be running the PI API processes.
   su
   mkdir /opt/piapi
   chown powertglocal /opt/piapi
   exit
   
2. 
   Define the PIHOME environment variable to the name of the PI API directory. export PIHOME=/opt/piapi
   
3. 
   Add the PIHOME definition to the profile of the powertglocal user.
   For the csh shell (or tcsh), add the following to the ~/.cshrc file
   # PI API settings
   setenv PIHOME /opt/piapi
   setenv PATH ${PATH}:${PIHOME}/bin::

   For the bash shell, add the following to the ~/.bash_profile file

   
   # PI API settings
   export PIHOME=/opt/piapi
   export PATH=$PATH:$PIHOME/bin::
   
4. 
   Copy the PI API installation kit piapiLinux64-tar_xxxxx_.gz onto the Power TG machine using FTP/SFTP or similar. Put the file into the /opt/piapi directory.
   
5. 
   Extract the contents of the piapiLinux64-tar_xxxxx_.gz installation file.
   cd $PIHOME
   gunzip piapiLinux-tar_xxxxx_.gz
   tar xvf piapiLinux-tar_xxxxx_
   
   This will create a directory called build which contains the PI API installation files.
   
6. 
   Run the PI API installation script pi.install as root
   cd $PIHOME/ build
   su
   sh ./pi.install
   
   Answer the prompts for your system

   Enter an existing user name for PI API [piadmin] ?

   
   powertglocal
   Please Enter the Node Name of the Default PI Home Node:
   PISERVER1
   Is PISERVER1 a PI v3.x (UNIX, NT) system? [Y] or N
   Y
   
   Check the installation messages and verify that there were no errors.
   
   exit (to change back to the powertglocal user)
   
7. 
   Start the PI API processes
   cd $PIHOME/bin
   pistart

   Ignore the message “Warning: USER is not root or piadmin applications may not start.” This warning can be removed from the pistart and pistop scripts by changing the scripts to find the owner the of script and using that instead of the hard-coded “piadmin”.

   
   
   OWNER=`ls -l $0 | awk '{ print $3 }'`
   if [ "$USER" != "root" -a "$USER" != "$OWNER" ]; then
   echo "Warning: USER is not root or $OWNER. Applications may not start."
   fi
   
8. 
   Use the apiverify script to check the running PI API processes. Initially, the bufserv process should not be running because buffering is not enabled by default.
   
9. 
   Use the apisnap utility to verify that the PI API is able to connect to the PI server