Support Center

Migrating to a New Machine (SDM)

Last Updated: Jul 15, 2015 03:14PM MDT

Overview

In the event that the SIFWorks Directory Manager Agent (SDM Agent) and/or SIF environment undergoes changes that requires that the SDM Agent be moved/re-installed to a new machine, the tips below will guide you though the process.

The most critical piece in a successful SDM Agent migration is the agent.cfg file from the old server. If this file is no longer available, the zones and any configuration changes made for SDM Agent implementation will need to be re-created.

Things you will need to know to continue

Current installation directory for the SDM Agent.

  It is not uncommon to find multiple copies of the SDM Agent on a server.
  If you are confused as to which copy the server is running, follow the instructions below.

  • Click Start >> Select  Run...
  • Type services.msc >> Select OK
  • Locate the "Data Solutions SIFWorks Directory Manager" service
  • Right click on the service >> Select Properties
      The Path to executable location on the General tab will let you know where to look for the active SDM instance.
  • Write down this path as you will need it later.

Preparation work for the old server

​Uninstall the SIFWorks Directory Manager Agent

  • Click Start >> Select  Run...
  • Type appwiz.cpl >> Select OK
  • Right click SIFWorks Directory Manager >> Select Uninstall
  • Follow the instructions in the Uninstallation Wizard

Move the SDM Agent to the new server

  • Navigate to the SDM Agent install location
  • Right click on the directory that contains the agent.cfg file >> Send to >> Compressed (zipped) folder
  • Move this zipped folder to the new server

Move the database files to the new server

  • Click Start >> Select  Run...
  • Type services.msc >> Select OK
  • Locate the SQL Server (DATASOLUTIONS) service
  • Right click on the service >> Select Stop
  • Navigate to "C:\Program Files (x86)\Microsoft SQL Server\Data\MSSQL.1\MSSQL\Data"
  • Copy DirectoryAgent.mdf and DirectoryAgent_log.LDF to a temporary location on the new server

By this point you should have a zipped copy of the SDM Agent and the two database files on the new server. If this is not the case please read though Preparation work for the old server once more.

Preparation work for the new server

Verify that the .NET Framework version 4 or higher is installed

  • Open Internet Explorer
  • Navigate to http://smallestdotnet.com
    This is the easiest way to check which version of the .NET Framework you have installed.

Verify that PowerShell version 2 or greater is installed

  • Click Start >> All Programs >> Accessories >> Windows PowerShell >> Windows PowerShell
  • Type $HOST >> Verify that the Version row states Version : 2.0
    *Currently only PowerShell Version 2.0 or greater is supported by the SDM Agent 

Verify PowerShell remote execution policy is set to remote signed

*On a 64bit machine, the following will need to be done in both Windows PowerShell and Windows PowerShell (x86).

  • Click Start >> All Programs >> Accessories >> Windows PowerShell >> Windows PowerShell 
  • Type Get-ExecutionPolicy >> Hit Enter
    If you see RemoteSigned or Unrestricted you are all set. If you see anything else do the following steps.
  • Type Set-ExecutionPolicy RemoteSigned >> Hit Enter
  • Read the Execution Policy Change >> Type Y > Hit Enter

Installing the SDM Agent on the new server

Download the current SDM Agent Installer

  • Please refer to Kimono support article 925990 for detailed instructions on how to download the latest SIF Agent

Unzipping the SDM Agent backup file on the new server

  • Create a new folder at "<DriveLetter>:\Kimono\SIFWorks Directory Manager"
  • Double click on the zipped SDM Agent that was copied from the old server
  • Copy the contents of the zipped folder to the new SIFWorks Directory Manager folder so that the agent.cfg file is located at "<DriveLetter>:\Kimono\SIFWorks Directory Manager\agent.cfg"

Run the SDM Agent Installer

  • Follow the instructions on the installation wizard
  • When you get to the screen to change the Installation path it is extremely important that you choose
    "<DriveLetter>:\Kimono\SIFWorks Directory Manager"
    *If this step is not followed closely you will need to uninstall and reinstall the SDM Agent again.
  • Continue to follow the instructions on the installation wizard.

Move the copied database files into place on the new server

  • Click Start >> Select  Run...
  • Type services.msc >> Select OK
  • Locate the SQL Server (DATASOLUTIONS) service
  • Right click on the service >> Select Stop
  • Navigate to "C:\Program Files (x86)\Microsoft SQL Server\Data\MSSQL.1\MSSQL\Data"
  • Replace the DirectoryAgent.mdf and DirectoryAgent_log.LDF files that were created by the installer with the database files from the old server.
  • Locate the SQL Server (DATASOLUTIONS) service
  • Right click on the service >> Select Start

Restart the SDM Agent

  • Click Start >> Select  Run...
  • Type services.msc >> Select OK
  • Locate the "Data Solutions SIFWorks Directory Manager" service
  • Right click on the service >> Select Restart

Connect the management console and check connectivity

  • Locate the SDM Agent Console in the system tray >> Click on the icon.
  • Click Connect
  • Verify the zone has a green circle with a checkbox and says Idle (if the Idle label is flashing that is ok as well)


 

Troubleshooting

If you do not see any zones in the console:

  1. Verify that you installed directly over the old Agent.cfg file.

      To fix this issue please refer to the "Run the SDM Agent Installer" portion of this document. 

If zones are not re-connected successfully, you may see either of these 2 conditions in the console:

Zone Disconnected:

  • Click on the disconnected Zone
  • Click Zone >> Zone Settings...
  • Select General in the left column
  • Click Change... >> Verify the URL is pointing correctly to the ZIS
    *the most common change that needs to be made is to change localhost or 127.0.0.1 to the internal IP Address of the server that contains the ZIS

​  SIF Database Unavailable:

  • Click File >> Agent Settings
  • Select Database in the left column
  • Modify the connection information as needed
support@kimonocloud.com
http://assets1.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete