Create a Web Client site from the command line - SmartPlant Foundation - IM Update 46 - Administration & Configuration

SmartPlant Foundation Server Manager Help

Language
English
Product
SmartPlant Foundation
Search by Category
Administration & Configuration
SmartPlant Foundation / SDx Version
10

Using SPFServerManager.exe with the /createwcsite argument creates a new Web Client site. You must provide information about the new site using several additional arguments:

/sn: - names the new site (required).

/SPFserverurl: - sets the fully-qualified URL of the SmartPlant Foundation server (required).

/validateurls: [True/False] - conditionally validates the server and configuration service URLs as they should be validated interactively by Server Manager (optional). The default value is True.

/instrumentationKey: - Identifies the Application Insights instrumentation key on the client. When the instrumentation key is added, the client sends relevant telemetry to the Azure Monitor so you can analyze live application performance.

/bravastampsurl:[Brava Stamps URL] - identifies the fully-qualified URL to the Brava! stamps library (stamps.json). If your environment is hosted on a cloud, the URL must be external. If you are using Okta as your external OAuth authorization provider, the URL must be all lowercase.

  • The rootURL in the stamps.json file must point to the folder location of the stamps.json file. The stamps.json file is delivered to: [drive]:\SmartPlant Foundation Server Files\WebClient_Sites\[SiteName]\viewers\resources\stamps.

  • If your environment uses Chromium and the stamps.json file is not delivered by the application server, you must use IIS to add the following CORS attributes to the viewers resources folder:

    • Access-Control-Allow-Origin set to the fully-qualified URL for your application server

    • Access-Control-Allow-Credentials set to true

    • Access-Control-Allow-Headers set to x-requested-with

/bravasymbolsurl:[Brava Symbols URL] - identifies the fully-qualified URL to the Brava! symbols library (symbols.json). If your environment is hosted on a cloud, the URL must be external. If you are using Okta as your external OAuth authorization provider, the URL must be all lowercase.

  • The rootURL of the symbols.json file must point to the folder location of the symbols.json file. The symbols.json file is delivered to: [drive]:\SmartPlant Foundation Server Files\WebClient_Sites\[SiteName]\viewers\resources\symbols.

  • If your environment uses Chromium and the symbols.json file is not delivered by the application server, you must use IIS to add the following CORS attributes to the viewers resources folder:

    • Access-Control-Allow-Origin set to the fully-qualified URL for your application server

    • Access-Control-Allow-Credentials set to true

    • Access-Control-Allow-Headers set to x-requested-with

/odataurl:[OData URL] - sets the fully-qualified OData URL of the Smart API Services entry point for Web Client. For example: /odataurl:http://localhost/SPFserver/api/v2/SDA.

/clientservicesurl:[Client Services URL] - sets the fully-qualified URL of the location of the Web Client site's Client Services software. For example: /clientservicesurl:http://localhost/SDAClientServices/api/.

/downloadfilesizethreshold: - sets the download file size threshold limit (MB). Default value set to 200MB.

/downloadfiletimeout: – sets the download file timeout (minutes). Default value set to one minute.

/tlp - sets the path to the trace configuration log file folder location (optional). Use to change the path to a new trace log folder location; if not set, the path defaults to server trace log folder set in the configuration file.

/oauthissuerurl:[OAuth Issuer URL] - identifies the OAuth issuer URL.

/clientid:[Client ID] - identifies the OAuth client ID.

/identityprovider:[Identity Provider] - identifies the identity provider for OAuth.

/scopes:[Scopes] - identifies the OAuth scopes.

/usehttps:[Use HTTPS] - uses HTTPS connection when set to True (optional).

/externalhostname:[External Host Name] – uses the external host name for the site (Optional).

/port:[Port number] – sets the port number to be used for the site (Optional).

/sambaseurl:[SAM BASE URL] - identifies the OAuth issuer URL; required only if SAM is used.

/samusername:[SAM Login User Name] - identifies the administrative login user name for SAM; required only if SAM is used.

/sampassword:[SAM Login Password] - identifies the password for the administrative login for SAM; required only if SAM is used.

