Server 10 Unix Install Guide - Upgrading from ArcGIS Server 9.2 or later

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

Importing and exporting local ArcGIS Server users on Linux/Solaris

ArcGIS Server—Java for the Linux/Solaris platform includes a Sun ONE Directory Server that is installed with ArcGIS 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 is 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 ArcGIS Server users or replicate user information across several instances of ArcGIS Server.

The tools to import and export local ArcGIS Server users

ArcGIS Server 9.2 Java 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>/scripts. This tool enables you to export local ArcGIS 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 installations including the SOM feature.

ArcGIS Server 9.2 Java 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- and console-based application to export your Windows users, which is located at <ArcGIS Server Installation Directory>/servercore/agsidsvr/import_export_users/windows.

How to import and export local ArcGIS Server users on Linux/Solaris

You can run the script <ArcGIS Server Installation Directory>/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 ArcGIS 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 logging by using the -n option. By default, the logs are located at <ArcGIS Server Installation Directory>/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 ArcGIS 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 logging by using the -n option. By default, the logs are located at <ArcGIS Server Installation Directory>/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>/servercore/agsidsvr/import_export_users/windows. Though these tools are included in the Linux/Solaris installations of ArcGIS Server 10, 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, 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 (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 prompt) can be used when automating the export process (using the task scheduler, and so on). 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 ArcGIS Server running on Linux/Solaris by using the server's import_export_users.sh script and 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 a list of all the users currently on the system.

The log files

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

By default, the log files are maintained at <ArcGIS Server Installation Directory>/server/user/logs. Each log file name includes a time stamp 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 : adminSUCCESS : agsadminSUCCESS : agsuserSUCCESS : ACTUserSUCCESS : SQLDebuggerEXPORT SUMMARY-------------------5 users exported successfully.

Published 6/24/2010