Table of Contents

...

NOTE: Please follow standard PeopleSoft Installation instructions for Server Administration that were followed when any webserver web server was installed on your infrastructure.

...

If your primary site is located at <<PS_CFG_HOME>>/WEBSERV/<<peoplesoft site domain name>>/applications/peoplesoft/PORTAL.war you can copy your primary site or you can install it via delivered tools for installing a PeopleSoft webserver web server and install modern site for internal users.

...

Create an additional PeopleSoft site "external" on your Webserver web server domain that is exposed outside of firewall.

Illustration of an external site(HPKGONB) on a webserver web server domain peoplesoftCLDONB

e) Pre-Installation

...

Illustration of adding EDITTABLE19,20,23 in your DERIVED record

...

 Image Added

(2) Application Server/Process scheduler configuration steps

...

NOTE: Please refer to KB article 1485558 on Oracle support site for additional details on DBFlags parameter.

...

Image Added

(3) We also require that environment is validated for Integration Broker configuration making sure default local node is setup correctly, along with active IB domain and keystore password encrypted on the gateway configuration.

Illustration of Default local gateway check

...

Image Added

Illustration of Illustration of Default local node successful ping

...

Image Added

Illustration of Active domain status

...

Image Added

f) Download and Extract the windows Executable from the Zip file 

...

Choose Copy option if you want to copy and build PeopleSoft projects manually, or choose manual build if you want projects to be copied but build manually. Auto build will copy and build PeopleSoft projects during installation.

...

Image Added

After install file is executed and depending on the Installation output directory you provide, installer will deliver some files and folders to that directory. 

...

Image Added

Copy all jar files from your installation appserver directory to all of your appserver folder: $PS_HOME/appserv/classes (on Linux) or $PS_HOME/classes folder(on Windows). SmartProducts are usually shipped with the following jar files. 

a. SmarBusinessProcessInterfaces.jar
b. SmartERPGadgetInterfaces.jar
c. SmartCommon.jar

...

Download itext-2.1.7.jar (or later version of this file) and place it under PS_HOME/appserv/classes folder.

Image Added

*PeopleSoft HR usually ships older version of this itext.jar file under PS_APP_HOME/appserv/classes. You need to delete this file after placing latest version as mentioned above. SmartCommon.jar contains required version itext.jar classes packaged.

Bounce appserver after copying the jar files. 

Copy <<WEBSERVER>>\ DEVEREC\applications\peoplesoft\ \PORTAL.war\WEB-INF\smarterp.config to Target eRecruit Domain.

g) Installing jar files

...

on both Internal and External

...

 (1) Copy SmartFilter.jar from local installation webserver folder to both internal and external <WEBSERVERHOME>/<DOMAIN>/applications/peoplesoft/PORTAL.war/WEB-INF/lib folder.

...

 (2) Copy smarterp.config from local installation webserver folder to external site only to the path shown below. 

<WEBSERVERHOME>/<DOMAIN>/applications/peoplesoft/PORTAL.war/WEB-INF folder

...

(3)  For Internal Site (HR users) 

Copy smarterp_psft.config to <WEBSERVERHOME>/<DOMAIN>/applications/peoplesoft/PORTAL.war/WEB-INF.

After copying either using any GUI tool or shell rename smarterp_psft.config to smarterp.config without fail. Below screenshot illustrates after file rename from smarterp_psft.config to smarterp.config.

...

 (4) Copy SmartCloudOnboarding.zip from local installation webserver folder to both internal and external webserver sites. 

 <WEBSERVERHOME>/<DOMAIN>/applications/peoplesoft/PORTAL.war/SmartCloudOnboarding.zip

...

From command prompt(windows) or shell(Unix/Linux) change directory to <WEBSERVERHOME>/<DOMAIN>/applications/peoplesoft/PORTAL.war and run the following commands: 

unzip SmartCloudOnboarding.zip 'smart/*' -d

<WEBSERVERHOME>/<DOMAIN>/applications/peoplesoft/PORTAL.war

 unzip SmartCloudOnboarding.zip 'smarterp/*' -d

<WEBSERVERHOME>/<DOMAIN>/applications/peoplesoft/PORTAL.war/WEB-INF/psftdocs

Below screenshot illustrates after copying the folders or unzipping them as suggested above, 

...

(5) Edit <<WEBSERVER>>\ <<DOMAIN>>\applications\peoplesoft\ \PORTAL.war\WEB-INF\web.xml and add the following entry after “<!-- <distributable/> →” inside “web-app” section.

<!--Start SmartERP Solutions, Inc. 2018-->

<filter>

<filter-name>SmartFilter</filter-name>

<filter-class>com.smarterp.ui.ResponsiveUIFilter</filter-class>

<init-param>

<param-name>configFile</param-name>

<param-value>smarterp.config</param-value>

</init-param>

</filter>

<filter-mapping>

<filter-name>SmartFilter</filter-name>

