Summary


This article describes the options available for managing the InfoBurst database repository and repository management best practices.



Backups


We recommend a nightly repository backup of the database or schema hosting the InfoBurst repository.



Create a New Repository


  • Open a command prompt (Run as administrator)
  • Change directory to the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Enter CreateRepo
  • Enter number corresponding to your database type
  • DB User: Enter database username
    • Leave username and password blank to use Windows Authentication to SQL Server. The Windows account assigned to run the InfoBurst Platform service will be used.
  • DB Password: Enter database password
  • Database Server: Enter Database Connection String
  • Catalog: Enter database name (SQL Server only)
  • Enter YES to create repository
  • Restart the InfoBurstPlatform service



Connect to an Existing Repository


  • Open a command prompt (Run as administrator)
  • Change directory to the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Enter SwitchRepo
    • Enter SwitchRepo -switch if the current repository is not available
  • Enter (Connect to another repo)
  • Enter number corresponding to your database type
  • DB User: Enter database username
    • Leave username and password blank to use Windows Authentication to SQL Server. The Windows account assigned to run the InfoBurst Platform service will be used.
  • DB Password: Enter database password
  • Database Server: Enter Database Connection String
  • Catalog: Enter database name (SQL Server only)
  • Enter YES to switch repository
  • Restart the InfoBurstPlatform service



Copying and Restoring a Repository


Use the following process to copy and restore a repository from one InfoBurst environment to another. The most common use of this process is the copying of the production repository for use in an InfoBurst test environment. The testing process can vary based on how InfoBurst is utilized and testing requirements. InfoSol offers services to help plan and guide testing. Please contact InfoSol for details.


Recommendations

  • The steps described below are generic and can vary based on environment and need. We recommend consulting InfoSol to develop a plan specific to your requirements.
  • Disable Schedule and Event Processing and Simulate Deliveries (see below) to prevent delivery of duplicate content from the target environment. These settings can be reverted once steps are taken to disable duplicate schedules and reconfigure or disable duplicate deliveries
  • Obtain a license for the target server and store in the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Ensure server dependencies match the source server (see Move an Application Server > Recommendations)

Repository Copy & Restoration

Source Server (Server #1)

  • Stop the InfoBurstPlatform service
  • Make a backup copy of the database repository
  • Restore the repository copy for use by Server #2
  • Start the InfoBurstPlatform service


Target Server (Server #2)


Restore the Repository Copy

  • Stop the InfoBurstPlatform service
  • Open a command prompt (Run as administrator)
  • Change directory to the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Enter SwitchRepo
  • Enter (Connect to another repo)
  • Enter number corresponding to the database type of the repository copy
    • DB User: Enter database username
      • Leave username and password blank to use Windows Authentication to SQL Server. The Windows account assigned to run the InfoBurst Platform service will be used.
    • DB Password: Enter database password
    • Database Server: Enter Database Connection String
    • Catalog: Enter database name (SQL Server only)
  • Enter YES to switch repository



Reset Schedules


Jobs may not start correctly if the repository copy was made when jobs were running in the source environment. Run IBResetSchedule to remove orphaned jobs.


  • Open a command prompt (Run as administrator)
  • Change directory to the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Enter IBResetSchedule
  • Enter Yes


Update ServerName and UIURL


  • Open a command prompt (Run as administrator)
  • Change directory to the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Enter IBConfig ServerName <ServerName - Server #2>
  • Enter IBConfig UIURL <UIURL - Server #2>
  • Example: IBConfig UIURL (e.g. http://<SERVER>:8554)


Disable Schedule/Event Processing & SimulateAllDeliveries


Disable Schedule/Event Processing and SimulateAllDeliveries are optional and only used when the copied repository is restored to a test InfoBurst environment where you do not want productions schedules to run or production content to be delivered.


  • Open a command prompt (Run as administrator)
  • Change directory to the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Enter IBConfig SystemScheduleProcessing False
  • Enter IBConfig SystemEventProcessing False
  • Enter IBConfig SimulateAllDeliveries True
  • Enter IBConfig to confirm settings changes
  • Start the InfoBurstPlatform service


Update Server License

  • Ensure the InfoBurstPlatform service is running
  • Open the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Double-click license.exe to launch the license manager
  • Select and delete the Server #1 license
  • Install the Server #2 license key
  • Restart the InfoBurstPlatform service

SSL


If the source server had SSL enabled, then the repository copy will contain that server's SSL certificate information. The SSL certificate information must be updated. Follow the the instructions in the Change SSL section of the following article:


https://help.infosol.com/en/support/solutions/articles/19000019266-ssl


XDC Users
  • Re-run XDCs on Server #2 to rebuild caches


Moving a Repository

Use the following process to point an InfoBurst Platform server to a relocated repository. This process pertains only to the relocation of a repository. See Move an Application Server for details on relocating the InfoBurst Platform application server.
  • Open a command prompt (Run as administrator)
  • Change directory to the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Enter SwitchRepo
  • Enter (Connect to another repository)
  • Enter number corresponding to your database type
  • DB User: Enter database username
    • Leave username and password blank to use Windows Authentication to SQL Server. The Windows account assigned to run the InfoBurst Platform service will be used.
  • DB Password: Enter database password
  • Database Server: Enter Database Connection String
  • Catalog: Enter database name (SQL Server only)
  • Enter YES to switch repository
  • Restart the InfoBurstPlatform service



Change Password for Existing Repository

Use the SwitchRepo utility to change the password for the current repository connection

  • Stop the InfoBurst service
  • Open a command prompt (Run as administrator)
  • Change directory to the application root folder (default = C:\Program Files (x86)\InfoSol\InfoBurstPlatform)
  • Enter SwitchRepo -pwd
  • Enter new password
  • Start the InfoBurst service


Builds 231 and earlier


There is no option to update credentials for an existing repository connection. A new connection must be created with the updated credentials. Use the Connect to an Existing Repository process described above to establish a new connection.


Editing the InfoBurst Platform Repository

Editing the structure or contents of the InfoBurst Platform repository is prohibited and may void your maintenance agreement. Please consult InfoSol Help Desk with questions.



See Also


System Backup & Restoration