Sun Java System Web Proxy Server 4.0.11 Installation and Migration Guide

Chapter 3 Migrating From Version 3.6

This chapter contains migration information to help you understand the changes that take place when you migrate your Proxy Server from version 3.6.

This chapter contains the following information:

Migrating Settings and Data

Caution – Caution –

Shut down the server instance that you want to migrate. The port number of this server instance is migrated.

ProcedureTo migrate the server instance

  1. In the Administration Server page, click the Server tab.

  2. Click Migrate Server.

  3. Enter the server root of the server from which you want to migrate, and click Search.

    For example:


    Proxy Server detects whether there are server instances installed in the directory you specified, and displays the servers you can migrate in the section called Installed Servers.

    Note –

    The Administration Server cannot be migrated. Direct migration from a Proxy Server version lower than 3.6 is not supported. You must first migrate your legacy server to Proxy Server 3.6, and then to Proxy Server 4.

  4. Select a server from the drop-down list, and click Migrate.

    The Migration parameters page is displayed. The sections that are displayed depend on the features Proxy Server is using and which components you installed. The following sections of parameters are possible:

    • General. This section allows you to specify the server name and the UNIX user name.

      • Server name. Specify the name of the new Proxy Server instance.

      • User. (UNIX) Specify the UNIX user name that runs the new server instance. The default is the user name of the server instance as specified in the magnus.conf file of the old server if the administration user of the Proxy Server 4 installation is root. Otherwise, it is set to the Proxy Server 4 administration user name.

      Users and Groups. The migration tool checks in the dbswitch.conf file whether a local database is configured for the 3.6 instance and displays this section. You can export the local database to LDIF using the following option:

      • Export Localdb to LDIF File. Specify whether you want your local database exported to an LDIF file.

      Keys and Certificates. This section is displayed only if security (SSL) is enabled on the Proxy Server 3.6 instance. Certificates are migrated from the 3.6 versions to the supported NSS format. The old key password has to be provided.

    • Cache Settings. You can specify the cache directory and capacity.

      • Cache directory. Specify a new cache directory for the migrated server. The value <default> corresponds to ProxyServer4_installroot/ProxyServer_name/cache.

      • Cache capacity. Specify the capacity of the cache to be configured on the server. The cache size can range between 125 MB to 32000 MB. The default value of the cache capacity field on UNIX is the capacity of the Proxy Server 3.6 instance that is being migrated whereas on Windows the field displays 125 MB.

  5. Click the Migrate button.

    The Migration Log page appears. It shows the results of the migration, whether the migration succeeded or failed. It includes the parameters successfully migrated and the parameters you need to migrate manually. It also includes information about database settings and configuration file creation and shows any features of the 3.6 server that are not supported in the new version.

    The log page displays Assimilation Complete if the migration succeeded. The new server was created, but not started. To run the old instance in parallel with the new server instance, change the port number of the new server before starting it. To configure the migrated server using the Server Manager interface, click the Configure Migrated Server button.

    The log page displays Assimilation Failed if migration failed. If an error is encountered at any stage of the migration process, migration stops. Error messages provide information that will help you diagnose and fix any problems, so you can then retry migration.

Overview of Changes in Proxy Server

When you migrate information from Proxy Server 3.6 to Proxy Server 4, changes are made in the following areas:

Table 3–1 Command line scripts

Command line scripts  



  • Starts a server instance.

  • Each server instance has its own start script.


  • Stops a server instance.

  • Each server instance has its own stop script.


Restarts a server instance. 


Dynamically reconfigures the server without restarting it. 


Rotates logs. 




  • Starts a SOCKS server instance.

  • Stops a SOCKS server instance.

  • Restarts a SOCKS server instance.

Table 3–2 Configuration files

Configuration files  


ACL files: 

  • generated-proxy-server-id.acl

  • genwork-proxy-server-id.acl

  • Location: install_dir/httpacl/

  • These provide access control lists to protect server resources.

  • May reference databases defined in dbswitch.conf

  • File names are specified in server.xml

  • During migration, the syntax of the ACL files from the 3.6 server-root/httpacl directory is converted to the new syntax and the ACL files are copied toserver-root/httpacl directory with the new instance name.


  • Location: install_dir/userdb/

  • Configures how a client certificate is mapped to an LDAP entry.

  • Not migrated.


  • Location: install_dir/userdb/

  • Provides a list of authentication databases, and is used to check group membership for access control.

  • If localdb was configured in the 3.6 installation, the corresponding entry in thedbswitch.conf file is not migrated.

  • If the LDAP server that was configured for the 3.6 installation is also configured for the Proxy Server 4 installation, the corresponding entry in thedbswitch.conf file is not migrated.


  • Location:install_dir/server-id/config

  • Copied, during migration, into the new server root directory.

  • Some magnus.conf directives that were supported in Proxy Server 3.6 are deprecated in Proxy Server 4.

  • Certain directives found in the Proxy Server 3.6 magnus.conf file are now located in the Proxy Server 4 server.xml file. During the migration process, these directives are automatically removed from the 3.6server’s magnus.conf file and added to the server.xml file.


  • Location: install_dir/server-id/config/

  • Contains mappings between Multipurpose Internet Mail Extensions (MIME) types and file extensions.

  • During migration, the mime.types file is not migrated from Proxy Server 3.6 and is set to the default in Proxy Server 4.


  • Location: install_dir/server-id/config/

  • Defines server plug-ins library initialization and server parameters and contains instructions for the server about how to handle requests from clients.

  • During migration, Proxy Server 4 loads built-in load module functions from the new installation directory while custom modules continue to be loaded from the old installation directory.


  • Location: install_dir/server-id/config/

  • Contains most of the server configuration.

  • During migration, the server.xml file is created in the new Proxy Server 4 instance and contains information from the following files:

    - magnus.conf

    - obj.conf

    File cache parameters are set to default values in the FILECACHE element of the server.xml file.


  • obj.conf.clfilter

  • magnus.conf.clfilter

  • server.xml.clfilter

  • Location: install_dir/server-id/config/

  • The obj.conf.clfilter and magnus.conf.clfilter are copied during migration.

  • The server.xml.clfilter is created.

  • access log

  • error log

  • socks log

During migration, new logs are created.