/validateoauthurl:[True/False] - indicates if the system should validate the External OAuth URL. Default is True.

/oauthredirecturi:[OAuth Redirect URL]- sets the fully-qualified URL of the Web Client logon page, as in the example: /oauthredirecturi:http://localhost:4200/.

OauthReditectUri2 is set from the OauthRedirectUri appending _session.html.

/postoauthlogoutredirecturi:[OAuth Post Logout Redirect URL] - sets the fully-qualified URL to where users are redirected after logout, as in the example: /oauthlogoutredirecturi:http://localhost:4200/.

If the site uses a SAM server when the OAuth redirect options are being updated, you must provide the SAM administrator credentials as follows:

/samusername: - Provides the SAM administrator user name.

/sampassword: - Provides the SAM administrator password.

If the site using the Intergraph Authorization Server (STS) when the OAuth redirect options are being updated, you must provide the administrator credentials as follows:

/stsusername: - Provides the STS administrator user name.

/stspassword: - Provides the STS administrator user name.

This example creates a web client site named SPFClient at the specified location of the Smart API Services entry point for Web Client.

SPFServermanager.exe /createwcsite /sn:SPFClient /odataurl:"http://serverhost/appserver/api/v2/sda"

This example creates a web client site called SPFClient for the SPF site named SDx at the specified location with SAM OAuth provider.

SPFServermanager.exe /createwcsite /sn:SPFClient /SPFserverurl:http://myhost.domain.com/SPF /sambaseurl:"http://samhost.domain.com/sam" /samusername:sysadmin /sampassword:123456

This example shows the usage of /usehttps, /externalhostname, and /port arguments to create a webclient site

SPFServermanager.exe /createwcsite /sn:SPFClient /SPFserverurl:https://myhost.domain.com/ /sambaseurl:"https://samhost.domain.com/sam" /samusername:sysadmin /sampassword:123456 /externalhostname: MyExternalHostName.com /port:455 /usehttps:true

This example creates a site called SPFClient for the SPF site named SPF at the specified location with an external OAuth provider (for example, Okta).

SPFServermanager.exe /createwcsite /sn:SPFClient /SPFserverurl:http://myhost.domain.com/SPF /clientid:0oag04x1t1cW5miJS0h7 /oauthissuerurl:"https://dev597594.oktapreviewcom/oauth2/ausg0871hp0DCijdr0h7" /oauthredirecturi:"https://okta-SPF.12345.com/SPFwebclient" /oauthredirecturi2:"https://okta-SPF.12345.com/SPFwebclient" postoauthRedirecturi:"https://okta-SPF.12345.com/separatelogoutURLpath"

This example uses the /log: argument to generate a log file that stores results and errors from the operation. Specify a path and file name for the target log file (an extension is not required for the file).

SPFServermanager.exe /createwcsite /sn:SPFClient /SPFserverurl:http://myhost.domain.com/ /sambaseurl:"http://samhost.domain.com/sam" /samusername:sysadmin /sampassword:123456 /log:"C:\SmartPlant Foundation Server Files\Temp\SPFServerManager\SPFClientcreation"

This example creates a Web Client site and installs the Application Insights instrumentation key on the server to analyze application performance.

SPFServermanager.exe /createwcsite /sn:SPFClient /sambaseurl:"http://samhost.domain.com/sam" /samusername:sysadmin /sampassword:123456 /instrumentationKey:1234-abcd-EFGH

This example creates a Web Client site called SPFClient and sets the download file size threshold to 200MB and download file timeout to 1 minute.

SPFServermanager.exe /createwcsite /sn:SPFClient /SPFserverurl:http://myhost.domain.com/SPF /sambaseurl:"http://samhost.domain.com/sam" /samusername:sysadmin /sampassword:123456 /downloadfilesizethreshold:200 /downloadfiletimeout:1

This example creates a Web Client site called SPFClient with an upload file chunk size in mb setting of 5.

SPFSDxServerManager.exe /createwcsite /sn:SDXWC /filechunksizeinmb:5

This example creates a Web Client site with a peek search setting of 3.

SPFServerManager.exe /createwcsite /sn:SDXWC /peeksearchcharacterscount:3