Unsupported content


This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Changing the location of the file server

BMC Server Automation supports the use of only one file server at a time. This file server includes one host and one root directory location. In certain cases, you might need to change the location of the file server. For example, you might decide to move the file server from a single application server (with a typical //myfileserver/ path) to a virtualized or centralized file server (with a path such as //localhost/ or //blfs/).

After moving the file server to its new location, you must ensure that all references to the file server in the various files and NSH scripts point to the correct location.

BMC Servers Automation provides a series of scripts that help you accomplish this task. Scripts are provided to check the file server references, specify the default file server, and consolidate all such references, so that they all point to the new location of the file server. Before you run the scripts, you must ensure that the contents of the old file server are replicated to the same relative path under the new file server.


Ensure that you stop the Application Server prior to making any file server changes.

Overview of the scripts

The following table lists the available database scripts.

Script name



Tells you how many file servers exist in the BMC Server Automation system, which one is the default file server, and how many database references point to each file server. The system can use multiple file servers as long as it can read from the non-default file servers. All new files are written to the default file server.

(.sql or .bat for SQL server)

Lets you change which file server is now considered the default file server. The file server you designate as the new default file server must be one of the file servers that appeared as output from the file_server_check script. You cannot use this script to add new file servers. (To add new file servers, use blasadmin set file server name.)

This script does not change any locations for the references in the database. You might want to use this script if you have multiple file servers defined in the database and you want to change which one is the default and therefore which one the system will now start writing to. This lets you not have to consolidate all files onto one server, in a situation where you might not have enough space on one machine.

file_server_change_<databaseType> (.sql or .bat for SQL server)

Takes all the database references that point to non-default file servers and changes them to references that point to the default file server. You might want to use this script if you want to copy the contents of all file servers to one machine, and then change all the database references to point to that one machine.

Note: Updates are batched by up to 10,000 rows at a time. Changes are committed for each batch. In case of failure, the script can be executed again to finish the file location update process.

update_extended_object_script_location (.sql or .bat for SQL server)Updates the extended object definitions which are stored on the file server.

To change the location of the file server

  1. Run the file server check script to ensure there is only a single file server. See Checking file server references.
  2. Based on the results of the script, do one of the following:
    • If the script determined that there are multiple file servers, complete the steps to get to a single file server. See Consolidating multiple file servers.
    • If the script confirms that there is a single file server, continue to the next step to change file server.
  3. Change location of the file server and move any applicable files to the new file server. See Changing the file server from one location to another.
  4. Execute the update_extended_object_script_location script to update the extended object definitions that reference the file server. See Updating extended object definitions with new file server location.
Was this page helpful? Yes No Submitting... Thank you