English

How To: Change the hostname of the ArcIMS host machine

Summary

Instructions provided explain the modifications necessary when changing the hostname of the computer on which ArcIMS is installed.

Procedure

  1. Stop ArcIMS:
    On Windows, stop the three ArcIMS windows services in the following order:
    -ArcIMS Tasker
    -ArcIMS Monitor
    -ArcIMS Application Server

    On UNIX, stop the three ArcIMS daemons in the following order:
    -ArcIMS Tasker
    -ArcIMS Monitor
    -ArcIMS Application Server

    Alternatively, it is possible to stop the ArcIMS daemons automatically by using the script 'aims_shutdown' located under $AIMSHOME/Xenv.
  2. Modify hostname in the Esrimap_prop file
    A. Navigate to the ArcIMS Servlet Connector's directory within the Servlet Engine's Install Directory. Find the Esrimap_prop file.
    B. Open the Esrimap_prop file in a text editor and locate the variable AppServerMachine.
    C. Change this to match the new computer name.
    D. Save and close this file.
  3. Modify hostname in the Monitor Directory
    A. Navigate to the Monitor Directory within the ArcIMS installation directory:

    On Windows, this is usually located in: <drive>:\Program Files\ArcGIS\ArcIMS\Server\Monitor.

    On UNIX, it is located in: $AIMSHOME\Monitor.


    B. Open the Monitor.properties file in a text editor and locate the variable registryHost.
    C. Modify this variable to match your new computer name.
    D. Save and close this file.
  4. Modify hostname in the Tasker Directory
    A. Navigate to the Tasker Directory within the ArcIMS installation directory:

    On Windows, it is usually located in: <drive>:\Program Files\ArcGIS\ArcIMS\AppServer\Tasker.

    On UNIX, it is located in: $AIMSHOME\Middleware\Tasker.


    B. Open the Tasker.properties file in a text editor and locate the variable registryHost.
    C. Modify this variable to match your new computer name.
    D. Save and close this file.
  5. Modify hostname in the aimsdefaults.properties file
    A. Navigate to the location that contains the aimsdefaults.properties file:

    On Windows, this is usually located in: <drive>:\Documents and Settings\User_Name.
    On UNIX, it is in: $HOME directory for the ArcIMS user.


    B. Open the aimsdefaults.properties file in a text editor and locate the following variables:

    ImageURL
    HostName
    HostALIAS
    HostURL

    C. Modify these variables to match your new computer name.
    D. Save and close this file.
  6. Start ArcIMS:
    On Windows, start the three ArcIMS windows services in the following order:
    -ArcIMS Application Server
    -ArcIMS Monitor
    -ArcIMS Tasker

    On UNIX, start the three ArcIMS daemons in the following order:
    -ArcIMS Application Server
    -ArcIMS Monitor
    -ArcIMS Tasker

    Alternatively, it is possible to start the ArcIMS daemons automatically by using the script 'aims_shutdown' located under $AIMSHOME/Xenv.
  7. Checking for the new hostname
    A. Open ArcIMS Administrator and select View > Site Properties.
    B. On the ArcIMS Site Tab verify that the variables:

    Hostname
    Host ALIAS
    HTTP Location (URL)

    reference the new computer name. If not, change them to do so.
    C. On the ServerOutput Tab verify the variable HTTP Location (URL) references the new computer name. If not, change it to do so.

    Note:
    To make changes in the Site Properties use the Save button.

  8. Modify the hostname in the Java View Web sites
    A. One by one, navigate to each of the Java View Web sites and open the file default.axl in a text editor.
    B. Locate the URL element that is located within the WORKSPACE tag.
    C. Modify the value to reference the new computer name.
  9. Modify the hostname in the HTML Viewer Web sites
    A. One by one, navigate to each of the HTML Viewer Web sites and open the file ArcIMSparam.js in a text editor.
    B. Locate the variables imsURL and imsOVURL.
    C. Modify these values to reference the new computer name.
  10. Check the host's file and verify that there are no references to the old machine name. The host's file is usually located in:

    -Windows: <drive>:\WINNT\system32\drives\etc
    -UNIX: /etc/

  11. If additional Spatial Servers are installed on a remote machine
    A. Navigate to the Monitor Directory on the remote machine.

    On Windows, this is usually located in: <drive>:\Program Files\ArcGIS\ArcIMS\Server\Monitor.

    On UNIX, it is located in: $AIMSHOME\Monitor.


    B. Open the Monitor.properties file in a text editor and locate the variable registryHost.
    C. Modify this variable to match your new computer name.
    D. Save and close this file.