Skip to Main Content
Return to Navigation

Specifying Change Assistant Options

This section describes options to set in Change Assistant. Only the options related to the Change Assistant Action you selected will be displayed. Many of the options apply to all actions.

If you are using the Change Assistant Wizard, after you select an action and click Next, the General Options page will be displayed.

You can also open the dialog in Change Assistant . Select select Tools, then select Options.

Note: The General options displayed is dependant on the Change Assistant action selected.

Image: General Options

This example illustrates the fields and controls on the General Options - Apply Updates. You can find definitions for the fields and controls later on this page.

General Options - Apply Updates
Maximum Concurrent Processes

Specifies the maximum number of processes that can be executed concurrently on the local machine. The default is 1.

*PS_HOME

Enter the full path in which you installed PeopleTools.

Note: Specify the PS_HOME location that is the same version of PeopleTools that the target database is running on. For PeopleTools scripts and executable to run successfully against a database, they must be at equivalent versions. The PeopleTools version of the PS_HOME does not necessarily need to be the same version as the Change Assistant session you are running. Change Assistant may be at a higher version.

Note: Oracle recommends using a mapped drive.

PS_APPS_HOME

Enter the full path for PS_APPS_HOME.

This directory stores application-specific code and files.

Note: Oracle recommends using a mapped drive.

PS_CUST_HOME

Enter the full path for PS_CUST_HOME.

This directory stores any customer-specific code or files. This creates a clear distinction between code and files delivered by Oracle (PeopleTools and PeopleSoft applications) and code produced or customized by individual customers.

Note: Oracle recommends using a mapped drive.

Staging Directory

Enter the directory in which you would like to stage all the Change Assistant update files. This is the location that Change Assistant will store files to be used during the apply update process.

Output Directory

Enter the directory in which you want the log files generated by the update process to reside.

Download Directory

Enter the full path of the location to which you want to download your change packages.

SQL Query Tool

Select the correct executable for the database platform. Valid SQL query executables for each platform are

  • DB2: db2cmd.exe

  • Informix: dbaccess.exe

  • Microsoft SQL Server: sqlcmd.exe

  • Oracle: sqlplus.exe

  • Sybase: isql.exe

Note: Change Assistant uses the command line version of the .exe, not the GUI version. For example, sqlplus.exe is used for an Oracle database, rather than sqlplusw.exe.

Important! Oracle Database Customers: For systems running on the Oracle database, by default, Change Assistant copies the generated SQL script files to the location specified as the TEMP User variable on the Environment Variables dialog box. So, on Oracle, the generated SQL script files will actually exist in two locations: the specified Change Assistant output directory, and the TEMP directory. This behavior is in place because some versions of Oracle SQL Plus do not support pathnames longer than 79 characters. It is recommended that you ensure that the value specified for the TEMP User variable is set to a path short enough so that the string comprising the path and generated SQL file will not exceed 79 characters.

Setting Server Options

For Updates, when you click Next from the General Options page, the Server Options is displayed.

You can also select the Server radio button.

Image: Server Options page

This example illustrates the fields and controls on the Server Options page. You can find definitions for the fields and controls later on this page.

Server Options page
Server Hostname

The hostname of the server in which the Environment Management HUB resides.

Server Port

Indicates the port in which to connect to the Environment Management hub.

Ping

Click to verify a valid server URL. If you see Service is off to the right of this button, then you must correct the server URL and ping again until you see Service is on.

Note: This button is visible only if your display is set to Windows Classic style. To change the Windows display, select Programs, Control Panel, Display. Select the Appearance tab and choose Windows Classic style from the Windows and buttons drop-down list.

View

Click to display the list of all PeopleSoft components discovered and registered in the Environment Management hub.

Note: This button is visible only if your display is set to Windows Classic style.

Chunk Size

Used for deploying files during a software update. Default is 1024 * 1024 bytes. Typically this does not need to be changed unless there are a significant number of files greater that 1024KB in a software update.

Ping Interval

Ping interval is in milliseconds for Change Assistant to contact the hub for new messages.

Drives to Crawl

Setting of drives to crawl to identify the configuration of the Change Assistant machine. Windows directories need to use the forward slash (/) character. Include your local drive in this setting so that Change Assistant can locate the SQL Query tool used for automating steps. Also include the path of the SQL Query tool.

Setting Additional Options

For Updates, when you click Next from the Server Options page, the Additional Options page is displayed.

You can also select the Additional radio button.

Image: Additional Options page

This example illustrates the fields and controls on the Additional Options page. You can find definitions for the fields and controls later on this page.

Additional Options page
Send Email Notifications

Select this check box to receive email notifications if there are errors in the update process. Change Assistant also sends you a completion message when it encounters a Stop in the update process.

SMTP Server

Enter the SMTP mail server from which you receive the error or completion messages.

Port

Enter the port from which you want to access the email.

Send To

Enter the address to which you want the email sent.

Return Address

Enter the email address of the sender. Use this to identify who sent the notification.

Test

Validates that email is sent to the designated recipients and is working correctly.

Note: Ensure that your SMTP server is installed and configured correctly.

Host

(Optional) Enter the name of the proxy server if you want to run Change Assistant behind the firewall using a proxy server.

Port

(Optional) Enter the port number for the proxy server.

Anonymous Proxy

Indicates that you are using a proxy server that does not require authenticated connections.

Microsoft Proxy Server

Indicates that you are using a proxy server with Windows authentication.

Windows Domain

The network domain in which the system runs.

Other Proxy Servers

Indicates you are using non-Microsoft proxy servers.