Wednesday, October 8, 2008

LoadRunner: Creating manual web_custom_request for HTTP file uploads

There was a recent forum post in Advanced LoadRunner yahoo group asking how LoadRunner captures the file upload requests and if there was a way to customize that request. At that time, I replied that it may be possible to generate a manual web_custom_request by using the underlying raw HTTP request. I hadn't tried it then but it sounded interesting enough to be marked as to-do. I recently got some time to try it and it was fun.


As mentioned in the forum post, LoadRunner captures any form based file uploads as web_submit_data with the file name (and location) within the list of data within the request. An example request:

        "Name=File", "Value=C:\\testdata\\readme1.txt", "File=yes", ENDITEM,

There are 2 obvious drawbacks to this:

1. For this kind of script, the files to be uploaded have to be transferred to each of the Load Generator machines being used in the scenario. Or they have to be transferred to a shared network location so that both the machine used for creating the script and the load generator machines can reference it.

2. As mentioned in the forum post, any parameterization in the file contents is not possible. If the scenario requires files to be uploaded iteratively with unique names, that many files have to be created manually.


There are 2 solutions to this and one is more universally acceptable (by web servers) than the other. I'll describe both and let you decide which one you want to use. I also highly recommend reading RFC1867 which provides excellent background on how multipart file uploads are implemented in HTML form based submissions.

1. web_custom_request POST: To arrive at the solution, I did exactly what I usually do when I'm stuck with some HTML script or want to see the raw HTTP request being sent to any web server. I opened Webscarab to capture the HTTP request that was being sent for file uploads. (Webscarab related post here).

Here's a screenshot of the HTTP post request as captured by Webscarab:


And here's the relevant portions of the raw request:

Content-Type: multipart/form-data; boundary=---------------------------327572003712859
Content-length: 228

Content-Disposition: form-data; name="File"; filename="readme1.txt"
Content-Type: text/plain


The Content-Type HTTP header is what specifies the submission to be a multipart data submission. The "boundary" is a string that doesn't occur in the file data and is used to mark the boundaries of the data being sent. Content-length, as the name implies is the length of the data that is being sent.

The body of the request starts with the boundary string and is followed by the 2 headers to specify the content-disposition which includes the name of the file to be uploaded. Content-type specifies the encoding of the data being submitted. Following that within the body is a blank line and the actual contents of the file that will be uploaded. After the contents is the boundary once again to signify end of the submission data.

So this kinda makes it easier to create a web_custom_request. The Content-Type HTTP header is specified by "EncType" attribute of the function. Content-length header can be ignored since web_custom_request itself generates it by calculating the length of the data at runtime. The rest goes in the "Body" attribute starting with the boundary. Content-Disposition specifies among other things the name of the file to be uploaded and this can be parameterized. Content-Type is the type of file being uploaded and can be text/plain, image/gif etc. And in the end is the boundary once again. The final request looks like this:

        "EncType=multipart/form-data; boundary=---------------------------17773322701763",
        "Content-Disposition: form-data; name=\"File\"; filename=\"{rndString}.txt\"\r\n"
        "Content-Type: text/plain\r\n"

I have parameterized the file name to be a random string so I can run this script iteratively without having to worry about server rejecting duplicate files. I can also parameterize the contents of the file within the body to whatever I like so that each file is unique or based on some other logic.

2. web_custom_request PUT: The second option is more straightforward but less universally accepted. I've read that not all web servers implement this. It involves using the HTTP PUT to create a web_custom_request. For more on different HTTP methods, see It mentions that:

The fundamental difference between the POST and PUT requests is reflected in the different meaning of the Request-URI. The URI in a POST request identifies the resource that will handle the enclosed entity. That resource might be a data-accepting process, a gateway to some other protocol, or a separate entity that accepts annotations. In contrast, the URI in a PUT request identifies the entity enclosed with the request -- the user agent knows what URI is intended and the server MUST NOT attempt to apply the request to some other resource.

I've also read that PUT is more efficient so if your test site implements the uploads using POST, better do it that way instead. Nevertheless, here is the web_custom_request with PUT:


The resulting function is straightforward, URL attribute is the URI identifying the file to be uploaded and Body is the exact contents of the file.


  1. Thanks for the information.

    My text is hidden in the body of web_custom_request, in that case, how do I post/put the parameter value.

    Kindly let me know at the earliest.

    Thanks in advance,



  2. Great Post!! I had to search for over three hours to get here. But I do have a question.. I would highly appreciate if you could help.

    Here is the request.. xxxxx stands for the file content..

    "EncType=multipart/form-data; boundary=---------------------------7d937011403e8",
    "Body=-----------------------------7d937011403e8\r\nContent-Disposition: form-data; name=\"theFile\"; filename=\"PPDapprox1000.txt\"\r\nContent-Type: text/plain\r\n\r\nxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-----------------------------7d937011403e8\r\nContent-Disposition: form-data; name=\"filePath\"\r\n\r\nC:\\fakepath\\PPDapprox1000.txt\r\n-----------------------------7d937011403e8\r\nContent-Disposition: form-data; name=\"submit.x\"\r\n\r\n35\r\n-----------------------------7d937011403e8\r\n"
    "Content-Disposition: form-data; name=\"submit.y\"\r\n\r\n16\r\n-----------------------------7d937011403e8",

    Out here, the boundary does not stay the same for different users. I had to co-relate it. It is part of a request header so there is no way for me to capture it. Any pointers to work around this?

  3. >>Out here, the boundary does not stay the same for different users. I had to co-relate it. It is part of a request header so there is no way for me to capture it. Any pointers to work around this?

    Lokesh, the boundary doesn't have to be the same for different users. This boundary doesn't have anything to do with the file data being uploaded and is just a marker to signify the start and end of data. It can be anything as long as it doesn't repeat in the data itself. Try with a value that doesn't exist in all the data you're uploading and see if that works. Let me know.

  4. Hi

    It is really fantastic.helped me thank you.update more techniques.

  5. How did you solve the problem?

  6. Hi,

    I had a problem while uploading a video file. The file was converted to hexa decimal and the whole content was available. How do I parameterize the file?

  7. How can i upload the image file in the web request post method

  8. Very helpful article. Just wondering whether I can try this uploading file(Hexa Decimal) using web service. I have "Trouble scripting against a secure webservice that uploads files via MTOM" which is my current issue. I'm having trouble understanding how to script/incorporate the code in soap request using load runner such that 40MB file can be uploaded without any error. I did installed the patch LRVUG_00015.exe required to support the MTOM, still facing issue. Please advise. and can any one upload the load runner sample script of soap request using MTOM such that I can refer the same.

  9. Rather simpler solution is to record the script in URL mode using web_custom_request only.