Configuring Feedback Preferences for Offline Systems
To configure the Send Feedback action on an offline system to send feedback to a Servigistics InService server you must configure a list of recipients to which feedback e-mails can be sent. This list is configured for the main Servigistics InService system through the Feedback Recipients preference in the Preference Management administration utility. Since the administration utilities are not available on offline systems, the list of recipients must be configured as part of deploying the offline system. This list can be configured in the following ways:
• Manually
• Using a customized batch file
Configuring the InS.properties File for Feedback
Complete the following steps to configure the Send Feedback action to function on an offline system:
1. Open the InS.properties file from the following location: <InService_Install_Files>\Media
2. Add the following entries to the InS.properties file:
WC_XCONF.[codebase.war/wt.properties].wt.mail.mailhost=<mailhost>
WC_XCONF.[codebase.war/wt.properties].com.ptc.sc.preferences.feedbackRecipient= <feedbackRecipient>
where <mailhost> is the name of the mail host of the customer server, and <feedbackRecipient> is the e-mail address for the feedback recipient.
Manually Configuring for Feedback
To manually create this list of preferences, use the following procedure:
1. On the web server export all user preferences:
◦ Using a Windchill shell navigate to Windchill.ear/bin.
◦ Run Windchill shell.
◦ Export the preferences using the following command, using the appropriate Administrator name and password: windchill wt.preference.ExportPreferences -onlyInstances -excludeHiddenInstances- user=<AdministratorName> -password=<AdministratorPassword>
2. On the offline system, import the preferences from the web server:
◦ Using a Windchill shell navigate to Windchill.ear/bin.
◦ Run Windchill shell.
◦ Import the preferences using the following command, using the appropriate Administrator name and password: windchill wt.preference.ImportPreferences -importfile=<filepath> -overwriteValueConflicts -skipUnresolvedConflicts user=<AdministratorName> -password=<AdministratorPassword>
Using a Customized Batch File
To create a batch file that can be used to automatically import preferences to an offline system, use the following procedure:
1. Copy the preferences.xml file to the following location: <Installer Media> Customization/Software.
2. Using the example below, customize the setup.bat file to import the preferences.
|
Preferences are imported after the server is started. You must restart the server again after the import.
|
3. Run the offline installer.
Use this example script to create your own customized batch file:
@ECHO OFF
REM STOP THE INSERVICE SERVER BEFORE UNZIPPING THE PACKET
REM %CD% GIVES YOU THE WINDCHILL.EAR LOCATION. THE OTHER PATHS CAN
REM BE RELATIVELY CALCULATED.
ECHO "LOADING PREFERENCES" >> %CD%\CUSTOMSETUP.LOG
SET ORIGINAL=%CD%
REM STOPPING THE SERVER.
CD %CD%\..\..\
ECHO "STOP THE SERVER..." >> %ORIGINAL%\CUSTOMSETUP.LOG
CALL STOPSERVER.BAT >> %ORIGINAL%\CUSTOMSETUP.LOG
ECHO "STOPPED THE SERVER ..." >> %ORIGINAL%\CUSTOMSETUP.LOG
REM STARTING THE SERVER..
ECHO "RESTART THE SERVER..." >> %ORIGINAL%\CUSTOMSETUP.LOG
REM CD %CD%\..\..\
CALL STARTSERVER.BAT >> %ORIGINAL%\CUSTOMSETUP.LOG
REM ECHO "END DEPLOYING THE CUSTOMIZATION PACKAGE" >> %ORIGINAL%\CUSTOMSETUP.LOG
ECHO "SLEEP FOR THE SERVER TO START... SLEEP FOR 300 SEC OR 5 MINS TO ENSURE THAT THE SERVER GETS STARTED COMPLETELY" >>
%ORIGINAL%\CUSTOMSETUP.LOG
SLEEP 300S
ECHO "IMPORTING PREFERENCES"
CD %ORIGINAL%
REM CALL WINDCHILL SHELL
SET CLASSPATH=%ORIGINAL%\CODEBASE.WAR;%ORIGINAL%\CODEBASE.WAR\WEB-INF\CLASSES;%ORIGINAL%\CODEBASE.WAR\WEB-INF\LIB\*;
SET CLASSPATH=%CLASSPATH%;%ORIGINAL%\LIB\*;%ORIGINAL%\..\..\SYSTEM\JAVA\LIB\TOOLS.JAR;
SET CLASSPATH=%CLASSPATH%;%ORIGINAL%\..\..\SYSTEM\WILDFLY\MODULES\SYSTEM\LAYERS\BASE\COM\PTC\E3C\MAIN\*
ECHO %CLASSPATH%
ECHO %CLASSPATH% >> %ORIGINAL%\CUSTOMSETUP.LOG
%CD%\..\..\SYSTEM\JAVA\BIN\JAVA WT.PREFERENCE.IMPORTPREFERENCES -IMPORTFILE=%~DP0PREFERENCES.XML
-OVERWRITEVALUECONFLICTS -SKIPUNRESOLVEDCONFLICTS -USER=DEFAULTADMIN -PASSWORD=F2QZPOAG >> %ORIGINAL%\CUSTOMSETUP.LOG
CD %ORIGINAL%
REM STOPPING THE SERVER.
CD %CD%\..\..\
ECHO "RESTARTING SERVER AFTER PREFERENCE LOADING"
ECHO "STOP THE SERVER..." >> %ORIGINAL%\CUSTOMSETUP.LOG
CALL STOPSERVER.BAT >> %ORIGINAL%\CUSTOMSETUP.LOG
ECHO "STOPPED THE SERVER ..." >> %ORIGINAL%\CUSTOMSETUP.LOG
REM STARTING THE SERVER..
ECHO "RESTART THE SERVER..." >> %ORIGINAL%\CUSTOMSETUP.LOG
REM CD %CD%\..\..\
CALL STARTSERVER.BAT >> %ORIGINAL%\CUSTOMSETUP.LOG