TeamcenterKnowledge

Managing, testing, and troubleshooting the Aurora integration

Start and stop the TC-Aurora Connector server for a model

This is not an installation or a configuration step.

This step is required when a Teamcenter user is ready to export data from Teamcenter to Aurora for any new model. The administrator must start the TC-Aurora Connector server for that model, which will internally start the Aurora API client for the same model. Once the TC-Aurora connector server for a model is running, the data can be exported from Teamcenter to Aurora and vice-versa. To simplify the TC-Aurora connector server start and stop process, IPP&E has provided some scripts for the administrators.

The IPPE TC-Aurora Connector package contains the following .ini files:

File Purpose
startAurora.ini This file contains the model entries for which the TC-Aurora connector must be started. If the data for a new model is ready to be exported, the administrator can update this file with that model.
stopAurora.ini This file contains the model entries for which the TC-Aurora connector has to be stopped. To stop the TC-Aurora connector server for any model, the administrator must update this file and remove the entry of that model from the startAurora.ini file.

The format of these model entries is <Model_ID>|<Model_Name>, where Model ID is the Project WBS Root ID and the Model Name is the Project WBS Root name.

Start and stop the TC-Aurora connector server as follows

  1. Open the Aurora.bat file and update JAVA_HOME, PERL_HOME and CONFIG_LOCATION, where CONFIG_LOCATION is the location of the config.cfg file.

  2. Update the config.cfg file to make sure it contains all valid entries.

  3. In a command window, navigate to the directory location that contains the Aurora.bat script.

  4. Run the Aurora.bat script.

    This script starts the RMI registry if it is not started with the port set in the config.cfg file.

The options for the Aurora.bat script are as follows:

Option Use
start The script starts the TC-Aurora connector server process for all the models that are listed in the startaurora.ini file. It ignores the models for which the TC-Aurora connector is already running.
stop The script will stop the TC-Aurora connector server process for all the models that are listed in the stopaurora.ini file.
stopall This option is used to stop all the TC-Aurora connector server processes that are running and to remove them from the registry.
startmodel <Model_ID|Model_Name> This option is used to start the TC-Aurora connector server for a specified model.

Note

It is recommended that the administrator updates the model details in the startaurora.ini file as well so that if the Start option is used to start the TC-Aurora connector server for all the models after all the services are shut down (for example, because of maintenance), it will also pick up the models that were individually started.

Note

The Aurora.bat script internally uses PowerShell. It is important to have the latest version of PowerShell. If the TC-Aurora Connector server is already running for any model, the script will not start another session. If the PowerShell version is old, this functionality will not work, in which case the administrator must ensure that there are no duplicate TC-Aurora connector sessions.