Views:

Question:
How do I move Fortis to other servers?

Solution:
This document will guide you in the necessary steps to take when moving a Fortis server.
The procedure for Fortis SE assumes that both the Database Server and Application Servers are being moved.
The procedure for Fortis for SQL Server assumes that the Database Server is staying put and that the Application Server is being moved.

  1. Perform a new Fortis installation on the new server using the instructions provided in the Fortis Installation Guide.
  2. Apply any applicable service packs to Fortis.
  3. Perform a workstation setup on one machine to facilitate the rest of the migration.
  4. Before transferring any files whatsoever, make a complete backup copy of both the Fortis and FortisDT directories.
  5. Log into the System Administration Station and change the SYSADM password to match that which you have in your old installation.
  6. Exit Fortis and copy the following files and directories from the SYSDATA directory of the old server to the same directory on the new server: users.dat, inbaskets.dat, ldap.ini, the OBJECT directory
  7. Correct the location of the In Baskets, if they are to be moved. It is recommended that all In Baskets be cleared of any files as this will make the process simpler. To do so, follow these steps:
    1. Log into the System Administration station and open the In Baskets window.
    2. Click on the “Def. Path” grey button or choose “Default In Basket Path” from the menu.
    3. Adjust this path to reflect the new default location for In Baskets.
    4. Note: When adjusting the Default In Basket Path, any In Basket that was previously set to use the default location will automatically switch to the location it had been using before the Default Path was changed. “Use default location” will become deselected.
    5. Open each individual In Basket and check “Use default location” to any In Basket that had previously been using the default location on the old server. This will create a new folder in the new default location on the new server.
    6. Copy any files that were present in In Baskets on the old server to the corresponding In Basket folder on the new server.
  8. Attach or install the Fortis databases if you have moved or reinstalled your Database Server.
    1. Fortis SE or Fortis Embedded
    2. Open the dbs.ini from the old server and note the DBdir= value in [DBSetup] section.
    3. Navigate to this directory on the old Database Server.
    4. Note: In order to copy the data files, the databases must not be in use by SQL Server at the time. Consult with a SQL Server administrator to facilitate this.
    5. Copy the .mdf and .ldf files corresponding to the names of the databases used in Fortis and move them to the directory noted in the DBdir= value of the dbs.ini on the new Database Server.
    6. Again, in the dbs.ini of the old server, note that each database has a section denoted by its name in square brackets, e.g.: [Records]. Within each section there will be an equal pair of values, LogFilePath= and FullTextInfo=. This directory is typically known as the Related files directory. Copy these directories to an equivalent location on the new server.
    7. Log into the Database Administration Station, hit “Open DB,” and click the “Install..” button.
    8. Type in or choose the name of the database. In most cases, this will consist of the “dbname” portion of dbname.mdf.
    9. For the related database files directory, give the new location of the corresponding Related files directory.
    10. Hit “OK” and your database will be installed.
    11. Note: There are circumstances which may prevent the Install Database function from recognizing the files in the new DBdir= directory. If this is the case, refer to the reference section “Attaching Fortis databases to a new SQL Server”. After attaching the database, run the Install Database command once more. The attached database will now appear in the drop-down list.
      1. Fortis for SQL Server and Fortis for Oracle
      2. Moving SQL databases from one server to another is a complicated process and should only be done by an experienced SQL Server administrator. Refer to the section “Attaching Fortis databases to a new SQL Server” for guidelines on how this can be done. The moving of Oracle databases should only be attempted by DB administrators certified by Oracle.
      3. In the dbs.ini of the old server, note that each database has a section denoted by its name in square brackets, e.g.: [Records]. Within each section there will be an equal pair of values, LogFilePath= and FullTextInfo=. This directory is typically known as the Related files directory. Copy these directories to an equivalent location on the new server.
      4. Copy the dbs.ini file from the old SYDATA directory to the new one.
      5. Edit all references to the old server in the new dbs.ini file to reflect the server change. These values typically are multiple instances of SERVER=, FullTextInfo=, and LogFilePath=.
      6. After editing the dbs.ini file, the Fortis workstations will now show the moved databases.
        1. Correct the image archive locations in the database if they are to be moved.
        2. Copy your image archive directories to the new server.
        3. Log into the Database Administration Station and open the database.
        4. Change the archiving location for all future documents.
          1. In the Document Explorer window, right-click and get the properties of the root folder of the database.
          2. Under the Archive tab, update the archive path to reflect the new location of the image archive. Hit “OK” to exit the folder properties window.
          3. These steps must be repeated for any folder in the database that has an archive location set in its Archive tab. When an archiving location is blank in a folder’s properties, it will inherit the location from its parent folder.
  9. Update the archive path for all existing documents.
    1. In the Database Administration Station, choose Tools>Update Archive Path. For instructions on how to use this tool, consult the documentation.
    2. To confirm that the command has worked, open the Update Archive Path tool once more and check to make sure that any paths pointing to the old server are gone. There are some configurations where you may see the an old path still appear on the list even though the tool had definitely run on that path previously. Simply repeat the steps above until the old path does not appear in the original archive list.
  10. Set up your backup solution for the new server.
  11. Deploy the remaining workstations, using the Fortis Installation Guide as a reference