Upgrading from ArcGIS Server 9.2

Before uninstalling ArcGIS Server 9.2 Service Pack 3 or later, you can export the ArcGIS Server users to be reused with ArcGIS Server 9.3.

Importing and exporting Local GIS Server users on Linux/Solaris

ArcGIS Java Server for the Linux/Solaris platform includes a Sun One Directory Server which gets installed with the Server. ArcGIS Server uses this directory server to maintain a repository of users that can use and manage ArcGIS Server over a local connection. When ArcGIS Server is uninstalled, the directory server is wiped clean and all user information gets deleted.

If you want to maintain this user list across multiple ArcGIS Server instances (or ArcGIS Server releases), you need to export your users list from ArcGIS Server into a text file. The users listed in this text file can then be imported into any deployment of ArcGIS Server for the Java Platform that has these tools available.

You can also leverage this functionality to maintain a backup of Local GIS Server users or replicate user information across several instances of the Server.

The tools to import and export Local GIS Server users

ArcGIS Server Java 9.2 Service Pack 3 and later for Linux/Solaris includes a tool driven by a shell script called "import_export_users.sh" located at <ArcGIS Server Installation Directory>/arcgis/scripts. This tool enables you to export Local GIS Server users to a text file. These users in a text file can then be imported into another instance of ArcGIS Server for the Linux or Solaris platform using the same tool. This tool is only available for installs including the SOM feature.

ArcGIS Server Java 9.2 Service Pack 3 and later includes additional utility tools that help you export users from a Windows machine into a text file (by running these additional tools on a Windows machine). The users in this text file can then be imported into ArcGIS Server for Linux or Solaris using the above mentioned "import_export_users.sh" script. The additional utility tools include a GUI-based and a console-based application to export your Windows users and is located at <ArcGIS Server Installation Directory>/arcgis/servercore/agsidsvr/import_export_users/windows

How to import and export Local GIS Server users on Linux/Solaris

You can run the script "<ArcGIS Server Installation Directory>/arcgis/scripts/import_export_users.sh". If you run the script without any input parameters, it will print the tool usage.

# ./import_export_users.sh

NAME

 

import_export_users.sh

SYNOPSIS

 

 ./import_export_users.sh [OPTION] FILENAME

DESCRIPTION

 

This utility is for exporting ArcGIS Server users to a file importing users into ArcGIS Server.
 

-i

import users from a file specified by FILENAME into ArcGIS Server
 

 

 -e

 

export ArcGIS Servers users to a file specified by FILENAME
 

 

-f

 

overwrite user(s) if exist during import.
 

This option can only be used with the import option.
 

-w

 

 import users exported from Windows platform specified by FILENAME
 

This option can only be used with the import option.
 


 -n

 

 no logging
 

 -o NEW_LOGFILE_PATH

 

path to a directory in which the log file will be written (by default the utility will log results in /<ARCGISHOME>/server/user/log/import_export.log)

• Exporting Local GIS Server users:

  ArcGIS Server users can be exported by using the '-e' option followed by the name of the file that should contain the users. The output of the tool summarizes the export. You can check the log file mentioned for more information on what users were successfully exported and if there were any errors. You can turn off the logging by using the '-n' option. By default, the logs are located at <ArcGIS Server Installation Directory>/arcgis/server/user/log. However, you can change the directory path by using the '-o' option.

  Example:-

  [user@machine /arcgis/scripts]# ./import_export_users.sh -e /tmp/users.dat

  EXPORT SUMMARY

  -------------------

  5 users exported successfully.

  Check log file for detailed information at /arcgis/server/user/log/import_export_Sat_Sep_29_13-24-53_2007.log

   

• Importing Local GIS Server users:

  Users that were exported by ArcGIS Server on Linux or Solaris can be imported by using the '-i' option followed by the name of the file that contains the users. The output of the tool summarizes the import. You can check the log file mentioned for more information on what users were successfully imported and if there were any errors. You can turn off the logging by using the '-n' option. By default, the logs are located at <ArcGIS Server Installation Directory>/arcgis/server/user/log. However, you can change the directory path by using the '-o' option.

  Example:-

  [user@machine /arcgis/scripts]# ./import_export_users.sh -i /tmp/users.dat

  IMPORT SUMMARY

  ---------------------------

  5 users imported successfully.

  Check log file for detailed information at /arcgis/server/user/log/import_export_Sat_Sep_29_13-24-53_2007.log

   

