Issue
Once Admin Console is installed, the clients have to "know" how to register with the Admin Console in order to receive a license.
Admin Console Server prerequisites and assumptions
AdminConsole must have the users pre-populated prior to the clients attempting to contact the server to register for a license. AdminConsole can populate users in different ways:
- Single-Sign On
- Active Directory, LDAP, or SAML credentials are provided and Admin Console imports the users
- Add Users manually or via CSV file
- Must set a password manually for each user.
- Windows Authentication
- Supports automatic login of server users in the AD domain
Note: the discussion and instructions for Admin Console are beyond the scope of this article
License
In all methods, a legacy fpmkey.txt is not used. In its place, there is an fpcsdk.config. It is created in the installation folder to tell the software where to look for licensing. It is automatically generated.
For informational purposes only, the contents resemble this:
{"env":"https://pheecws.deltaconsulting.tech","upd":"https://pheecws.deltaconsulting.tech","logfile":"off","appType":"Phantom"}
Method
- Configuration with Foxit XML Editor
- Download the Foxit XML Editor from here (be sure to download the latest one matching your software version): Foxit_XML_Editor
- Run XML Editor.exe to open the XML Editor window. Click the INTERFACE button at the bottom of the window, and choose a product. Confirm.
- If a ProfStore.xml exists in the C:\Program Files (x86)\Foxit Software\Foxit PhantomPDF\ProfStore folder, copy it to a place to edit such as Desktop or Documents. Note: the ProfStore folder may not exist. For this method, it will need to be created when the ProfStore.xml is distributed.
- Click the IMPORT button at the bottom of the windows and navigate to the ProfStore.xml -- if the ProfStore.xml does not exist, skip this step.
- Version of PhantomPDF ... either verify the correct version, if importing or enter the correct version, up to 3 digits.
- Select Default ConnectedPDF Server Note: this is correct even if "ConnectedPDF" is Disabled.
- Input the server URL in this format: https://pheecws.company.extension
- Repeat for Internal Update Server setting. Use the same URL, BOTH must be set.
- Click the EXPORT button at the bottom of the windows.
- Overwrite the ProfStore.xml being edited, or create a file named ProfStore.xml
- Copy the ProfStore.xml to the C:\Program Files (x86)\Foxit Software\Foxit PhantomPDF\ProfStore folder. Create the ProfStore folder, if necessary. Note: if ProfStore.xml already exists, you may not be able to directly overwrite the one in C:\Program Files (x86)\Foxit Software\Foxit PhantomPDF\ProfStore. This is a Windows permission issue, just save it somewhere else and copy to the ProfStore folder manually.
- Distribute the new ProfStore.xml to those clients needing to register with AdminConsole.
- GPO Template
- Download the latest GPOs available from here: GPO_Template
- Start --> Run. Type GPEDIT.MSC to open the Local Group Policy Editor
- Right-click Administrative Templates in Computer Configuration and choose Add/Remove Template
- Click Add and navigate to Foxit PhantomPDF.adm
- Foxit PhantomPDF 10.0 is now available in Classic Administrative Templates (ADM).
- Copy the .admx file to C:\Windows\Policy Definitions folder and the .adml file to the corresponding language subfolder.
- In either GPEDIT.MSC or Administrative Tools --> Group Policy Management, open the AdminConsole folder in the Foxit PhantomPDF 10.0 template, and double-click AdminConsole Server.
- Select Enabled and input the corresponding server URL in the Server box. Click Apply, and then click OK.
- Input the server URL in this format: https://pheecws.company.extension
- Open the Admin Console folder in the Foxit PhantomPDF 10.0 template, and double-click Update Server.
- Select Enabled and input the corresponding server URL in the Server box. Click Apply, and then click OK.
- Foxit Customization Wizard (only for MSI installers)
- Download the Foxit Customization Wizard from here (be sure to download the latest one matching your software version): Foxit_Customization_Wizard
- Run Foxit Customization Wizard, and click the Open button at the top to select the MSI installer to be configured.
- Select Installation Options
- Input the server addresses for Foxit Admin Console and Foxit Update Server in the Server address for Admin Console box and the Server Address for Update Server box.
- Click the Save button at the top of the Foxit Customization Wizard. In the pop-up Save As dialog box, choose the folder where the PhantomPDF installer is stored and click Save
- The MST and fct.cab files are generated. Both files must stay together.
- Syntax: msiexec /i "full path to .msi" TRANSFORMS="full path to .mst" /qr