Prepared by:

Session ID:

Advanced Peoplesoft Administration

Kyle Benson, Dan IversonPeopleSoft Administratorspsadmin.io@kbenson/ @psa_io / @daniverson

100480

• Largest county in Minnesota

• Minneapolis county seat

• ~8,000 employees

• Budget $1.9 billion

• FSCM, HCM, ELM, Interaction Hub

• 9.2 and 8.54

• Population: 410,000

• 2017 Budget: $1.3 Billion

• 6-8,000 Employees

• Finance, HR, ELM 9.2

• PeopleTools 8.55.13/.17

Let ’s apply a PeopleTools Pa t ch!

AGENDA

• Vagabond

• Scripting

• psadmin-plus

• Deployment Packages

• Git

Vagabond

Demo

GETMOSPATCH

• PeopleTools Patch DPK is 4 files

• PeopleSoft Images are 10+ files

• https://github.com/MarisElsins/getMOSPatch

• getMOSPatch saves you time, lots of time

• java -jar getMOSPatch patch=1234567

• java -jar getMOSPatch patch=1234567 platform=233P download=all MOSUser=dan@psadmin.io MOSPass=password

VAGABOND

• Open Source project from JR Bing

• Automated PI Deployments

• Powered by Vagrant, VirtualBox and the DPK

• https://github.com/psadmin-io/ps-vagabond

• vagrant up and grab lunch

HOW DOES VAGABOND WORK?

• Create a new VBox VM (OEL 7 or Windows 2012 R2)

• Downloads .zip files from MOS

• Executes the DPK Bootstrap Script

• Copy in psft_customizations.yaml / Custom DPK Modules

• Run puppet apply

VAGRANT

• https://www.vagrantup.com

• Front-end for Virtualization Platforms

• Supports VBox, VMware, Hyper-V, AWS and more

• Command line interaction

VAGRANT COMMANDS

• vagrant init jrbing/vagabond

• vagrant up

• vagrant provision

• vagrant halt

• vagrant ssh / vagrant rdp

• vagrant snapshot

• Initialize a Vagrant folder

• Start the VM

• Build software on the VM

• Stop VM

• Remote into the VM

• Take a VM snapshot

CONFIG.RB

MOS_USERNAME=‘dan@psadmin.io’

MOS_PASSWORD='password'

PATCH_ID='25242817'

PROVISIONERS

• Linux —> shell

• Windows —>

• download

• bootstrap-ps

• yaml

• dpk-modules

• puppet

• client

PROVISIONERS

• Vagabond for Window can apply a PeopleTools Patch

• Download Patch .zip files

• Install Client Tools and Change Assistant

• Cleanup existing PS_HOME/Middleware

• Deploy new PS_HOME/Middleware

• Build CA Environment and apply the PTP project

• Build new domains

PROVISIONERS

• Windows —>

• download-ptp

• bootstrap-ptp

• client

• dpk-modules

• apply-ptp

CONFIG.RB

OPERATING_SYSTEM = 'WINDOWS'

APPLY_PT_PATCH='true'

PTP_PATCH_ID='26201347'

DPK_ROLE = '::io_role::io_tools_demo'

FQDN='psvagabond'

CA_SETTINGS = {

:setup => 'true',

:path => 'C:\Program Files\PeopleSoft\Change Assistant',

:type => 'upgrade', # new upgrade uninstall

:backup => 'backup' # backup nobackup

}

PTF_SETUP = ‘true'

GET STARTED WITH VAGABOND

• Install VirtualBox

• Install Vagrant

• Clone/Download the Git Repository

• git clone https://github.com/psadmin-io/ps-vagabond pi-hr-022

• Enter your MOS Credentials/Patch ID in config.rb

• vagrant up

VAGABOND AND WINDOWS

• Windows code is under feature/windows branch

• git checkout feature/windows

Script ing

SCRIPTING

• Automate repetitive tasks

• Enforces consistent configuration

• Initial focus on low-level tasks

• Start/stop domains

• Cache clearing

• Migrate a single project

SCRIPTING