How to export Windows users and import them into ArcGIS Server for Linux/Solaris

ArcGIS Server 9.2 Service Pack 3 and later for Linux/Solaris includes additional tools that can be used to export Windows users. These tools for Windows are installed under <ArcGIS Server Installation Directory>/arcgis/servercore/agsidsvr/import_export_users/windows. Though these tools are included in the Linux/Solaris installs of ArcGIS Server 9.3, they are to be run on a Windows machine.

• GUI Application:

  Copy the "windows" directory from the Linux/Solaris machine to a Windows machine. Double click the "ExportWindowsUsers" file to start the GUI application.

  

  When the application starts up, it lists the users that can be exported. You select the user you want to export (or use the Select All check box to select all users), and browse to the file you want to export. If you choose to create a new file, you can click 'Export' and users will be exported to that file.

  

  If you tell the application to export selected users to a file that already exists, the two check boxes i.e. 'Overwrite file' and 'Append to file' will be activated. Accordingly, you can choose to either overwrite the user information in the existing file (file will lose its previous information) or append to it.

• Console-Based Application:

  The console-based application (run from the Windows command line) can be used when automating the export process (using the task scheduler, etc). It can be used to export a selected list of Windows users or all the users currently accessible to the system. Unlike the GUI application, the console-based application does not list available users.

  To run the Application, open a command prompt on a Windows machine and call the program named 'export_win_users_console.exe'. If no options are provided to the application, it will print the usage to screen.

  [D:\Projects]export_win_users_console.exe

  NAME

   
  
  export_win_users_console.exe

  SYNOPSIS

   
  
  export_win_users_console.exe [OPTION] /f FILENAME

  DESCRIPTION

   
  
  This utility exports all windows users that are accessible to the user account running this utility to a file specified by FILENAME
   

  /u USER1 USER2 ...

   
  
  exports only those users specified by space separated list following this option. If this option is not used all users are exported.
   

  /a

   
  
  append to file. By default, this utility will overwrite the user information. By using this option, you can choose to append to the file rather than overwriting it.
   

  /h

   
  
   prints the usage of the utility

  Example 1:- Exporting a selected list of users

  [D:\Projects]export_win_users_console.exe /u Guest Administrator SOM /f users.dat

  Example 2:- Exporting all the available users

  [D:\Projects]export_win_users_console.exe /f users.dat

  Example 3:- Exporting all users and appending to an existing file

  [D:\Projects]export_win_users_console.exe /a /f users.dat
   
• Importing Windows users into ArcGIS Server:

  The Windows users exported above can be imported into an ArcGIS Server running on Linux/Solaris by using the Server's "import_export_users.sh" script combining the import option along with the windows users option ('-iw').

  Example:-

  [user@machine /arcgis/scripts]# ./import_export_users.sh -iw /net/winshare/users.dat
  IMPORT SUMMARY
  ---------------------------
  5 users imported successfully.
  Check log file for detailed information at /arcgis/server/user/log/import_export_Sat_Sep_29_13-24-53_2007.log
  Note: The windows export tools only display those users that are available on the machine for the logged in user. If you run this tool on a domain controller, you will get list of all the users currently on the system.
   

The log files

The log files are created during the import/export operation. The log maintains the users that were successfully imported or exported or any errors that occurred during these operations.

By default, the logs files are maintained at <ArcGIS Server Installation directory>/arcgis/server/user/logs. Each log file name includes a timestamp that indicates when the log file was created.

You can choose to put the log files into a different location by using the '-o' option in the 'import_export_users.sh' script.

You can turn off logging by using the '-n' option.

Log file example:-

Export Users from ArcGIS Server - Sat Sep 29 13:24:53 2007

---------------------------------------------------------------------------

SUCCESS : admin

SUCCESS : agsadmin

SUCCESS : agsuser

SUCCESS : ACTUser

SUCCESS : SQLDebugger

EXPORT SUMMARY

-------------------

5 users exported successfully.