Update your Oslo sample
As new features are added to Acoustic Content, sometimes you need to update the Oslo sample to the latest version to enable the new features. If you choose to enable the features, you must download the site content from GitHub and install it manually. To find out whether you need to update the sample, check the version of the Oslo sample site that is installed and compare it to the recent version available.
Prerequisites
To get started, you need:
- Your Acoustic Content trial or standard edition. To get a free trial version or to upgrade to standard, go to Acoustic Content.
- Install a Node environment with a recent stable version greater than Node >= 8.
Check the Oslo sample version in your content hub
Compare the build date of the installed sample and the latest available sample to determine whether you need to update your sample site.
Download the latest Oslo sample version
If you choose to update, download the Oslo site content GitHub.
Getting setup
To install the downloaded Oslo site content, you must have at least version 2 of wchtools installed.
- Download and install the latest release of wchtools that is available in Github.
- After you install the wchtool on your machine, you can test and verify that you have the correct version of the wchtools by running the following command
wchtools -V
.
Delete previous content associated with Oslo
Based on when you are updating the Oslo site and what your preferences are, your installation method will vary.
- To begin the installation process, open a command line and change to the directory where you downloaded the wch-site-content.
- Initialize the wchtools for your tenant with the following command
wchtools init
.
Then, based on when your subscription was created delete existing content with the following steps:
If your subscription was created after the May 2018 updates were available, you have the following options:
- Option 1: Remove all sample images, renditions, content, and pages that are associated with Oslo, but keep the Oslo layouts, content types, and categories.
Run the following commandwchtools delete -A -v --server-manifest oslo-sample-artifacts
.
Note:
All artifacts that you created will not be deleted.
- Option 2 : Delete all the artifacts that are associated with Oslo but keep the artifacts that you created.
Run the following commandwchtools delete -A -v --server-manifest oslo-complete -v
If you are updating the sample site Oslo for a subscription that was created before the month of May 2018, then complete the following steps:
-
You can take a backup of all the changes or customization you made to the site with the following command
wchtools pull -A
. -
You must delete all the previous artifacts that are installed in your tenant.
Note:
All artifacts will be deleted. Run the following command to delete all the artifacts
wchtools delete -A --all -v
.
Extract and install the Oslo files
Extract the files from the sample-oslo.zip
file and run the following wchtools push command from the wch-site-content directory to install the Oslo site content to your tenant.
- Option 1 - For the skeleton Oslo sample, use this push command:
wchtools push -v -A -f --manifest oslo-minimum
.
The skeleton sample contains minimum reusable artifacts that can be used to create your own SPA site. This manifest contains only source code, layouts, layout-mappings, content types, image-profiles, categories, generic components (header and footer), and the generic page (404 error page). - Option 2 - For the complete Oslo sample, use this push command:
wchtools push -v -A -f --manifest oslo-complete
.
This contains all Oslo code (web assets) and sample site content.
If there are errors, rerun the command again a few times. See the readme file that comes with wchtools for more details on using the push command. After successful completion, a message indicates that the push is complete, provides the number of artifacts that are involved, and the log file that can be consulted for more details. In case you are encountering issues, you might need to rerun the command multiple times.
Expected outcome
You can now log in to the subscription and see the recent populated content artifacts and your site. To customize the sample site, you must download the site source files. For more information about customizing Oslo, see Develop your website.
Updated over 1 year ago