Maintenance
Changing Activate Architecture
10 min
this document details how to move activate components, please read this document in full before attempting any architecture changes moving the activate database the activate sql server database contains all business rules and the activate metastore all other tiers access this to provide this information the location of the database is stored in the registry on each server that contains an activate component the location is stored in the appsettings json file in c \program files\activate\instances\\\<instance name>\appsettings json { "logging" { "loglevel" { "default" "information", "microsoft" "warning", "microsoft hosting lifetime" "information" } }, "corsorigins" \[ "http //localhost" ], "allowedhosts" " ", "instancename" "activate", "instancepath" "c \\\program files\\\activate\\\instances\\\activate\\\\", "assemblypath" "c \\\program files\\\activate\\\instances\\\activate\\\\", "traceconfigpath" "c \\\program files\\\activate\\\instances\\\activate\\\\", "installationtype" "full", "configversion" "5 0 0 0", "connectionstring" "server=activatesql;encrypt=false;integrated security = true;initial catalog=activate;" } changing the "activatesql" server above will change the location of the activate database any valid microsoft sql server connection string can be used http //msdn microsoft com/en us/library/system data sqlclient sqlconnection connectionstring aspx all services must be stopped before moving any database components on all servers we recommend backing up and restoring the database to the new server it is important that the collation of the temp database is the same as the activate database on the new server if this is a dedicated database server for the activate database then you can change the default collation of the server to be the same as the current activate database’s collation otherwise we recommend engaging a sql dba to assit process stop all windows services {{}} + iis etc on all servers backup the existing database on the new sql server, create any server based objects that have been created for the activate service you will need to at least create a role called 'activate administrators' and add any users/logins from the old server to it also check that there are logins for the activate administrator users on the new server restore the database ensure that the appropriate users and roles have access to the database mirror the previous access on the old sql server change the connection string in the registry on the activate job server to point to the new sql server run {{activateadministrator}} and ensure that you can connect to the database on the new sql server change the setting for sqlserver to the new sql server at //resources/configuration/sqlserver login as the {{activatejobservice}} service account run {{activateadministrator}} and ensure that you can connect to the database if you encounter any connection issues, check that the access permissions from the old sql server are mirrored to the new sql server moving {{activatejobservice}} {{activatejobservice}} is the server component that performs all background processing of activate jobs the component requires a connection to the activate database and has a reference to it within the database that is used by the web component when submitting jobs to the activate server the setting is stored in //resources/configuration jobserver in activate this setting should contain the name of the job server to which submit requests all services on all actiate servers must be stopped before moving any database components process 1\ ensure that any pre requisite components are installed on the new activate server server roles and features are installed as per the activate installation guide any microsoft exchange tools that are required for your environment other third party components 2\ login as the activate job service account 3\ install activate on the new activate server 4\ run activate administrator and run the full installation configuration use the installation guide for a new install to guide you except connect to the existing database instead of creating a new one 5\ run activate administrator and ensure that you can connect to the database it is recommended that you make the ip address for the new activate server the same as the old activate server (once the old activate server is shut down) to limit other changes required in the infrastructure such as firewall rules and any gateway changes moving the activate web server the activate web server tier runs under iis and is used by all users to connect to and view activate it is recommended that activate be referenced by users using a dns alias this allows the service to be moved to a new server without requiring any connection changes by users however, if a server name has been used instead all external references to activate will need to be changed all previous notification messages etc will not work unless an alias is created for the old server name that points to the new server process change the dns alias to the new server name install the activate web portal as per docid\ mey 5wfa0fnxfza5h1kax on the new server if this is a different server from the job server run activate studio and select 'client only' install in the configuration wizard this sets the database connection string into connect to localhost/activate connect to http //servername/activate open {{activateadministrator}} modify //resources/configuration/webserver to the new server dns name restart iis