{"type":"doc","content":[{"type":"paragraph"},{"type":"expand","attrs":{"title":"Older Versions"},"content":[{"type":"paragraph","content":[{"text":"BSNEE Version 4.5.6","type":"text","marks":[{"type":"link","attrs":{"href":"https://brightsign.atlassian.net/wiki/spaces/BV4/pages/1394769921"}}]}]},{"type":"paragraph","content":[{"text":"BSNEE Version 4.5.5","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/BV4/pages/2819570"}}]}]},{"type":"paragraph","content":[{"text":"BSNEE Version 4.5.2","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/BV4/pages/2819112"}}]}]},{"type":"paragraph","content":[{"text":"BSNEE Version 4.4","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/BV4/pages/2819916"}}]}]},{"type":"paragraph","content":[{"text":"BSNEE Version 4.2","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/BV4/pages/2819406"}}]}]},{"type":"paragraph","content":[{"text":"BSNEE (legacy versions)","type":"text","marks":[{"type":"link","attrs":{"href":"https://support.brightsign.biz/hc/en-us/articles/218067797-User-Guides-and-Documentation"}}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"The BrightAuthor Configurator provides an easy way to edit the installation executable file for BrightAuthor. After you use this tool, you will be able to distribute copies of BrightAuthor that point to BrightSign Network Enterprise Edition URLs of your choosing. This technical note will also show you how to provide a link to your custom BrightAuthor installer on the BSNEE WebUI. Refer to the end of this document for the limitations of this tool.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Using the Configurator","type":"text"}]},{"type":"paragraph","content":[{"text":"You will find the ","type":"text"},{"text":"BrightAuthorConfigurator.exe","type":"text","marks":[{"type":"strong"}]},{"text":" file in the ","type":"text"},{"text":".zip","type":"text","marks":[{"type":"em"}]},{"text":" archive that you downloaded:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Extract ","type":"text"},{"text":"BrightAuthorConfigurator.exe","type":"text","marks":[{"type":"strong"}]},{"text":" file from the ","type":"text"},{"text":".zip ","type":"text","marks":[{"type":"em"}]},{"text":"archive.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the file. You will see a window containing several fields.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":776,"id":"d3e8d47d-d328-4a64-bc7e-711b964342a8","collection":"contentId-6524819","type":"file","height":505}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Basic Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"If you used standard domain names for BSNEE services during the BSNEE installation process, you should perform ","type":"text"},{"text":"Basic Configuration","type":"text","marks":[{"type":"em"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"BrightAuthor Installer File","type":"text","marks":[{"type":"strong"}]},{"text":": Locate and select the BrightAuthor installer executable file (","type":"text"},{"text":".msi","type":"text","marks":[{"type":"em"}]},{"text":") you wish to configure. Alternatively, you can locate the BrightAuthor installer in Windows Explorer and drag it into the configurator file.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Basic Configuration","type":"text","marks":[{"type":"strong"}]},{"text":": Enter the ","type":"text"},{"text":"Base Domain Name ","type":"text","marks":[{"type":"strong"}]},{"text":"that was used in the BSNEE installer. The domain names of BSNEE nodes will be generated automatically using the base domain name.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Target BSNEE Version","type":"text","marks":[{"type":"strong"}]},{"text":": Select the version of the BSNEE instance that BrightAuthor will be configured connect to. This value defaults to the latest BSNEE version.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that the ","type":"text"},{"text":"Basic Configuration ","type":"text","marks":[{"type":"strong"}]},{"text":"field is only enabled if a supported BrightAuthor installer file has been supplied.","type":"text"},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#3d3d3d"}}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Once you've completed Basic Configuration, click ","type":"text"},{"text":"Next","type":"text","marks":[{"type":"strong"}]},{"text":" to proceed to the ","type":"text"},{"text":"Connectivity Validation","type":"text","marks":[{"type":"strong"}]},{"text":" step.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Advanced Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"If you used custom domain names for BSNEE services during the BSNEE installation process, or if the “CN” attribute of the certificate installed for the BSNEE Web Services node differs from the BSNEE Web Services domain name (FQDN), you will need to perform the ","type":"text"},{"text":"Advanced Configuration ","type":"text","marks":[{"type":"em"}]},{"text":"steps:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Locate and select the ","type":"text"},{"text":"BrightAuthor Installer File","type":"text","marks":[{"type":"strong"}]},{"text":" you wish to configure. Alternatively, you can locate the BrightAuthor installer in Windows Explorer and drag it into the configurator window.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check the ","type":"text"},{"text":"Use Advanced Configuration ","type":"text","marks":[{"type":"strong"}]},{"text":"box.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the ","type":"text"},{"text":"Windows Server","type":"text","marks":[{"type":"strong"}]},{"text":" version that the BSNEE instance is running (either 2008 / 2008 R2 or 2012 / 2012 R2).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Specify the ","type":"text"},{"text":"Protocol","type":"text","marks":[{"type":"strong"}]},{"text":" used for each node (HTTP or HTTPS).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Specify the ","type":"text"},{"text":"Domain name","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Port ","type":"text","marks":[{"type":"strong"}]},{"text":"of each node. Ensure that the same names and port numbers were used during the BSNEE installation process.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"WS-* Endpoint DNS Identity (CN)","type":"text","marks":[{"type":"strong"}]},{"text":" to a value that matches the “CN” attribute of the certificate. If the certificate has multiple Subject Alternative Names, specify the last name in the list.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you’re using a self-signed certificate for the BSNEE Web Services node (for testing purposes), check ","type":"text"},{"text":"Disable Validation","type":"text","marks":[{"type":"strong"}]},{"text":" to allow BrightAuthor to bypass certificate validation/revocation checks when calling API methods.","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"Note

The Web Services node must use HTTP for BrightAuthor file uploads. As a result, if you are using custom HTTP/HTTPS ports and you specify an HTTPS port for the Web Services node, you must enter an HTTP port as well. This condition does not apply to the Device Handlers and Storage nodes. BrightAuthor will use standard HTTP/HTTPS ports if the Port fields are left blank.

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note","type":"text"}]},{"type":"paragraph","content":[{"text":"The Web Services node must use HTTP for BrightAuthor file uploads. As a result, if you are using custom HTTP/HTTPS ports and you specify an HTTPS port for the Web Services node, you must enter an HTTP port as well. This condition does not apply to the Device Handlers and Storage nodes. BrightAuthor will use standard HTTP/HTTPS ports if the ","type":"text"},{"text":"Port","type":"text","marks":[{"type":"strong"}]},{"text":" fields are left blank.","type":"text"}]}]}],"version":1},"reason":"A note macro in a list item can't be created or edited in the new editor."}}}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If desired, enter the ","type":"text"},{"text":"Default Time Server","type":"text","marks":[{"type":"strong"}]},{"text":" for BrightAuthor. Check the ","type":"text"},{"text":"Use BSN Cloud","type":"text","marks":[{"type":"strong"}]},{"text":" box if you wish to use the default BrightSign Network time server.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Next","type":"text","marks":[{"type":"strong"}]},{"text":" to proceed to the ","type":"text"},{"text":"Connectivity Validation","type":"text","marks":[{"type":"strong"}]},{"text":" step.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Connectivity Validation","type":"text"}]},{"type":"paragraph","content":[{"text":"This optional step allows you to test that all information was entered into the BrightAuthor Configurator correctly. It also allows you to determine whether BrightAuthor will be able to connect to the BSNEE instance in your particular network environment.","type":"text"}]},{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Setup Proxy...","type":"text","marks":[{"type":"strong"}]},{"text":" if the Configurator will be connecting to the BSNEE instance through a proxy server.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check the ","type":"text"},{"text":"Use Proxy","type":"text","marks":[{"type":"strong"}]},{"text":" box to configure the proxy settings.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the IP address of the proxy server into the ","type":"text"},{"text":"Host","type":"text","marks":[{"type":"strong"}]},{"text":" field.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter the port number of the proxy server into the ","type":"text"},{"text":"Port","type":"text","marks":[{"type":"strong"}]},{"text":" field.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check the ","type":"text"},{"text":"Requires Authentication","type":"text","marks":[{"type":"strong"}]},{"text":" box if the proxy server requires you to enter credentials. Enter your ","type":"text"},{"text":"Username","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Password","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"OK","type":"text","marks":[{"type":"strong"}]},{"text":" when finished configuring the proxy connection.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Validate Connectivity","type":"text","marks":[{"type":"strong"}]},{"text":". The configurator will attempt to communicate with all relevant BSNEE endpoints and report whether each attempt was a success or failure using standard HTTP status codes.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Dump Log ","type":"text","marks":[{"type":"strong"}]},{"text":"to retrieve a log of error messages.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Output Package","type":"text"}]},{"type":"paragraph","content":[{"text":"Select the ","type":"text"},{"text":"Output Package","type":"text","marks":[{"type":"strong"}]},{"text":" of the BrightAuthor installer package:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CAB SFX executable","type":"text","marks":[{"type":"strong"}]},{"text":": This package is built using Windows IExpress technology. It supports the “unattended” installation mode for enterprise network deployment.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"7-Zip SFX executable","type":"text","marks":[{"type":"strong"}]},{"text":": This package is smaller than the CAB SFX executable. It should be used if Windows IExpress is unavailable or cannot be supported.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":".ZIP with MSI package","type":"text","marks":[{"type":"strong"}]},{"text":": This package contains an archive with an ","type":"text"},{"text":".msi ","type":"text","marks":[{"type":"em"}]},{"text":"and related files.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating the Installer","type":"text"}]},{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"Save ","type":"text","marks":[{"type":"strong"}]},{"text":"button and select a destination folder. The configured BrightAuthor installer will be created in the selected folder. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Before distributing the custom installer to end users, check the generated executable by using it to install BrightAuthor on your PC. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configurator Error Messages","type":"text"}]},{"type":"paragraph","content":[{"text":"The BrightAuthor Configurator may return the following messages during the setup process:","type":"text"}]},{"type":"paragraph","content":[{"text":"No valid BrightAuthor Installer found or version is unsupported. ","type":"text","marks":[{"type":"strong"}]},{"text":"– ","type":"text"},{"text":"The Installer package specified in the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":"BrightAuthor Installer Path","type":"text"},{"text":" field is not supported.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"paragraph","content":[{"text":"Base Domain Name cannot be empty. ","type":"text","marks":[{"type":"strong"}]},{"text":"– The ","type":"text"},{"text":"Base Domain Name","type":"text","marks":[{"type":"strong"}]},{"text":" field is empty and the ","type":"text"},{"text":"Save","type":"text","marks":[{"type":"strong"}]},{"text":" button is clicked.","type":"text"}]},{"type":"paragraph","content":[{"text":"Application Services domain name cannot be empty. ","type":"text","marks":[{"type":"strong"}]},{"text":"– The Application Services ","type":"text"},{"text":"Domain Name","type":"text","marks":[{"type":"strong"}]},{"text":" field is empty and the ","type":"text"},{"text":"Save","type":"text","marks":[{"type":"strong"}]},{"text":" button is clicked.","type":"text"}]},{"type":"paragraph","content":[{"text":"Device Handlers domain name cannot be empty.","type":"text","marks":[{"type":"strong"}]},{"text":" – The Device Handlers ","type":"text"},{"text":"Domain Name","type":"text","marks":[{"type":"strong"}]},{"text":" field is empty and the ","type":"text"},{"text":"Save","type":"text","marks":[{"type":"strong"}]},{"text":" button is clicked.","type":"text"}]},{"type":"paragraph","content":[{"text":"Storage domain name cannot be empty. ","type":"text","marks":[{"type":"strong"}]},{"text":"– The Storage ","type":"text"},{"text":"Domain Name","type":"text","marks":[{"type":"strong"}]},{"text":" field is empty and the ","type":"text"},{"text":"Save","type":"text","marks":[{"type":"strong"}]},{"text":" button is clicked.","type":"text"}]},{"type":"paragraph","content":[{"text":"Error: Unsupported BrightAuthor Installer. ","type":"text","marks":[{"type":"strong"}]},{"text":"– An error occurs during the BrightAuthor extraction process.","type":"text"}]},{"type":"paragraph","content":[{"text":"An unknown error occurred while creating 7-Zip package. ","type":"text","marks":[{"type":"strong"}]},{"text":"– An error occurs during creation of 7-Zip package (before it is an SFX executable).","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Distributing BrightAuthor Installers via the WebUI","type":"text"}]},{"type":"paragraph","content":[{"text":"You can easily distribute your new custom BrightAuthor installer to end users through the BSNEE WebUI. After completing the steps below, there will be an additional section labeled “Download BrightAuthor Link” on the settings page of the WebUI of your BrightSign Network.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy the custom BrightAuthor installer to your BrightSign Network Enterprise Edition persistent storage. The following is a common file path (yours may be different):","type":"text"},{"type":"hardBreak"},{"text":"C:\\BSNEE\\Storage\\Persistent\\ba\\BrightAuthor.3.x.x.x.setup.exe.","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"You have now created a download link to the custom installer. For example, if the URL of your storage server is ","type":"text"},{"text":"http://storage.mydomain.com/","type":"text","marks":[{"type":"underline"}]},{"text":", then the download link will be ","type":"text"},{"text":"http://storage.mydomain.com/ba/BrightAuthor.3.x.x.x. setup.exe","type":"text","marks":[{"type":"underline"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Navigate to your website location and open the ","type":"text"},{"text":"settings.aspx","type":"text","marks":[{"type":"em"}]},{"text":" file with a text or script editor (Notepad, TextEdit, or a similar program). The following is a common location (yours may be different):","type":"text"},{"type":"hardBreak"},{"text":"C:\\inetpub\\wwwroot\\BSNEEWebSite","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Search for the tag (located on or around line 218). Add the following HTML markup below the tag:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"

\n\t

\n\t\t

Resources

\n\t\t

\n\t\t\t\tDownload BrightAutor\n\t\t\t

\n\t

","type":"text"}]},{"type":"paragraph","content":[{"text":"The above code uses an example file path to the BrightAuthor installation in the storage. This link will be different in your case. To determine the correct link, refer to Step 1.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check the download link on the BrightSign Network WebUI to make sure it works. End users will now be able to download the custom installer from the WebUI.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Command-Line Switches for BrightAuthor Packages","type":"text"}]},{"type":"paragraph","content":[{"text":"Configured executable BrightAuthor packages have command-line switches that can assist in deploying packages over an enterprise network or performing “unattended” setup (i.e. BrightAuthor is installed with default settings automatically without prompting the user).","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CAB SFX executable","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Q","type":"text","marks":[{"type":"code"}]},{"text":" – Unattended install","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Q:A","type":"text","marks":[{"type":"code"}]},{"text":" – Administrative install (extract only)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/?","type":"text","marks":[{"type":"code"}]},{"text":" – Help","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"7-Zip SFX executable","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Q","type":"text","marks":[{"type":"code"}]},{"text":" – Unattended install","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/A","type":"text","marks":[{"type":"code"}]},{"text":" – Administrative install (extract only)","type":"text"}]}]}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported