Verifying and Performing Post-Installation Tasks

The person designated as the System Administrator for X-CAD Design Management is assigned the Integration Administrator and Integration User roles. These roles allow access to the menus and options required to configure and maintain X-CAD Design Management.

The installation process uses the person Test Everything, who is assigned these roles.

When upgrading from an earlier release, most of the steps in this procedure have already been done. Use the procedure as a checklist to ensure the proper roles and permissions have been set for your users.


Before you begin:

Complete the installation procedures for your platform.

  1. Run the following MQL commands.
    Run MQL from the Live Collaboration Server folder or from 3DSpace. For more information, see Installation and Setup | Administrate | 3DEXPERIENCE Platform | 3DSpace | Collaboration and Approvals | Administrative Utilities | Running MQL
  2. Run MQL>print person <USER_NAME> select business; (output - true if user have business administration privilege) where <USER_NAME> is the name of user which is used to set context.
    You must have business administration privilege (specified in the person definition in schema).
  3. Locate the IEF-GlobalRegistry object.
    This object contains details about all installed integrations MQL> print bus IEF-GlobalRegistry IEF-GlobalRegistry-!history; The !history is optional.
  4. Identify the Global Configuration Objects (GCOs) for the collaborative products you installed and set the Global preferences.
    The preferences entered in the GCO are copied when you assign a collaborative product to a user, so you should set the GCO preferences prior to making any assignments. If Global Preferences are set for the collaborative product after it is already assigned, it must be re-assigned to the intended users.
  5. Follow below steps if you upgraded from an earlier release.
    1. Create Person objects for the users who will use X-CAD Design Management using MQL>add person <USER_NAME> password <PASSWORD>; where <USER_NAME> is the name of user and <PASSWORD> is Password for user. For an example, MQL>add person user1 password user1;
    2. Create Roles and Groups as appropriate, and add users to the roles and groups using MQL>add role <ROLE_NAME> assign person <USER_NAME>; or MQL>add group <GROUP_NAME> assign person <USER_NAME>; For example, MQL>add role role1 assign person user1; MQL>add group group1 assign person user1;
    Assign the collaborative product to these users.
  6. Assign the collaborative product to these users.
    When you assign a collaborative product to a user, the settings are copied from the GCO to a Local Configuration Object (LCO) for each user. The IEF-IntegrationToGCOMapping attribute lists all the collaborative products assigned to the user and the default GCO to use for that integration. For more information, see Assigning Collaborative Products to Users. MQL>print bus MCADInteg-LocalConfig <USER_NAME> TEAM select attribute[IEF-IntegrationToGCOMapping]; For example,

    MQL>print bus MCADInteg-LocalConfig user1 TEAM select attribute[IEF-IntegrationToGCOMapping];

    The setting looks as follows:

    SolidWorks|SWNewArch

    You can edit the LCO for individual users as needed. See Entering LCO Attribute Values.

  7. Assign the collaborative product to yourself, the Integration Administrator, for access to the X-CAD Design Management features.