<url-pattern>/psp/*</url-pattern>

<url-pattern>/psc/*</url-pattern>

</filter-mapping>

<!--End SmartERP Solutions, Inc. 2018→

...

(6) Only for Internal Users Modern Site, not needed for Candidate or external site webservers 

Edit <WEBSERVERHOME>/<DOMAIN>/applications/peoplesoft/PORTAL.war/WEB-INF/smarterp.config and enter “SiteName” for which Modern Content should be rendered under “ResponsiveUIFilter” Section.
<filter name="ResponsiveUIFilter">
<param name="filterClassName" value="com.smarterp.signon.LoginFilter"></param>
<param name="TemplateIScript" value="WEBLIB_SM_CD.ISCRIPT1.FieldFormula.IScript_GetUITemplateHeader"></param>
<param name="PSSite" value="HPKGNINT"></param>
</filter>

...

(7) Bounce webservers. 

Web Servers

 For instructions on installing the jar files on internal and external web servers, please follow this link.

h) WebLogic settings when modern UI is not rendering some multibyte ASCII characters

...

Append -Dfile.encoding=utf8 to JAVA_OPTIONS parameter corresponding to platform webserver web server is hosted on in serEnv.sh file.

...

JAVA_OPTIONS_LINUX="-server -Xms1024m -Xmx1024m -Dtoplink.xml.platform=oracle.toplink.platform.xml.jaxp.JAXPPlatform -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0 -Dfile.encoding=utf8 "

This change requires a webserver web server bounce to be effective.

i) Production Only Configuration

...

j) Set the Login URL and Internal Modern UI Site Name URL

 Navigate to Peopletools PeopleTools > Utilities > Administrator Administration > URLMaintain URLs

 1) open URL definition SM_AUTH_SSO_LOGIN_URL.

...

 http(s)://<<hostname>>:<<portnumber>>/psp/<<sitename>>/?cmd=login&languageCd=ENG&

...

Image Added

2) Create(add) a new URL definition SM_AUTH_INTERNAL_SITENAME 

For URLID, provide the internal modern UI site you have created in step C. This is a very important step without which modern UI site can not be launched by the internal users.

...

Image Added

On each of the webserver web server hosts make sure that that hostname.<<authentication token domain>> resolves to the local webserver web server host. If this is not handled on the dns server make sure to add it on the hosts file (On Linux/Unix at /etc/hosts and On Windows at Cat C:\Windows\System32\drivers\etc).j) Webserver Web server HostName DNS Entry

For example: if the webserver web server hostname is "smtest01" and the authentication token domain used while creating webserver web server domain is ".smarterp.org" then smtest01.smarterp.org should resolve to the same host.

3. Download and migrate commons-codec-1.11.jar to your webserver web server lib directory

a) Download and extract the latest commons-codec*.jar from https://commons.apache.org/proper/commons-codec/download_codec.cgi

b) Either using a GUI tool or using a shell copy this jar to the following webserver web server directory

<<PS_CFG_HOME>>webserv/<<DOMAIN>>/applications/peoplesoft/lib/  

 This has to be carried out for both "internal" as well as "external" website.

...

Image Added

4. Import Certificate and Keystore Configuration Steps Steps 

The following describes the steps to be done to configure PeopleSoft keystores for secure integration between Smart E-Verify and the USCIS E-Verify Webservices.

...

URL for Production Environment:

https://everify.uscis.gov/api/v30/soap/cases/wsdlv31

URL for non-Production Environment:

https://stage-everify.uscis.gov/api/v30/soap/cases/wsdl

...

v31

Image Added

b) View the Certificate 

Go to the Certification Path tab and highlight the intermediate certificate, Symantec Class 3 Secure Server CA – G4 (intermediate certificate) in this case, and click the  View Certificate button.

...

Image Added

c) Certificate Details 

On the intermediate certificate, go to the Details tab and click Copy to File button to export the certificate.

...

Image Added

d) Export Certificate 

Choose the Base-64 Encoded X.509 (.CER) format and export the certificate into a file.

...

Image Added

e) Copy and Import Certificate 

Copy this file to the webserver web server that is hosting the Integration Broker gateway and import the certificate file using pskeymanager (at <PS_CFG_HOME>\webserv\<domainname>\piabin) or any other key manager utility, and bounce the webserverweb server.

...

Image Added

5. reCaptcha Registration for On-Premise Clients 

...

a) Go to the Google reCAPTCHA web page:  https://www.google.com/recaptcha/intro/.

...

Image Added

b) Click the the Get reCAPTCHA link link. 

...

Image Added

c) Sign in using a gmail account.  If you do not have a gmail account, you can create one. 

...

Image Added

d) Select the the reCAPTCHA V2 option option. 

e) Enter your domain name - for example www.<customerdomain>.com.

...

g) Click the Register button.

...

Image Added

h) Send Registration Details 

...

1. Copy and paste all of the information from these 3 sections into a Word document, and save them. Just like below.
   1. Keys
   2. Step 1: Client side integration
   3. Step 2: Server side integration
2. Update the ‘Site Key’ in the Forgot Password HTML file.
   1. Go To the Path <<PS_HOME>>applications/peoplesoft/PORTAL.war/WEB-INF/psftdocs/smarterp/Framework/pages/Authentication
   2. Locate the file ForgotPassword.html
   3. Update the ‘key’ info here <div class="g-recaptcha" id="smrecaptcha" data-sitekey="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"></div>
3. Update the ‘Site Key’ in the Forgot Username HTML file.
   1. Go To the Path <<PS_HOME>>applications/peoplesoft/PORTAL.war/WEB-INF/psftdocs/smarterp/Framework/pages/Authentication
   2. Locate the file ForgotUsername.html
   3. Update the ‘key’ info here <div class="g-recaptcha" id="smrecaptcha" data-sitekey="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"></div>
4. Update the ‘Secret Key’ in the SmartERP Config file.
   1. Go To the Path <<PS_HOME>> applications/peoplesoft/PORTAL.war/WEB-INF
   2. Locate the file smarterp.config
   3. Update the ‘key’ info here <param name="reCaptchaKey" value=" xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx "></param>
5. Bounce the Webserverweb server.

...

Image Added

...

Image Added