BOC Product Installation & Update Process (on premise) December 19, 2024 10:40 Updated BOC Group offers a paid service through our technical support team, to install your BOC Management Office product in your infrastructure. This service is offered to on-premise customers only and includes both initial product installations and also updates to the latest product version. Note: If your product is hosted by BOC, this will be processed by our cloud team. Please contact your customer account manager for further information in this case. Procedure overview 5-Steps to a complete installation or update Place Order: Your customer account manager will create a BOC technical support ticket on your behalf and you will receive a welcome message, as well as an invitation to a Kick-off Meeting. Kick-off Meeting: The meeting aims to understand your scenario, estimate the time needed for your installation project, and ensure a smooth process. No changes will be made to your environment now. We'll schedule the installation date based on your details. We allocate adequate time and resources to each project, but note that during high demand, we may be fully booked weeks in advance. Preparation and Sanity Checks: Considering your specific needs, we will prepare everything needed to execute your installation order. In case of an update, we will perform sanity checks on secured machines with a database backup provided by you. Within 1–2 weeks, you will be informed about the results and, if positive, the installation date will be confirmed. Execution: In a remote meeting, BOC technical support will install together with your technical staff the latest compatible product version. Project approval: You now have 10 days to report issues that are due to the update and will be corrected in the course of the update ticket. Kick-off Meeting Please make sure, that all stakeholders on your side will be available for the kick-off slot. This includes, but is not limited to, the following responsible: Database Administrator BOC Product Admin (for full tool access) Responsible for web server and for application server The following points will be discussed, based on the attached example kickoff report. Kickoff Meeting: Technical details checklist Installation Options: ADOxx Installation Options Status of Database Server Type of Database System (MSSQL, PostgreSQL, Oracle) DB Installation option Status of application server CPU and RAM See recommended requirements for ADONIS / ADOIT / ADOGRC Status of web server CPU and RAM See recommended requirements for ADONIS / ADOIT / ADOGRC Status of 3rd-party software Versions and status See recommended requirements for ADONIS / ADOIT / ADOGRC Please note: Apache Tomcat and Java are a precondition for the installation of a BOC product. These 3rd-party tools can neither be provided nor installed by BOC technical support. Of course, the configuration and migration of config files will be supported. For details, see: How do I migrate the Tomcat-side configuration of a BOC product? Kickoff Meeting: Organizational details Installation Date is set Notepad++ available (portable) on application server Authentication Mechanism: Starting with ADONIS 16, ADOIT 17 and ADOGRC 13, imported System users cannot be used anymore. See for details Deprecation of Import System Users Functionality Providing SIP and Database backup (Update only) for documentation and sanity check Exchanging contact details for aFFE (authenticated Fast File Exchange) Update only: After the sanity check was successfully executed through BOC technical support, you will be informed and the update can proceed with the aligned date Installation & Update Execution The provided installation files, the status of your 3rd party software and the presence of a backup will be checked. Update only: The running services of your old version will be taken offline. Please inform your users in advance. The installation package is installed at a location of your choice. If necessary, scripts are executed on your database. Update only: Environment-specific settings of your BOC product & 3rd party software are merged to the new version. A login in the new environment is performed, and a test model is created to verify the functionality. If there are any installation related issues, you can report them within 10 days in the same ticket. General Q&A How do I start an update process? Your application owner needs to place your order with your BOC customer account manager. ~ I also need an SSO (Single Sign-on) or LDAP solution, will this be done during the installation or update? If you require an implementation or customization of an authentication mechanism, this will be solved in a separate ticket by our specialists. ~ My environment was customized, does this have an impact for an update? Yes, in some cases the customized library needs to be adapted first by our solution engineers to work with the latest product version. This could take some time, depending on the order queue. Your customer account manager will inform you about the details. ~ I am using ADONIS and ADOIT with a Management Office Integration Module to exchange data between them. Should both be updated? We recommend updating both products, to ensure a smooth synchronization process. ~ Can I update my test and production environment in the same ticket?Usually no, as the updated test environment needs to be tested by you. A subsequent ticket will be placed by your customer account manager. ~ What happens, if a new version was released, after the process has been started?You will be provided with the latest available files, if covered by an active maintenance contract. If you have a customized environment, the options will be evaluated with our corresponding solutions engineer. ~ What meeting tools does BOC technical support offer?Usually, MS Teams as meeting platforms. If you prefer a different platform, please send an invitation to the installation agents. ~ How do I know if a new version was released? There are two ways for customers to be informed about new releases of ADONIS, ADOIT, or ADOGRC. You may either receive a notification directly from your account manager, if such an arrangement has been agreed upon, or via our "What's New" Newsletter for major releases.For details to each version, visit: What's New | ADONIS - What's New | ADOIT - What's New | ADOGRC ~ What are the costs for an update?Costs are calculated on the base of an array of factors, thus your customer account manager can support you with details. ~ I would like to add additional functionality or change the configuration of my BOC product, can this be done during the update?The process via BOC technical support strictly covers the update or installation of your product. Any changes and adaptions needs to be discussed with your customer account manager beforehand and will be executed at a later point.~ How long will the installation or update appointment itself take?Unfortunately, it is not possible to provide an exact answer, as the duration of the appointment can be influenced by various factors. Generally, it takes between 1 and 4 hours Download Kick-off Template: Example Kick-off Report.pdf 200 KB Download Related articles Deprecation of Import System Users Functionality How to download a Support Information Package (SIP)? How to generate a HAR file? How do I set up my MS Entra ID (Azure) for a BOC product? Enabling REST when using SSO with IDM