• Incorporate scripts to build high-level scripts

• Example: Bounce Web Domain

• Remove web domain from load balancer

• Stop web domain

• Clear cache

• Start domain

• Add domain into load balancer

SCRIPTING

• psadmin-plus

• Change Assistant and Client Tools automation

• Phire

• Rundeck

• Oracle Enterprise Manager

DATABASE REFRESHES IN OEM

DATABASE REFRESHES IN OEM

DATABASE REFRESHES IN OEM

SCRIPTING CHANGE ASSISTANT

• Apply Patches

• Build Environments

• Apply PeopleTools Patches

• Upload Customer Data to PUM (8.56)

psadmin-plus

PSADMIN-PLUS

• Helper script for working with psadmin

• https://github.com/psadmin-io/psadmin-plus

• Combines multiple step tasks into one command

• Example: `PSAdminPlus.ps1 bounce app psftdb`

• stop domain

• purge cache

• clear IPC

• reconfigure

• start domain

Check on t he PeopleSoft Image build

Apply t he PeopleTools Pa t ch

Deployment Packages

DEPLOYMENT PACKAGES

• Delivered automation for building environments

• Define your environments upfront

• Implementation is abstracted

• Consistent and repeatable infrastructure

• Configuration is documented: psft_customizations.yaml

• Extend to customize your builds

DPK TECHNOLOGIES

• Puppet

• Facter and Hiera

• PowerShell/Bash (8.55) or Python (8.56)

• Automated Configuration Management

BOOTSTRAP SCRIPT

• setup\psft-dpk-setup.ps1

• Prepares the DPK folders to deploy software

• Changes the DPK Role

BOOTSTRAP PARAMETERS

• -env_type dbtier

• -env_type midtier

‣ -env_type midtier -domain_type appserver

‣ -env_type midtier -domain_type prcs

‣ -env_type midtier -domain_type pia

‣ -env_type midtier -domain_type appbatch

• -env_type midtier -deploy_only -deploy_type tools_home

‣ -env_type midtier -deploy_only -deploy_type app_home

‣ -env_type midtier -deploy_only -deploy_type app_and_tools_home

• -silent

• -no_env_setup

• -patches_dir path

PSFT_CUSTOMIZATIONS.YAML

• Define your server configuration

• Create multiple domains/sites

• Overrides delivered configuration

• Structure is important

• Spaces, not tabs!

psft _cus t omizat ions .yamlExample

ROLES AND PROFILES

• DPK Role – what type of server is this?

• Web Server

• App Server

• Web/App/Batch Server

• No Web/App role

• DPK Profile – Lookup Hiera Data and pass to implementation code

CUSTOM DPK ROLES

• Include your configuration in DPK builds

• Extend psft_customizations.yaml

• Deploy your own changes to environments

• Signon page

• SSL Certificates

• Custom Java Libraries

SITE.PP

node default {include ::pt_role::io_tools_demo

}

IO_TOOLS_DEMO

• Custom DPK Role

• Builds a fulltier machine (PeopleSoft Image)

• Includes custom profile (io_web)

• Modifies signin.html and index.html

• Deploys custom logo

io_t ools_demoExample

Git

WHAT IS GIT?

• Version Control Software

• Written by Linus Torvald

• Used everywhere, even for the Windows Kernel

GIT BENEFITS

• Track code changes

• Easily branch code and make changes without impacting others

• Collaborate easily on code changes

• Sharing code easily with GitHub

GIT AND PEOPLESOFT

• Control your DPK modules

• PS_CUST_HOME

• Scripts directories

• ps-project-git (Export/Import App Designer projects via Git)

• https://github.com/psadmin-io/ps-project-git

GIT UTILITIES

• VisualStudio Code

• GIT-POSH

• https://git-scm.com

• Pro Git online book (https://git-scm.com/book/en/v2)

• GitLab - local or cloud

Valida t e t he PeopleTools Pa t ch

psadmin.io/ reconnect

psadmin.io Communit y

DPK Quicks t art

Course

Session ID:Please complete the session evaluation

100480