Installing PeopleTools 8.58

We have already seen how to install PeopleSoft on your laptop and set up an Oracle client in previous posts.

If you are a technical guy, you know that there’s no fun without PeopleTools. Right?

In this post I will show you how to get the final bit up and running so that you can fully utilise your local PeopleSoft installation.

All right, let’s get started.

  1. Fire up the VM first and make sure that it is running.
  2. VM Running

  3. Map a Network Drive
  4. Go to This PC and map a network drive (say Z:)

    This PC - Network Drive

    This is the same IP which was generated by the DHCP when we installed PeopleSoft. It could be a different one for you.

    Map Network Drive

  5. Launch PowerShell as an Administrator
  6. Search for PowerShell, right-click and launch it as an Administrator. It’s important to launch it as an admin as it wouldn’t have the right privileges to create files/folders otherwise.

    Launch PowerShell

  7. Launch the Setup script
  8. In Powershell, navigate to the new network drive you’ve mapped (Z:). Run the batch program by typing ./SetupPtClient

    Launch the Setup script

  9. Update Manager Environment
  10. When you are asked if this is a deployment for an Update Manager Environment, answer y.

    Update Manager Environment

  11. Select PeopleTools version
  12. The installation comes with PeopleTools 8.56, 8.57 and 8.58. Choose 8.58 by entering 3

    Select PeopleTools version

  13. Select Database platform
  14. Select Oracle as the DB platform by entering 1.

    Select Database platform

    This will start the Tools client deployment.

    Deployment Complete

    The deployment would complete in a few minutes.
  15. Configuration Manager
  16. Within your C: you will now see a folder similar to PT8.58.03_Client_ORA depending on the client you’ve selected. Navigate to C:\PT8.58.03_Client_ORA\bin\client\winx86 and double click pscfg.exe

    Locate Configuration Manager

    On the Startup tab, enter all details as shown below. These are details you’d entered while installing PeopleSoft.

    Click OK.

    Configuration Manager

  17. launch App Designer
  18. In the same folder, double-click on pside.exe to launch Application Designer. Login using PS and the password you’d set while installing.

    PeopleTools Sign on

  19. Application Designer opens.
  20. Application Designer

    Try opening some definitions now!

  21. Pin programs to Start menu
  22. It would be a good idea to pin the frequently used programs to the start menu.

    Desktop Shortcuts

      Tags: ,
Subscribe to Comments RSS Feed in this post
17 Responses
  1. Awesome blog post keep on posting more about peoplesoft.

  2. Hi Rakesh, thanks for your how to’s on PeopleSoft. I am a middleware engineer but have never had to support a PSFT environment. I’d like to know if there is any documentation, web articles, or your advice on editing configuration files instead of using the PSFT Tools? For example, is there a server.xml type of file that is used to define db connection parameters, pool, etc… ?


  3. Hi ,
    Need help with n/w connectivity to \\ . While connecting to this \\ on Win10 Laptop its asking me for UserID /Password .. How do I get that information or Should I change any settings ?

    • Hi Dan,

      Please provide root as userid and password as what you have given while installing virtualbox.

      • Dinesh, I am also having the same problem with requesitng an account & password. I tried using the root account and password but I receive the following error in return:

        You can’t access this shared folder because your organization’s security policies block unauthenticated guest access. These policies help protect your PC from unsafe or malicious devices on the network.

        Any thoughts?

  4. Hi Rakesh,

    I’m trying to install PTools 8.58.05 but I cannot connect to mapped drive as Administrator in Power Shell. I can connect do and execute the script as a normal user but failed due to permission.

    Appreciate your assistance.


    • @CelTess – Does the user have admin rights on the PC.
      If so, what error do you get on launching PowerShell as an Admin?

  5. Hi Rakesh,
    Thanks so much for quick response. I want to run the script for PTools. Manage to mapped drive to z:\tools_client and it was in my file explorer when I open powershell as administrator intending to run the script. When I type z: I got this error.

    >> Windows PowerShell
    Copyright (C) Microsoft Corporation. All rights reserved.
    Try the new cross-platform PowerShell
    PS C:WINDOWSsystem32> z:
    Set-Location : Cannot find drive. A drive with the name 'Z' does not exist.
    At line:1 char:1
    + Set-Location $MyInvocation.MyCommand.Name
    + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        + CategoryInfo          : ObjectNotFound: (Z:String) [Set-Location], DriveNotFoundException
        + FullyQualifiedErrorId : DriveNotFound,Microsoft.PowerShell.Commands.SetLocationCommand
    PS C:WINDOWSsystem32>

    But when I use powershell as a normal user I can access z: and manage to run the script but its quick and when I check the log I saw this.

    2021-01-09T21:08:27Pacific Standard Time    ERROR : PTCDPK-50015: odcdeploy:Unable to set inst_loc key
    2021-01-09T21:08:27Pacific Standard Time    ERROR : Traceback (most recent call last):
      File "", line 625, in set_inst_loc
        winreg.KEY_WOW64_64KEY + winreg.KEY_ALL_ACCESS)
    PermissionError: [WinError 5] Access is denied</code>
    During handling of the above exception, another exception occurred:
    <code>Traceback (most recent call last):
      File "", line 679, in set_inst_loc
    PermissionError: [WinError 5] Access is denied

    So probably I really need to run it as administrator as you mentioned. Now I’m stuck, please help. Any suggestion?

    Thanks in advance.

    • @CelTess

      Looks like you might have to remap the drive within the same PowerShell Instance (as Admin) before you type Z:.
      The following command might help.

      net use Z: ""
  6. Hi Rakesh, your the best! thank you it works. Now I can play around with it. Btw, can I run AE, SQR, BI Publisher or IB in out PIA PSoft Application. Or do I need to have some special settings that I need to apply becaus I know some buttons runs some COBOL programs too.

    Thank you again. Really appreciate it!


    • @ClenTess – Always happy to help 🙂
      You would now have a fully functional installation – you should be able to run processes etc.

  7. Getting this error but not sure why. TNS_ADMIN echos correctly. SQL Developer is up and running and I can query the tables. But App Designer is getting the following

    File:SQL Access ManagerSQL error: Stmt # 2 Error Position: 0 Return 12154 – ORA-12154: TNS:could not resolve the connect identifier specified.

    • Will, were you able to resolve this issue? I am also facing the same error.

  8. Fantastic post with excellent step by step instructions and screen shots. For the life of me, I couldn’t understand the readme file in the \tools_client directory.

  9. I am not able to access the network drive / map it. It is asking for credentials and when I am giving user name as root and password as what I mentioned during installation it is not working.

    What are the possible reasons for this?

    I was able to login to PIA though

  10. I am encountering an error trying to map a network drive. It requests an account and password. I have tried using the root and password for root but receive the following error:

    You can’t access this shared folder because your organization’s security policies block unauthenticated guest access. These policies help protect your PC from unsafe or malicious devices on the network.

Leave a Reply

Your email address will not be published. Required fields are marked *