Modify the path to the SAP GUI client

NeoLoad automatically uses the SAP GUI client declared in the registry.

However, the path to the SAP GUI client used by NeoLoad during a record or a replay of a test can be modified:

• by editing the "controller.properties" file; this applies to recording phase,
• by configuring the "SapConnect" SAP Action in NeoLoad; this applies to the replay phase,
• by editing the "agent.properties" file; this applies to the replay phase.

• Warning: For the recording phase, when no path is specified in the "controller.properties" file or if the path is invalid, NeoLoad automatically uses the SAP GUI client declared in the registry.

• Warning: For the replay phase, NeoLoad first checks the "SapConnect" Action configuration. If a path is specified in the "logonFolder" parameter, NeoLoad uses the SAP GUI client specified. If the SapConnect Action does not specify any path or if the specified path does not exist, NeoLoad checks the "agent.properties" file and uses the path specified in the "lg.sap.logon.directory.path" key. Otherwise, NeoLoad automatically detects the SAP GUI client declared in the registry.

Record

The "controller.properties" file can be edited to configure NeoLoad with a specific SAP GUI client for the recording phase. NeoLoad first checks the "controller.properties" file to find the SAP GUI client to launch when recording an SAP application. When no path is specified, or when the path is invalid, NeoLoad uses the SAP GUI client declared in the registry.

• To modify the path to the SAP GUI client for the recording

1. Open the "controller.properties" file in the "conf" folder of your NeoLoad installation files.
2. Change the value of the "controller.recorder.sap.logon.directory.path" key with the path to the SAP GUI client you want to use.
3. Save and close the file.

Replay

• Warning: For the replay phase, NeoLoad first checks the "Connect" Action configuration. If a path is specified in the "OverrideLogonFolder" parameter, NeoLoad uses the specified SAP GUI client. If the Connect Action does not specify any path or if the specified path does not exist, NeoLoad checks the "agent.properties" file and uses the path specified in the "lg.sap.logon.directory.path" key. Otherwise, NeoLoad automatically detects the SAP GUI client declared in the registry.

To configure NeoLoad with a specific SAP GUI client for the replay phase, two options are available:

• Configuring the "Connect" Action in NeoLoad.
• Editing the "agent.properties" file, or

• To modify the path to the SAP GUI client for the replay phase

1. Open the "agent.properties" file in the "conf" folder of your NeoLoad installation files.
2. Change the value of the "lg.sap.logon.directory.path" key with the path to the SAP GUI client you want to use.
3. Save and close the file.

• To configure the "Connect" Action in NeoLoad

1. Open NeoLoad.
2. In the Actions panel, unfold the SAP GUI node.
3. Drag the Conncect Action and drop it in a User Path.
4. In the facing Parameters table, edit the "logonFolder" parameter with a double-click in the facing Value column.
5. In the Value column facing the "logonFolder" parameter, enter the path to the SAP GUI client to be used by all the Load generators.
6. Press Enter to validate.

• Information: Overriding the "logonFolder" of the Sapconnect Action sets the SAP GUI client path for all the Load generators wherever the machines they are installed on.