Installing PeopleTools 8.55, PeopleSoft HCM Image 16 on VirtualBox using DPKs – Part 1

Hi all,

Here’s a step-by-step guide to installing PeopleTools 8.55, PeopleSoft HCM 9.2 Image 16 on your PC. My Host OS is Windows 10 64-bit installed on a Lenovo Z50-70 laptop with an i5 processor and 4 GB of RAM. The Virtual machine has around 2GB of RAM allocated to it. The more RAM that you allocate to the Virtual Machine(VM), the faster the installation would be – also, you can multitask as well. Without further ado, here are the steps with screenshots.


Here’s Part-2 of the installation guide.

Hope this helps! 🙂




About Mani

A PeopleSoft Techno-functional Consultant. An engineering graduate in Computer Science. Technology Enthusiast. Movie freak. Gadget geek.
This entry was posted in Oracle, PeopleSoft, Software, Virtualization and tagged , , , , , . Bookmark the permalink.

27 Responses to Installing PeopleTools 8.55, PeopleSoft HCM Image 16 on VirtualBox using DPKs – Part 1

  1. Hey Mani,
    Can I ask the reason for making the code change to the Powershell script in Part 1 Step 3?

    • Mani 2.0 says:

      Hey Mark,
      Thanks for your comment!

      Without the extra line, there was a space being appended to the guest OS name – so the PS script wasn’t able to recognize what OS it was – in this case Linux – and so the script failed. The statement that has been added does a trim of the OS variable and then proceeds with the execution of the script.

      Hope this helps! 🙂

  2. Hey Mani! Thanks for the details. Very handy information for the first time DPK user.

    What is the need for the only line addition to the powershell script? Can you provide some details on that? Thanks!

    • Mani 2.0 says:

      Hey Sasank,
      Thanks for your comment!

      Without the extra line, there was a space being appended to the guest OS name – so the PS script wasn’t able to recognize what OS it was – in this case Linux – and so the script failed. The statement that has been added does a trim of the OS variable and then proceeds with the execution of the script.

      Hope this helps! 🙂

  3. Sasank Vemana says:

    Hi Mani – Thanks for the clarification on my previous comment. 🙂

    Another question for you. How is the PUM Image working on Window 10? Any issues specifically due to Windows 10 such as executing specific functions on App Designer? Or has your experience been the same compared to Windows 7?

    • Mani 2.0 says:

      Hi Sasank,
      No problem at all 🙂

      Experience with PeopleTools 8.55 on Windows 10 has pretty much been the same as Windows 7. Are there any specific scenarios that you are referring to? I don’t seem to find any difference between Windows 7 and 10.

      I’ve been a regular follower of your blog and your posts on PeopleSoft branding 🙂 Do keep posting! 🙂


      • Sasank Vemana says:

        Thanks Mani! 🙂

        I am trying to evaluate what OS I should go with! I know there were some challenges with Windows 7 itself where some users were not able to update grid properties (depending on the level of access on the machine). Either the changes would not persist or app designer would crash. I was just wondering if there were any issues along those lines.

        When you find time, can you please try to open up the following page in App Designer:
        – Page: USER_ROLES
        – Double click on the ‘User Roles’ grid
        – On the ‘Label’ tab, try to disable the ‘Display Header’ checkbox
        – Save the page

        Then check if the changes persist on the page object – grid properties? Thanks!

      • Mani 2.0 says:

        Hi Sasank,
        Apologies for the delay in responding. There were some issues with starting my Application Designer when I switched Wi-Fi networks.

        After making changes, I checked on the page and in the grid properties as well. Both changes were retained even after closing the App Designer and logging back in. There does not seem to be any other issues with the App Designer.

        Please do let me know, in case you need more details.

        – Mani

  4. Sasank Vemana says:

    Thanks Mani! 🙂

  5. Sasank Vemana says:

    Hey Mani! It is me again. 🙂

    Do you have any idea how I can make an existing or new PUM image to be available on the network? I can only access my PUM image on the host itself.

    I know there are some network adapter settings to play with but want to be sure before I go breaking things! 🙂

    • Mani 2.0 says:

      Hey Sasank – Just to get your requirement right, you would like to access PIA across the network or just the PUM image files? Please let me know.

      – Mani

      • Sasank Vemana says:

        Just the PIA. I don’t need to access the PUM image files or access to app designer.

        I just need to be able to login to the environment from different devices. Mainly to test Fluid on mobile devices. Let me know! 🙂

      • Mani 2.0 says:

        Does this help? 🙂

  6. Sasank Vemana says:

    Thanks Mani! This is great. 🙂

    But I believe we need to first have the VM network adapter setup correctly for the instance to be accessible via the network? Are there any other settings at the VBox level do we need to keep in mind? Other than using ‘Bridged Adapter’?

    • Mani 2.0 says:

      Hi Sasank – the VM settings can be left at the default values or else, be set to Bridged Adapter – as in the screenshot below. If you are not able to do this, you can power off the virtual machine and you should be able to edit the Network Adapter.

      Apart from these, in case you are not able to connect other PCs or devices, I suggest you add exceptions to Firewall on the Listening port – 80, 8000 etc.

      On Windows > Windows Firewall > Advanced Settings > Inbound Rules > New Rule
      Port >> Specific local ports: >> Allow the Connection >> Next >> Next >> Finish

      Apart from these, I don’t think there would be anything else that would prevent accessing the PIA from different devices.

      Please do let me know if you still have questions.. Hope this helps!

  7. Raghu says:


    I am trying to install PS 9.2 HCM Image 18 on a Windows 10 Dell Laptop which has 8 GB Ram and 500 GB+ space.

    I tried first to install with Virtual Box option, and the VM import hangs at a step – Importing DPK files ……(i see that all the relevant files getting downloaded during this step) ….but there is no movement at all…… Any Idea, what could be going wrong?

    I also tried with the Native O/S option as you described in your blog …..however the steps failed at building PS Database. I believe the Database was not created properly (i see a control file missing) and through the Powershell script trace it says that , TNS adapter error. I have tried to start database using SQL, it says that error encountered at Control File ….. So now I am stuck here as well. Any idea , how to create a control file or go back to the create DB step in the Power Shell step ?

    Would appreciate your response on both of this issue ….


    • Mani 2.0 says:

      Raghu – for the VirtualBox option, did you extract the files to a single folder and make that folder shared on VirtualBox? Also, mark that folder as “Auto-mount”.

      As for the native OS option, I’m not sure what’s happening. I’ll try to replicate this issue and see how it goes.

      Hope this helps!

  8. Raghu says:


    Thanks for input, for the Virtual Box , yes I did extracted all files in to DPK_FOLDER and started to import appliance. I used VB 5.1.6 and also was trying to go with SES. I had shared the folder with Read-only and Auto-Mount ….not sure what was happening during the “downloading DPK’s” step ….I believe it was processing , but was very slow , I waited for around 12 hours and I gave up to start with native o/s option.

    When I started with native o/s option , all was going smoothly , and suddenly i hit with TNS adapter error….I saw that the TNS and Oracle services were on, but could not understand why I got the error….I believe something happened during CDBHCM DB creation …..i happened to drop the database, restarted the puppet script ….it picked up from last step , and this time it created the DB and started it ….and again it failed with TNS adapter error , but it was at PSAE step ….i rectified with port number and restarted the script …..Looks like i was able to run all the steps so far and been able to login to PS92 application.

    Thanks for your help

  9. Raghu says:

    Now, if we go with Native O/S and Let’s say we have installed or using PI #16 ….and I want to go to PI#18 …..what are the steps here?

    Would I be installing PI#18 with Native O/S ? (in same machine or another machine ?)
    How do we deploy the Change Package to different environments?

  10. indexon says:

    Reblogged this on PeopleSoft & Cake by Indexon Training and commented:
    Fab coupleof blogs about the steps to using 855 VM

  11. Eric shi says:

    Hi mani,

    Why it didn’t ask me to set up the password for the items
    ? Part 13. It just let me login directly before part 13.

  12. peopleux says:

    Thank you for sharing your blog, seems to be useful information can’t wait to dig deep!

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s